CMSCT — Set_Conversation_Type


CMSCT (conversation_ID, conversation_type, return_code)
      [LOGGING log_byte]

Where

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

conversation_type (numeric input) specifies the type of conversation to be allocated when CMALLC is issued. The conversation_type variable can have one of the following values:

CM_BASIC_CONVERSATION
CM_MAPPED_CONVERSATION

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 CMSCT statement to simulate the CPI-C CMSCT call, which is used to set the conversation_type characteristic for a given conversation. The CMSCT statement overrides the value assigned when the CMINIT statement was issued.

Note: The CMSCT statement can be issued only after the CMINIT for the conversation has completed, and before the CMALLC is issued.

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