HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_COS
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 cos_name[8]; /* cos name */
} QUERY_COS;
typedef struct cos_data
{
AP_UINT16 overlay_size; /* size of returned entry */
unsigned char cos_name[8]; /* cos name */
unsigned char description[32]; /* resource description */
unsigned char reserv1[16]; /* reserved */
unsigned char transmission_priority; /* transmission priority */
AP_UINT16 num_of_node_rows; /* number of node rows */
AP_UINT16 num_of_tg_rows; /* number of tg rows */
AP_UINT32 trees; /* number of tree caches for COS */
AP_UINT32 calcs; /* number of route calculations */
/* for this COS */
AP_UINT32 rejs; /* number of route rejects for */
/* COS */
unsigned char reserva[20]; /* reserved */
} COS_DATA;
3.100.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_QUERY_COS
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 COSs for which data should be returned. To request data for a specific COS 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 of COSs from which SNAplus2 should begin to return data. Possible values are:
AP_FIRST_IN_LIST
Start at the first entry in the list.
AP_LIST_INCLUSIVE
Start at the entry specified by the cos_name parameter.
370