HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_SNA_NET
Appendix B, Common Return Codes lists further secondary return codes associated with
AP_PARAMETER_CHECK,
which are common to all NOF verbs.
3.157.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.158 QUERY_SNA_NET
QUERY_SNA_NET returns information about servers that can act as backup master servers, as defined in the
sna.net file. It can be used to obtain information about a specific server or about multiple servers, depending on
the options used.
The ordering of server names in this file is significant; the first server listed in the file will always be the master if
it is active, the second will be the master if the first is inactive, the third will be the master if the first and second
are both inactive, and so on. Because of this, the list of server names returned on QUERY_SNA_NET is in the
same order as it is in the file; the returned names are not ordered by name length and lexicographical ordering, as
with other QUERY_* verbs.
This verb must be issued to the sna.net file.
3.158.1 VCB Structure
typedef struct query_sna_net
{
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 security; /* reserved */
unsigned char domain_name[64]; /* domain name */
unsigned char server_name[128]; /* master or backup server name */
unsigned char reserv4[4]; /* reserved */
} QUERY_SNA_NET;
typedef struct backup_summary
{
AP_UINT16 overlay_size; /* size of returned entry */
unsigned char reserv1[2]; /* reserved */
unsigned char server_name[128]; /* master or backup server name */
unsigned char reserv2[4]; /* reserved */
} BACKUP_SUMMARY;
3.158.2 Supplied Parameters
The application supplies the following parameters:
653