High Availability Monitors Version A.03.02 Release Notes

NOF API Verbs (ACTIVATE_SESSION to OPEN_FILE)

DEFINE_CPIC_SIDE_INFO

Chapter 3 185

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 modiﬁes the domain

conﬁguration ﬁle, so that it affects all SNAplus2 CPI-C applications. The

CPI-C function modiﬁes 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 conﬁguration ﬁle.

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 reserved[24]; /* reserved */

} CPIC_SIDE_INFO_DEF_DATA;

typedef struct cpic_side_info

{

unsigned char partner_lu_name[17]; /* Fully qualified */