HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_FOCAL_POINT
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 ms_category[8]; /* name of MS category */
} QUERY_FOCAL_POINT;
typedef struct fp_data
{
AP_UINT16 overlay_size; /* size of returned entry */
unsigned char ms_appl_name[8]; /* focal point application name */
unsigned char ms_category[8]; /* focal point category */
unsigned char description[32]; /* resource description */
unsigned char reserv1[16]; /* reserved */
unsigned char fp_fqcp_name[17]; /* focal point fully qualified */
/* cp name */
unsigned char bkup_appl_name[8]; /* backup focal point */
/* application name */
unsigned char bkup_fp_fqcp_name[17]; /* backup fp fully qualified cp */
/* name */
unsigned char implicit_appl_name[8]; /* implicit focal point appl name */
unsigned char implicit_fp_fqcp_name[17]; /* implicit fp fully qualified */
/* cp name */
unsigned char fp_type; /* focal point type */
unsigned char fp_status; /* focal point status */
unsigned char fp_routing; /* type of MDS routing to use */
unsigned char reserva[20]; /* reserved */
AP_UINT16 number_of_appls; /* number of applications */
} FP_DATA;
Each fp_data
structure is followed by one or more application names; the number of these is specified by the num-
ber_of_appls parameter. Each application name has the following format:
unsigned char appl_name[8]; /* application name */
3.121.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_QUERY_FOCAL_POINT
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 entries for which data should be returned. To request data for a specific entry 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 focal points from which SNAplus2 should begin to return data. Possible values are:
456