HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_CPIC_SIDE_INFO
3.14.6 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.15 DEFINE_CPIC_SIDE_INFO
This verb adds or replaces a side information entry. A CPI-C side information entry associates a set of conversation
characteristics with a symbolic destination name. If there is already a side information entry with the same symbolic
destination name as the one supplied with this verb, it is overwritten with the data supplied to this call.
Note the difference between this verb and the CPI-C function
Set_CPIC_Side_Information. This verb
modifies the domain configuration file, so that it affects all SNAplus2 CPI-C applications. The CPI-C function
modifies the application’s own copy in memory of the side information table, and does not affect any other CPI-C
applications.
This verb must be issued to the domain configuration file.
3.15.1 VCB Structure
typedef struct define_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 reserv2a[8]; /* reserved */
unsigned char sym_dest_name[8]; /* Symbolic destination name */
CPIC_SIDE_INFO_DEF_DATA def_data;
} DEFINE_CPIC_SIDE_INFO;
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 */
121