HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_LS
The node type is normally determined during activation; it is null if the LS is inactive. However, for an LS
to a back-level LEN node (specified by the
adj_cp_type parameter on DEFINE_LS), the node type is taken
from the LS definition and is not determined during activation.
ls_summary.port_name
Name of the 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 characters.
ls_summary.adj_cp_name
Fully qualified name of the adjacent control point; this parameter is null for an implicit link. The name is
a 17-byte EBCDIC string, padded on the right with EBCDIC spaces. It consists of a network ID of 1
–8
A-string characters, an EBCDIC dot (period) character, and a network name of 1–8 A-string characters.
ls_summary.adj_cp_type
Type of the adjacent node, determined during link activation. This is one of the following:
AP_APPN_NODE
Node type is unknown, or LS is inactive.
AP_END_NODE
End node, Branch Network Node acting as an End Node from the local node’s perspective, or up-level
LEN node (one that includes the Network Name CV in its XID3).
AP_NETWORK_NODE
Network node, or Branch Network Node acting as a Network Node from the local node’s perspective.
AP_BACK_LEVEL_LEN_NODE
Back-level LEN node (one that does not include the Network Name CV in its XID3).
AP_HOST_XID3
Host node; SNAplus2 should respond to a polling XID from the node with a format 3 XID.
AP_HOST_XID0
Host node; SNAplus2 should respond to a polling XID from the node with a format 0 XID.
AP_DSPU_XID
Downstream PU; SNAplus2 should include XID exchange in link activation. The dspu_name and
dspu_services fields must also be set.
AP_DSPU_NOXID
Downstream PU; SNAplus2 should not include XID exchange in link activation. The dspu_name and
dspu_services fields must also be set.
AP_VRN
Virtual routing node.
ls_detail.overlay_size
The size of the returned
ls_detail structure, and therefore the offset to the start of the next entry in the data
buffer.
When your application needs to go through the returned buffer to find each
ls_detail structure in turn, it must
use this value to move to the correct offset for the next data structure, and must not use the C
sizeof()
operator. This is because the size of the returned overlay may increase in future releases of SNAplus2; using
the returned overlay size ensures that your application will continue to work with future releases.
ls_detail.ls_name
Link station name. This is an 8-byte ASCII string, padded on the right with spaces if the name is shorter
than 8 characters.
496