HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_LS
AP_YES
The link can be activated automatically.
AP_NO
The link cannot be activated automatically.
If this parameter is set to AP_YES:
• The reactivation timer fields are ignored. If the LS fails, SNAplus2 does not attempt to reactivate it until
a dependent LU application that was using the session attempts to restart the session; an LS used by
independent LUs will not be reactivated by SNAplus2, and must be restarted manually.
• If the link is to an APPN node, the LS must have a preassigned TG number defined (see the following
parameter), and
cp_cp_sess_support must be set to AP_NO.
• If either the local node or the adjacent node is an end node, the LS must also be de
fined as auto-activatable
at the adjacent node.
def_data.tg_number
Preassigned TG number. This parameter is used only if the adjacent node is an APPN node (adj_cp_type is
either AP_NETWORK_NODE or AP_END_NODE); it is ignored otherwise.
This TG number is used to represent the link when the link is activated. The node will not accept any other
number from the adjacent node during activation of this link; if the adjacent node is using preassigned TG
numbers, the same TG number must be defined by the adjacent node on the adjacent link station.
If the local node is a LEN node, or if the adjacent node is a LEN node and the link is to be auto-activatable,
set the TG number to 1. Otherwise, specify a number in the range 1–20, or zero to indicate that the TG
number is not preassigned and is negotiated when the link is activated.
If a preassigned TG number is defined, the adj_cp_name parameter must also be defined, and the adj_cp_type
parameter must be set to either AP_END_NODE or AP_NETWORK_NODE.
def_data.limited_resource
Specifies whether this link station is to be deactivated when there are no sessions using the link. Link stations
on a nonswitched port cannot be configured as limited resource. Possible values are:
AP_NO
The link is not a limited resource and will not be deactivated automatically.
AP_NO_SESSIONS
The link is a limited resource and will be deactivated automatically when no active sessions are using
it.
AP_INACTIVITY
The link is a limited resource and will be deactivated automatically when no active sessions are using
it, or when no data has flowed on the link for the time period specified by the link_deact_timer field.
• If no SSCP-PU session is active across the link, the node deactivates the link immediately.
• If an SSCP-PU session is active but no traffic has flowed for the specified time period, the node
sends REQDISCONT(normal) to the host. The host is then responsible for deactivating all LUs and
the PU, at which time the local node will deactivate the link. However, the host may not deactivate
LUs with active PLU-SLU sessions; in this case, the link remains active until all these sessions are
deactivated (for example by the user logging out). This behavior can be changed by using options
in the ptf field of the START_NODE verb.
A limited resource link station may be configured for CP-CP session support, by setting this field to
AP_NO_SESSIONS and cp_cp_sess_support to AP_YES. In this case, if CP-CP sessions are brought up
over the link, SNAplus2 will not treat the link as a limited resource (and so will not deactivate it).
175