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

CPI-C Calls
Set_Conversation_Context (cmsctx)
Chapter 3 229
Set_Conversation_Context (cmsctx)
For Unix The Set_Conversation_Context call sets the program's current context to
a value that was previously returned on an
Extract_Conversation_Context call. This enables the program to start a
new conversation using the same context as a previous one.
For more information about conversation contexts, see “Multiple
Conversations” in Chapter 1.
Function Call
void cmsctx (
unsigned char CM_PTR context_ID,
CM_INT32 CM_PTR context_ID_length,
CM_RETURN_CODE CM_PTR return_code
);
Function Call for Java CPI-C
public native void cmsctx (
byte[] context_ID,
CPICLength context_ID_length,
CPICReturnCode return_code
);
NOTE This call is not part of the standard Java CPI-C specification, and is not
supported in other Java CPI-C implementations.
Supplied Parameters
The supplied parameters are:
context_ID This parameter specifies the required context.
context_ID_length This parameter specifies the length of context_ID
(1–32 bytes).