CMCFM — Confirm


CMCFM (conversation_ID, request_to_send_received, return_code)
      [LOGGING log_byte]

Where

conversation_ID (character input) is the conversation identifier.

request_to_send_received (numeric_output) specifies the variable containing an indication of whether the remote program issued a CMRTS statement.

Note: If return_code is set to CM_PROGRAM_PARAMETER_CHECK or CM_PROGRAM_STATE_CHECK, the value contained in request_to_send_received is meaningless.

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 local program uses the CMCFM statement to simulate the CPI-C CMCFM call, which is used to send a confirmation request to the remote program and then wait for a reply. The remote program replies with a CMCFMD statement. The local and remote programs use the CMCFM and CMCFMD statements to synchronize their processing of the data.

Note: The sync_level conversation characteristic for the conversation_ID specified must be set to CM_CONFIRM to use this statement. Use the CMSSL (Set_Sync_Level) statement to set the conversation's synchronization level.

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