CMDEAL — Deallocate


CMDEAL (conversation_ID, return_code) [LOGGING log_byte]

Where

conversation_ID (character input) specifies the conversation identifier of the conversation to be deallocated.

return_code (numeric output) specifies the result of the statement execution.

log_byte is a 1-byte string constant or a string expression that specifies a byte of user data to be associated with this CPI-C statement during logging. The log_byte remains active until another CPI-C statement is issued. Only the first character or first two hexadecimal digits of the string expression are used. The default log_byte is X'00'.

Function

A program uses the CMDEAL statement to simulate the CPI-C CMDEAL call, which is used to end a conversation. The CMDEAL statement can include the function of the CMFLUS or CMCFM statement, depending on the value of the deallocate_type conversation characteristic. The conversation_ID is no longer assigned when the conversation is deallocated as part of this statement.

Before issuing the CMDEAL statement, a program has the option of issuing one or both of the following statements to set deallocation parameters:

CMSDT — Set_Deallocate_Type
CMSLD — Set_Log_Data

For more information on CMDEAL and its parameters, refer to the Deallocate (CMDEAL) call description in the “Call Reference” chapter of Systems Application Architecture Common Programming Interface Communications Reference.