HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_LOCAL_TOPOLOGY
3.125.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_LU_ALIAS
The list_options parameter was set to AP_LIST_INCLUSIVE to list all entries starting from the
supplied name, but the lu_alias parameter was not valid.
AP_INVALID_LU_NAME
The list_options parameter was set to AP_LIST_INCLUSIVE to list all entries starting from the
supplied name, but the lu_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.125.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.126 QUERY_LOCAL_TOPOLOGY
All APPN nodes maintain a local topology database which holds information about the TGs to all adjacent nodes.
QUERY_LOCAL_TOPOLOGY allows information about these TGs to be returned.
This verb can be used to obtain either summary or detailed information, about a specific TG or about multiple TGs,
depending on the options used.
This verb must be issued to a running node.
3.126.1 VCB Structure
typedef struct query_local_topology
{
AP_UINT16 opcode; /* verb operation code */
unsigned char reserv2; /* reserved */
unsigned char format; /* reserved */
AP_UINT16 primary_rc; /* primary return code */
AP_UINT32 secondary_rc; /* secondary return code */
unsigned char *buf_ptr; /* pointer to buffer */
AP_UINT32 buf_size; /* buffer size */
AP_UINT32 total_buf_size; /* total buffer size required */
AP_UINT16 num_entries; /* number of entries */
AP_UINT16 total_num_entries; /* total number of entries */
unsigned char list_options; /* listing options */
unsigned char reserv3; /* reserved */
479