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

CPI-C Calls
Set_Conversation_Context (cmsctx)
Chapter 3230
Returned Parameters
After the verb executes, SNAplus2 returns parameters to indicate
whether the execution was successful and, if not, to indicate the reason
the execution was unsuccessful.
return_code Possible values are:
CM_OK The call executed successfully.
CM_PROGRAM_PARAMETER_CHECK This return code
indicates one of the following cases:
• The value specified by
context_ID is not the context of
any of the program's current
conversations, or of its most
recent conversation.
• The value specified by
context_ID_length is not valid.
CM_PRODUCT_SPECIFIC_ERROR For an explanation of
this return code, see Appendix A,
“Common Return Codes.”
State When Issued
The conversation can be in any state except Reset.
State Change
There is no state change.
Usage Notes
An application uses Set_Conversation_Context in the following
situations:
• When it is involvedin multiple conversations, and wantsto allocate a
new conversation using the same context as an existing
conversation.
• When a CPI-C call that assigns a new context completes in
nonblocking mode. For example, if Accept_Incoming completes
immediately with return_code CM_OK, the program's currentcontext