HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_CN
3.96.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
AP_NOT_CENTRAL_LOGGER
The verb was issued to a node that is not the central logger.
3.96.5 State Check
If the command does not execute because of a state error, SNAplus2 returns the following parameters:
primary_rc
AP_STATE_CHECK
secondary_rc
AP_NO_CENTRAL_LOG
No master server is currently active.
3.96.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.
3.97 QUERY_CN
QUERY_CN returns information about adjacent Connection Networks. This information is structured as “determined
data” (data gathered dynamically during execution) and “defined data” (the data supplied by the application on
DEFINE_CN).
This verb can be used to obtain information about a specific connection network, or about multiple connection
networks, depending on the options used. It can be issued only at a network node or an end node; it is not valid at
a LEN node.
3.97.1 VCB Structure
typedef struct query_cn
{
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 */
358