HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_NN_TOPOLOGY_NODE
AP_END_NODE
End node.
AP_VRN
Virtual routing node.
nn_topology_node_detail.node_name
Fully qualified name of the node. This 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.
nn_topology_node_detail.node_type
Type of the node. This is one of the following:
AP_NETWORK_NODE
Network node.
AP_END_NODE
End node.
AP_VRN
Virtual routing node.
nn_topology_node_detail.overlay_size
The size of the returned
nn_topology_node_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
nn_topology_node_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.
nn_topology_node_detail.days_left
Number of days before this node entry will be deleted from the Topology Database. For the local node entry,
this value is set to zero, indicating that this entry is never deleted.
nn_topology_node_detail.frsn
Flow Reduction Sequence Number (FRSN). Indicates the last time that this resource was updated at the local
node.
nn_topology_node_detail.rsn
Resource Sequence Number. This is assigned by the network node that owns this resource.
nn_topology_node_detail.rar
The node’s route additional resistance. Values are in the range
0–255.
nn_topology_node_detail.status
Specifies the status of the node. This parameter may be set to
AP_UNCONGESTED, to any one of the other
values listed, or to two or more of the other values combined using a logical OR. Possible values are:
AP_UNCONGESTED
The number of ISR sessions is below the
isr_sessions_upper_threshold value in the node’s configuration.
AP_CONGESTED
The number of ISR sessions exceeds the threshold value.
AP_IRR_DEPLETED
563