CMSRC — Set_Return_Control


CMSRC (conversation_ID, return_control, return_code) [LOGGING log_byte]

Where

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

return_control (numeric input) specifies when a program receives control back after issuing a CMALLC statement. The return_control variable can have one of the following values:

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

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

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