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

CPI-C Calls
Cancel_Conversation (cmcanc)
Chapter 3130
Function Call for Java CPI-C
public native void cmcanc (
byte[] conversation_ID,
CPICReturnCode return_code
);
Supplied Parameters
The supplied parameter is:
conversation_ID This is the identifier for the conversation. The value of
this parameter is returned by the
Initialize_Conversation, Initialize_For_Incoming, or
Accept_Conversation call.
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. The
specified conversation has been
deallocated, and any outstanding call
on this conversation has been
canceled.
CM_PROGRAM_PARAMETER_CHECK The value specified by
conversation_ID is not valid.
CM_PRODUCT_SPECIFIC_ERROR See Appendix A,
“Common Return Codes.”
State When Issued
The conversation can be in any state except Reset.
State Change
If the return code is CM_OK, the conversation state changes to Reset.