CMSED — Set_Error_Direction


CMSED (conversation_ID, error_direction, return_code) [LOGGING log_byte]

Where

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

error_direction (numeric input) specifies the direction of the data flow in which the program detected an error. The parameter is significant only if CMSERR is issued in the Send_Pending state (that is, immediately after a CMRCV on which both data and a conversation status of CM_SEND_RECEIVED are received). Otherwise, the error_direction value is ignored when the program issues CMSERR.

The error_direction variable can have one of the following values:

CM_RECEIVE_ERROR
CM_SEND_ERROR

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 CMSED statement to simulate the CPI-C CMSED call, which is usedto set the error_direction characteristic for a given conversation. The CMSED statementoverrides the value assigned when the CMINIT or CMACCP statement was issued.

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