Dequeuing Event Monitor Controls from an Event Queue

Use IXLLSTC REQUEST=DEQ_EVENTQ to dequeue event monitor controls (EMCs) from an event queue. Specify whether the EMCs to be dequeued are for state transitions of sublists identified by list entry key or for state transitions of sublists identified by secondary key. Secondary keys can be specified only when the structure is allocated in a coupling facility of CFLEVEL=9 or higher and has been allocated to support secondary keys (IXLCONN KEYTYPE=SECONDARY).

If the structure is allocated in a coupling facility of CFLEVEL=9 or higher and has been allocated with secondary keys (IXLCONN KEYTYPE=SECONDARY), there are two event queues that can be processed. The IXLLSTC KEYTYPE parameter (ENTRY or SECONDARY) designates which event queue is to be processed. KEYTYPE=ENTRY specifies that EMCs for state transitions of sublists identified by list entry key are to be dequeued. KEYTYPE=SECONDARY specifies that EMCs for state transitions of sublists identified by secondary key are to be dequeued.

See DEQ_EVENTQ: Retrieving Events from the Event Queue for additional information, including how to handle an incompletely processed request to dequeue EMCs. For list structures allocated in a coupling facility of CFLEVEL=9 or higher, additional information that is returned in the BUFFER or BUFLIST area mapped by IXLYEMC includes:

An indication of whether an EMC will be queued to the associated event queue whenever a list entry is added to the sublist or when only the first list entry is added to the sublist.
An indication of whether the monitored sublist is for a secondary key or for a list entry key.
The secondary key of the sublist with which the EMC is associated, if applicable.