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

CPI-C Calls
Deallocate (cmdeal)
Chapter 3150
Deallocate (cmdeal)
The Deallocate call deallocates a conversation between two programs.
Before deallocating the conversation, this call performs the equivalent of
either the Flush call or the Confirmed call, depending on the current
conversation synchronization level and deallocate type. The deallocate
type is set by the Set_Deallocate_Type call.
The partner program receives the deallocation notification through one
of the following parameters:
• status_received = CM_CONFIRM_DEALLOC_RECEIVED
• return_code = CM_DEALLOCATED_NORMAL
• return_code = CM_DEALLOCATED_ABEND
After this call has successfully executed, the conversation ID is no longer
valid.
Function Call
void cmdeal (
unsigned char CM_PTR conversation_ID,
CM_RETURN_CODE CM_PTR return_code
);
Function Call for Java CPI-C
public native void cmdeal (
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.