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

CPI-C Calls
Accept_Conversation (cmaccp)
Chapter 3 119
Accept_Conversation (cmaccp)
The Accept_Conversation call is issued by the invoked program to accept
the incoming conversation and set certain conversation characteristics.
For a list of initial conversation characteristics, see Chapter 2, “Writing
CPI-C Applications.”
Upon successful execution of this call, CPI-C generates an 8-byte
conversation identifier. This identifier is a required parameter for all
other CPI-C calls issued by the invoked program during this
conversation.
Function Call
void cmaccp (
unsigned char CM_PTR conversation_ID,
CM_RETURN_CODE CM_PTR return_code
);
Function Call for Java CPI-C
public native void cmaccp (
byte[] conversation_ID,
CPICReturnCode return_code
);
Supplied Parameters
There are no supplied parameters for this call.
Returned Parameters
After the call executes, SNAplus2 returns parameters to indicate
whether the execution was successful and, if not, to indicate the reason
the execution was unsuccessful.
conversation_ID This is the identifier for the conversation. It is used by
subsequent CPI-C calls.
return_code Possible values are:
CM_OK The call executed successfully.