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

CPI-C Calls
Initialize_Conversation (cminit)
Chapter 3 189
Initialize_Conversation (cminit)
The Initialize_Conversation call is issued by the invoking program to
obtain an 8-byte conversation ID and to set the initial values for the
conversation's characteristics.
The initial values are CPI-C defaults or are derived from side
information associated with the symbolic destination name. For more
information about initial values and side information, see Chapter 2,
“Writing CPI-C Applications.”
Upon successful execution of this call, CPI-C generates a conversation
identifier. This identifier is a required parameter for all other CPI-C calls
issued for this conversation by the invoking program.
Initial values can be changed by the Set_* calls.
Function Call
void cminit (
unsigned char CM_PTR conversation_ID,
unsigned char CM_PTR sym_dest_name,
CM_RETURN_CODE CM_PTR return_code
);
Function Call for Java CPI-C
public native void cminit (
byte[] conversation_ID,
String sym_dest_name,
CPICReturnCode return_code
);
Supplied Parameters
The supplied parameter is:
sym_dest_name This parameter specifies the symbolic destination
name—the name associated with a side information
entry loaded from the SNAplus2 configuration file or
defined by Set_CPIC_Side_Information calls.