HP-UX SNAplus2 NOF Programmer's Guide

NOF API Verbs (QUERY Verbs)
QUERY_CPIC_SIDE_INFO
Chapter 4 581
QUERY_CPIC_SIDE_INFO
This verb returns the side information entry for a given symbolic
destination name, or for multiple symbolic destination names, depending
on the options used.
Note the difference between this verb and the CPI-C function
Extract_CPIC_Side_Information(). This verb queries a configuration
file, so that it returns the default information used by all SNAplus2
CPI-C applications. The CPI-C function queries the application's own
copy in memory of the side information table, which the application may
have modified using the other CPI-C side information functions.
This verb must be issued to the domain configuration file.
VCB Structure
typedef struct query_cpic_side_info
{
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 sym_dest_name[8]; /* Symbolic destination name */
} QUERY_CPIC_SIDE_INFO;
typedef struct cpic_side_info_data
{
AP_UINT16 overlay_size; /* size of returned entry */
unsigned char sym_dest_name[8]; /* Symbolic destination name */
unsigned char reserv1[2]; /* reserved */
CPIC_SIDE_INFO_DEF_DATA def_data;
} CPIC_SIDE_INFO_DATA;
typedef struct cpic_side_info_def_data
{
unsigned char description[32]; /* resource description */