HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_LS
The LS is automatically started when the node is started.
AP_NO
The LS is not automatically started; it must be started manually.
If the LS is a leased SDLC link or a QLLC PVC link, you are recommended to set this parameter to AP_YES
to ensure that the link is always available.
def_data.react_timer
Reactivation timer for reactivating a failed LS. If the react_timer_retry parameter below is nonzero, to specify
that SNAplus2 should retry activating the LS if it fails, this parameter specifies the time in seconds between
retries. When the LS fails, or when an attempt to reactivate it fails, SNAplus2 waits for the speci
fied time
before retrying the activation. If react_timer_retry is zero, this parameter is ignored.
def_data.react_timer_retry
Retry count for reactivating a failed LS. This parameter is used to specify whether SNAplus2 should attempt
to reactivate the LS if it fails while in use (or if an attempt to start the LS fails).
Specify zero to indicate that SNAplus2 should not attempt to reactivate the LS, or specify the number of
retries to be made. A value of 65,535 indicates that SNAplus2 should retry indefinitely until the LS is
activated.
SNAplus2 waits for the time specified by the react_timer parameter above between successive retries. If the
retry count is reached without successfully reactivating the LS, or if a STOP_LS is issued while SNAplus2 is
retrying the activation, no further retries are made; the LS remains inactive unless START_LS is issued for it.
If the auto_act_supp parameter is set to AP_YES, the reactivation timer fields are ignored; if the link fails,
SNAplus2 does not attempt to reactivate it until the user application that was using the session attempts to
restart the session.
If the LS is a leased SDLC link or a QLLC PVC link, you are recommended to set this parameter to a
non-zero value to ensure that the link is always available.
def_data.restart_on_normal_deact
Specifies whether SNAplus2 should attempt to reactivate the LS if it is deactivated normally by the remote
system. Possible values are:
AP_YES
If the remote system deactivates the LS normally, SNAplus2 attempts to reactivate it, using the same
retry timer and count values as for reactivating a failed LS (the react_timer and react_timer_retry
parameters above).
AP_NO
If the remote system deactivates the LS normally, SNAplus2 does not attempt to reactivate it.
If the LS is a host link (specified by the def_data.adj_cp_type parameter), or is automatically started when the
node is started (the initially_active parameter is set to AP_YES), this parameter is ignored; SNAplus2 always
attempts to reactivate the LS if it is deactivated normally by the remote system (unless react_timer_retry is
zero).
def_data.port_name
Name of port associated with this link station. This is an 8-byte ASCII string, padded on the right with spaces
if the name is shorter than 8 bytes, which must match the name of a defined port.
def_data.adj_cp_name
Fully qualified name of the adjacent CP for this LS.
If the adj_cp_type parameter below is set to AP_NETWORK_NODE or AP_END_NODE, and preassigned TG
numbers are being used, set this parameter to the CP name defined at the adjacent node; if the adjacent node
sends a CP name during XID exchange, it will be checked against this value.
172