Confirming Receipt of Data and Reporting Errors

The following calls confirm receipt of data or report an error.

Confirmed (cmcfmd)

Replies to a confirmation request from the partner program. It informs the partner program that the local program has not detected an error in the received data. Because the program issuing the confirmation request waits for a confirmation, Confirmed synchronizes the processing of the two programs.

Send_Error (cmserr)

Notifies the partner program that the local program has encountered an application-level error. The local program can use Send_Error to inform the partner program of an error encountered in received data, to reject a confirmation request, or to truncate an incomplete logical record it is sending.

Set_Error_Direction (cmsed)

Specifies whether a program detected an error while receiving data or while preparing to send data. Error direction is relevant only when a program issues Send_Error in SEND_PENDING state—immediately after issuing Receive and receiving data as well as a status_received value of CM_SEND_RECEIVED.

Set_Log_Data (cmsld)

Used in a basic conversation, this call specifies a log message (log data) and its length to be sent to the partner LU. This call has an effect only in basic conversations. If present, log data is sent when Send_Error is issued or when the conversation is abnormally deallocated. After the log data is sent, CPI-C resets the log data to NULL and the log data length to zero.