CMSRT — Set_Receive_Type


CMSRT (conversation_ID, receive_type, return_code) [LOGGING log_byte]

Where

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

receive_type (numeric input) specifies the type of receive to be performed. The receive_type variable can have one of the following values:

CM_RECEIVE_AND_WAIT
CM_RECEIVE_IMMEDIATE

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 CMSRT statement to simulate the CPI-C CMSRT call, which is usedto set the receive_typecharacteristic for a conversation. The CMSRT statement overrides the value that was assigned when the CMINIT or CMACCP statement was issued.

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