Cooperative Processing Commands › PREPARE-TO-RECEIVE

PREPARE-TO-RECEIVE

Purpose

Prepares to receive data from a remote program.

Syntax

►►─── PREPARE-TO-RECEIVE ───┬─ SYNC-LEVEL ◄─┬────── . ───────────────────────►◄
                            └─ FLUSH ───────┘

Parameters

SYNC-LEVEL

Processes data based on the current synchronization level. If the synchronization level is:

• NONE— All data in the communications buffer is sent to the remote program before the local dialog is put in receive state.
• CONFIRM— All data in the communications buffer is sent to the remote program along with a request for confirmation. If the remote dialog issues CONFIRMED, the local dialog is put in receive state. Otherwise, the return code from the remote program determines the state of the conversation.

SYNC-LEVEL is the default for PREPARE-TO-RECEIVE

FLUSH

Sends all data in the communications buffer to the remote program.

Usage

PREPARE-TO-RECEIVE is issued by the dialog in send state in response to REQUEST-TO-SEND. PREPARE-TO-RECEIVE switches the local dialog to receive state.

Considerations

To check the status of a conversation test the system fields: REQUEST-TO-SEND and WHAT-RECEIVED.