CMSLD — Set_Log_Data


CMSLD (conversation_ID, log_data, log_data_length, return_code),
        [LOGGING log_byte]

Where

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

log_data (character input) specifies the program-unique error information that is to be logged. The data supplied by the program is any data that the program wants logged. The data must be from character set 00640.

log_data_length (numeric input) specifies the length of the program-unique error information. The length can be from 0 to 512 bytes. If zero, the log_data_length characteristic is set to zero (effectively setting the log_data characteristic to the null string), and the log_data parameter of this statement is ignored.

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. The default log_byte is X'00'. Only the first character or first two hexadecimal digits of the string expression are used.

Function

A program uses the CMSLD statement to simulate the CPI-C CMSLD call, which is used to set the log_data and log_data_length characteristics for a given conversation. The CMSLD statement overrides the values that were assigned when the CMINIT or CMACCP statement was issued.

Note: This statement applies only to basic conversations. The log_data characteristic is ignored for mapped conversations.

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