HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_NODE_ALL
3.145.1 VCB Structure
typedef struct query_node_all
{
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 */
unsigned char node_name[128]; /* node name */
} QUERY_NODE_ALL;
typedef struct node_summary
{
AP_UINT16 overlay_size; /* size of returned entry */
unsigned char node_name[128]; /* node name */
unsigned char config_role; /* server’s config file role */
unsigned char reserv3[12]; /* reserved */
} NODE_SUMMARY;
3.145.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_QUERY_NODE_ALL
buf_ptr
A pointer to a data buffer that SNAplus2 will use to return the requested information.
buf_size
Size of the supplied data buffer.
num_entries
Maximum number of nodes for which data should be returned. To request data for a specific node rather than
a range, specify the value 1. To return as many entries as possible, specify zero; in this case, SNAplus2 will
return the maximum number of entries that can be accommodated in the supplied data buffer.
list_options
The position in the list from which SNAplus2 should begin to return data. Possible values are:
AP_FIRST_IN_LIST
Start at the first entry in the list of nodes.
AP_LIST_INCLUSIVE
Start at the entry specified by the node_name parameter.
AP_LIST_FROM_NEXT
Start at the entry immediately following the entry specified by the node_name parameter.
590