HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_RCF_ACCESS
A reserved parameter was set to a nonzero value.
AP_INVALID_LINK_SPEC_FORMAT
A reserved parameter was set to a nonzero value.
AP_INVALID_IMPLICIT_UPLINK
The
implicit_uplink_to_en parameter was not set to a valid value.
Appendix B, Common Return Codes lists further secondary return codes associated with
AP_PARAMETER_CHECK
,
which are common to all NOF verbs.
3.39.5 Returned Parameters: State Check
If the verb does not execute because of a state error, SNAplus2 returns the following parameters.
primary_rc
AP_STATE_CHECK
secondary_rc
Possible values are:
AP_PORT_ACTIVE
The specified port cannot be modified because it is currently active.
AP_DUPLICATE_PORT_NUMBER
A port with the specified port_number has already been defined.
Appendix B, Common Return Codes lists further secondary return codes associated with
AP_STATE_CHECK, which
are common to all NOF verbs.
3.39.6 Returned Parameters: Other Conditions
Appendix B, Common Return Codes lists further combinations of primary and secondary return codes that are
common to all NOF verbs.
3.39.7 Incoming Calls
If you are configuring a port that will accept incoming calls (as defined by the tot_link_act_lim, inb_link_act_lim,
and out_link_act_lim parameters), there is generally no need to define an LS to be used for these calls, because
SNAplus2 will define one dynamically when the incoming call is received. However, if the incoming calls are from
a host computer that supports dependent LUs or from a downstream computer using PU concentration, you need to
define an LS explicitly, because the LS definition includes the name of the PU associated with the dependent LUs
or the name of the downstream PU.
When an incoming call arrives at the port, SNAplus2 checks the address specified on the call against the addresses
specified for LSs defined on the port (if any), to determine if an LS has already been defined for the call. If the
address does not match, an LS is defined dynamically. To ensure that the explicit LS definition (including the
required PU name) is used, ensure that the address defined for this LS matches the address that will be supplied by
the host or the downstream computer on the incoming call. For Token Ring / Ethernet / FDDI, both the MAC and
SAP addresses must match in order to select the correct LS.
3.40 DEFINE_RCF_ACCESS
DEFINE_RCF_ACCESS specifies access to the SNAplus2 Remote Command Facility (RCF): the user ID used to
run UNIX Command Facility (UCF) commands, and the restrictions on which administration commands can be
246