Cooperative Processing Commands › DEALLOCATE

DEALLOCATE

Purpose

Ends the conversation.

Syntax

►►─── DEALLOCATE ────┬─ FLUSH ────────┬────── . ──────────────────────────────►◄
                     ├─ SYNC-LEVEL ◄ ─┤
                     ├─ ABEND ────────┤
                     └─ LOCAL ────────┘

Parameters

FLUSH

Sends all data in the communications buffer to the remote program and then terminates the conversation normally.

SYNC-LEVEL

Terminates the conversation based on the synchronization level. If the current synchronization level is:

• NONE— All data in the communications buffer is sent to the remote dialog and the conversation terminates normally.
• CONFIRM— All data in the communications buffer is sent to the remote dialog along with a request for confirmation. Once confirmation arrives from the remote program, the conversation terminates normally. Otherwise, the return code determines the state of the conversation.

SYNC-LEVEL is the default for DEALLOCATE

ABEND

Terminates the conversation abnormally.

The following considerations apply:

• If the dialog is in send state, all data in the buffer is sent to the remote program
• If the dialog is in receive state, all data in the buffer is purged

LOCAL

Terminates the conversation after the remote dialog has deallocated the conversation.

Usage

DEALLOCATE is the last command in the conversation, but each dialog can continue independent processing. The command only ends the conversation.

Considerations

DEALLOCATE:

• Is not a control command
• Does not end the dialog

Example

IF APPCCODE NE ZERO
  THEN
  DO.
  DEALLOCATE ABEND.
  ABORT MSG TEXT 'PROBLEM IN PROCESSING'.
  END.