HP-UX SNAplus2 CPI-C Programmer's Guide (June 2003)

CPI-C Calls
Set_CPIC_Side_Information (xcmssi)
Chapter 3 247
Set_CPIC_Side_Information (xcmssi)
This function is not available in Java CPI-C.
The Set_CPIC_Side_Information call specifies a side information entry
for use by this application. A CPI-C side information entry associates a
set of conversation characteristics with a symbolic destination name.
Side information entries are defined in the SNAplus2 configuration file.
This call specifies an additional entry for use by this application, or
overrides the definition in the configuration file (or the application's local
definition) if the specified symbolic destination name already exists.
This call is provided for compatibility with X/Open CPI-Cand with the
Windows CPI-C specification; it is not included in IBM CPI-C 2.0.
Function Call
void xcmssi (
unsigned char CM_PTR key,
SIDE_INFO CM_PTR side_info_entry,
CM_INT32 CM_PTR side_info_entry_length,
CM_RETURN_CODE CM_PTR return_code
);
typedef struct side_info_entry
{
unsigned char sym_dest_name[8]; /* symbolic destination name */
unsigned char partner_LU_name[17]; /* Fully qualified partner LU name*/
unsigned char reserved[3]; /* Reserved */
XC_TP_NAME_TYPE TP_name_type; /* TP name type */
unsigned char TP_name[64]; /* TP name */
unsigned char mode_name[8]; /* Mode name */
XC_CONVERSATION_SECURITY_TYPE
conversation_security_type; /* Conversation security type*/
unsigned char security_user_ID[8]; /* User ID */
unsigned char security_password[8]; /* Password */
} SIDE_INFO;
Supplied Parameters
The supplied parameters are:
key This parameter is ignored.