HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_NN_TOPOLOGY_TG
topology_tg_detail.appended_data_format
Specifies the format of data appended to this NOF VCB structure.
If the parameter topology_tg_detail.appended_data_len is set to a non-zero value, indicating that appended
data is included, this parameter is set to the following value:
AP_TG_DESCRIPTOR_CV
The appended data contains a TG Descriptor CV, as defined by SNA Formats.
If topology_tg_detail.appended_data_len is zero, indicating that no appended data is included, this parameter
is reserved.
topology_tg_detail.appended_data_len
Specifies the length of the TG Descriptor CV data appended to this NOF VCB structure. If this parameter is
set to zero, no appended data is included.
3.143.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_TG
The list_options parameter was set to
AP_LIST_INCLUSIVE to list all entries starting from the
supplied name, but the tg_num parameter was not valid.
AP_INVALID_ORIGIN_NODE
The list_options parameter was set to AP_LIST_INCLUSIVE to list all entries starting from the sup-
plied name, but the owner 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.143.5 Returned Parameters: Function Not Supported
If the verb does not execute successfully because the local node is not a network node, SNAplus2 returns the
following parameters:
primary_rc
AP_FUNCTION_NOT_SUPPORTED
The local node is not a network node. This verb can be used only at a network node.
3.143.6 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.
576