CMECS — Extract_Conversation_State


CMECS (conversation_ID, conversation_state, return_code)
      [LOGGING log_byte]

Where

conversation_ID (character input) specifies the conversation identifier of the desired conversation.

conversation_state (numeric output) specifies the conversation state that is returned to the local program. The conversation_state can be one of the following:

CM_INITIALIZE_STATE
CM_SEND_STATE
CM_RECEIVE_STATE
CM_SEND_PENDING_STATE
CM_CONFIRM_STATE
CM_CONFIRM_SEND_STATE
CM_CONFIRM_DEALLOCATE_STATE

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 CMECS statement to simulate the CPI-C CMECS call, which is usedto extract the conversation state for a given conversation. The value is returned in the conversation_state parameter.

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