Data Manipulation Language Statements › POST (DC/UCF)

POST (DC/UCF)

The POST statement alters an event control block (ECB) either by posting it to indicate completion of an event upon which another task is waiting, or by clearing it to an unposted status.

Note: Programs posting and waiting on ECBs are responsible for clearing ECBs before issuing subsequent WAIT requests.

Syntax

►►─── POST ─┬─ EVENT (ecb-name) ────────────────┬─ ; ─────────────────────────►◄
            └─ EVENT NAME (ecb-id) ─┬─────────┬─┘
                                    └─ CLEAR ─┘

Parameters

EVENT (ecb)

Identifies the ECB to be posted. Ecb is the symbolic name of a user-defined area composed of three binary fullword fields that contain the ECB. Program-allocated ECBs are cleared by setting ecb to zero.

EVENT NAME (ecb-id)

Specifies the 4-character symbolic ID of the ECB to be posted or cleared. Ecb-id is either the symbolic name of a user-defined field that contains the ECB ID, or the ID itself enclosed in single quotation marks.

CLEAR

Specifies that the ECB identified by ecb-id is cleared to an unposted status.

Example

The following Example posts the event whose ECB identifier is in the FOUND_ECB field and to clear the ECB to an unposted status:

POST
  EVENT NAME (FOUND_ECB)
  CLEAR;

Status Codes

Upon completion of the POST function, the only possible value in the ERROR_STATUS field of the IDMS DC communications block is 0000.