HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_NN_TOPOLOGY_NODE
Name of the registered application. This is an 8-byte type-A EBCDIC string, padded on the right with spaces
if the name is shorter than 8 characters.
nmvt_application_data.ms_vector_key_type
MS vector key accepted by the application. When the application registers for NMVT messages, it specifies
which MS vector keys it will accept.
nmvt_application_data.conversion_required
Specifies whether the registered application requires incoming messages to be converted from NMVT to
MDS_MU format. When the application registers for NMVT messages, it specifies whether this conversion
is required. Possible values are:
AP_YES
Incoming messages are converted to MDS_MU format.
AP_NO
Incoming messages are not converted.
3.140.4 Returned Parameters: Parameter Check
If the verb does not execute because of a parameter error, SNAplus2 returns the following parameters:
primary_rc
AP_PARAMETER_CHECK
secondary_rc
Possible values are:
AP_INVALID_APPLICATION_NAME
The
list_options parameter was set to AP_LIST_INCLUSIVE to list all entries starting from the
supplied name, but the application parameter was not valid.
AP_INVALID_LIST_OPTION
The list_options parameter was not set to a valid value.
Appendix B, Common Return Codes lists further secondary return codes associated with
AP_PARAMETER_CHECK,
which are common to all NOF verbs.
3.140.5 Returned Parameters: Other Conditions
Appendix B, Common Return Codes lists further combinations of primary and secondary return codes that are
common to all NOF verbs.
3.141 QUERY_NN_TOPOLOGY_NODE
Each network node maintains a network topology database which holds information about all the net-
work nodes, virtual routing nodes (VRNs), and network node to network node TGs in the network.
QUERY_NN_TOPOLOGY_NODE returns information about the network node and VRN entries in this database.
This verb can be used to obtain either summary or detailed information, about a specific node or about multiple
nodes, depending on the options used. It can be issued only to a network node; it is not valid at an end node or a
LEN node.
This verb must be issued to a running node.
559