HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_CPIC_SIDE_INFO
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.
3.103.1 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 */
unsigned char reserv1[16]; /* reserved */
CPIC_SIDE_INFO side_info; /* CPIC side info */
unsigned char user_data[24]; /* reserved */
} CPIC_SIDE_INFO_DEF_DATA;
typedef struct cpic_side_info
{
unsigned char partner_lu_name[17]; /* Fully qualified partner */
/* LU name */
unsigned char reserved[3]; /* Reserved */
AP_UINT32 tp_name_type; /* TP name type */
unsigned char tp_name[64]; /* TP name */
unsigned char mode_name[8]; /* Mode name */
AP_UINT32 conversation_security_type; /* Conversation security */
/* type */
unsigned char security_user_id[10]; /* User ID */
unsigned char security_password[10]; /* Password */
unsigned char lu_alias[8]; /* LU alias */
} CPIC_SIDE_INFO;
3.103.2 Supplied Parameters
The application supplies the following parameters:
382