HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_LS
IP address. Specify this value for an Enterprise Extender (HPR/IP) link.
AP_UNSPECIFIED
Unspecified address format. Specify this value for any link type other than Enterprise Extender (HPR/
IP).
def_data.dest_address.length
Length of the destination address field, as specified in the following parameter or parameters.
For Enterprise Extender (HPR/IP), this parameter and dest_address.address are reserved. Instead, you specify
the address using the remote_hostname parameter in the link-specific data.
For SDLC:
def_data.dest_address.address
Address of the secondary station on this LS.
• If the port that owns this LS is used only for incoming calls (out_link_act_lim on DEFINE_PORT is zero),
this parameter is reserved.
• If the port that owns this LS is switched primary and is used for outgoing calls (port_type is
AP_SWITCHED, ls_role is AP_LS_PRI, and out_link_act_lim on DEFINE_PORT is nonzero), either
set this parameter to 0xFF to accept whatever address is configured at the secondary station, or set it to
a 1-byte value in the range 0x01–0xFE which must match the value configured at the secondary station.
• Otherwise, set it to a 1-byte value in the range 0x01–0xFE to identify the link station. If the port is
primary multi-drop (ls_role on DEFINE_PORT is AP_LS_PRI and tot_link_act_lim is greater than 1),
this address must be different for each LS on the port.
For QLLC:
def_data.dest_address.address
Address of the destination node for this LS. This parameter is used only for SVC outgoing calls (defined by
the vc_type parameter in the link-specific data, and by the link activation limit parameters on DEFINE_PORT);
it is ignored for incoming calls or for PVC.
The address is a string of 1–14 characters. The address is in X.25 (1980) format; later address formats are
not supported.
For Token Ring, Ethernet, FDDI:
def_data.dest_address.mac_address
MAC address of adjacent node.
If you need to define a non-selective listening LS (one that can be used only for incoming calls, but can have
LUs defined on it to support dependent LU traffic), set this parameter to a null string. The LS can then be
used to receive incoming calls from any remote link station, but cannot be used for outgoing calls. There
is no need to define a non-selective listening LS if only independent LU traffic is used, because an LS for
independent LU traffic can be set up dynamically when required.
If the local and adjacent nodes are on LANs of different types (one Token Ring or FDDI, the other Ethernet)
connected by a bridge, you will probably need to reverse the bit order of the bytes in the MAC address. For
more information, see Section 3.29.7, Bit Ordering in MAC Addresses. If the two nodes are on the same
LAN, or on LANs of the same type connected by a bridge, no change is required.
def_data.dest_address.lsap_address
Local SAP address of adjacent node. This must be a multiple of 0x04.
For all link types:
def_data.auto_act_supp
Specifies whether the link can be activated automatically when required by a session. Possible values are:
174