Cooperative Processing Commands › CONFIRM

CONFIRM

Purpose

Sends a confirmation request to a remote program and waits for a reply.

Syntax

►►───── CONFIRM ── . ─────────────────────────────────────────────────────────►◄

Usage

CONFIRM sends all data in the communications buffers to the remote program.

Considerations

• Before CONFIRM can be issued, the conversation must have a synchronization level of CONFIRM: SYNC-LEVEL CONFIRM on the ALLOCATE command and the issuing dialog must be in the send state.
• When using CONFIRM to synchronize processing between 2 programs
  • If the remote program received all data sent, it returns CONFIRMED.
  • If the remote program can't process the data due to an application-level error, it returns SEND-ERROR.
• To check the status of a conversation, test the system fields REQUEST-TO-SEND-RECEIVED and WHAT-RECEIVED.

Example

The local program can issue a confirmation or send an error message:

SEND-DATA EMPLOYEE-RECORD.
IF APPCCODE EQ ZERO
  THEN
  CONFIRM.
ELSE
  DO.
  DEALLOCATE ABEND.
  ABORT MSG TEXT 'SEND-DATA ERROR'.
  END.

For the corresponding response from the remote program, see CONFIRMED.