HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_LOCAL_TOPOLOGY
When your application needs to go through the returned buffer to find each
local_topology_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.
local_topology_detail.dest
Fully qualified destination node name of the TG. 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.
local_topology_detail.dest_type
Node type of the destination node for this TG. This is one of the following:
AP_NETWORK_NODE
Network node.
AP_VRN
Virtual routing node.
AP_END_NODE
End node or LEN node.
local_topology_detail.tg_num
Number associated with the TG.
local_topology_detail.dlc_data.length
If
dest_type is
AP_VRN, this field specifies the length of the DLC address of the connection to the VRN.
Otherwise, this field is not used and is set to zero.
local_topology_detail.dlc_data.address
If dest_type is
AP_VRN, this field specifies the DLC address (in hexadecimal) of the connection to the VRN.
The number of bytes in the address is given by the preceding field, length; the remaining bytes in the field
are undefined. Otherwise, this field is not used.
For Token Ring, Ethernet, or FDDI, the address is in two parts: a 6-byte MAC address and a 1-byte local
SAP address. The bit ordering of the MAC address may not be in the expected format; for information about
converting between the two address formats, see Section 3.29.7, Bit Ordering in MAC Addresses.
local_topology_detail.rsn
Resource Sequence Number. This is assigned by the network node that owns this resource.
local_topology_detail.status
Specifies the status of the TG. This may be one or more of the following, combined by a logical OR operation.
AP_TG_OPERATIVE
AP_TG_CP_CP_SESSIONS
AP_TG_QUIESCING
AP_TG_HPR
AP_TG_RTP
local_topology_detail.tg_chars
TG characteristics. For more information about these parameters, see Section 3.29, DEFINE_LS.
local_topology_detail.cp_cp_session_active
Specifies whether the owning node’s contention winner CP-CP session is active. Possible values are:
AP_YES
483