HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_COS_NODE_ROW
AP_NETWORK
(the highest priority)
cos_data.num_of_node_rows
Number of node rows defined for this COS.
cos_data.num_of_tg_rows
Number of TG rows defined for this COS.
cos_data.trees
Number of route tree caches built for this COS since the last initialization.
cos_data.calcs
Number of session activation requests (and therefore route calculations) specifying this class of service.
cos_data.rejs
Number of session activation requests that failed because there was no acceptable route from this node to the
named destination through the network. A route is only acceptable if it is made up entirely of active TGs
and nodes that can provide the specified class of service.
3.100.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_COS_NAME
The list_options parameter was set to AP_LIST_INCLUSIVE, to list all entries starting from the
supplied name, but the cos_name 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.100.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.101 QUERY_COS_NODE_ROW
QUERY_COS_NODE_ROW returns node row information for a specified class of service as previously defined by
DEFINE_COS (or implicitly by the node for the SNA-defined COSs).
This verb can be used to obtain information about a specific COS node row, or about multiple COS node rows,
depending on the options used.
372