EVENTCHECK

PLBCMP GUI Only

The EVENTCHECK instruction dispatches any queued events. The instruction uses the following format:

Where:

label

Optional. A Program Execution Label.

Flags Affected: NONE

Note the following:

1. If events are pending in the event queue, they are dispatched in the order in which they occurred. The dispatching mechanism is similar to the TRAP logic in that a CALL is executed to the specified subroutine for the given event.

2. All pending events are queued and only the top event in the queue is dispatched before control is returned to the instruction after the EVENTCHECK instruction.

3. If a FILEPI instruction is active, it is terminated.

4. In a DIALOG, the EVENTCHECK statement waits for up to one tenth of a second before returning if there is no pending event.

5. CHECKEVENT is an obsolete synonym for EVENTCHECK.

See Also: CLEAREVENT, EVENTWAIT, Object Output Instructions, Program Control Instructions