A DEQ_EVENTQ request allows you to read and dequeue event monitor controls from your event queue. The EMCs are returned in the storage area specified by the BUFFER or BUFLIST parameter. The information for each EMC object is mapped by the IXLYEMC macro

A DEQ_EVENTQ request can complete before all the events have been read off your event queue. If this occurs, you are notified by a return code indicating that more events remain on the event queue. The count of EMCs that are still queued to the event queue is returned in the answer area.

In the case of a premature completion of an IXLLIST REQUEST=DEQ_EVENTQ request, all prior EMCs were processed successfully. To continue to read and dequeue EMCs from your event queue, reissue the IXLLIST REQUEST=DEQ_EVENTQ as many times as is required after processing the previous contents of the BUFFER or BUFLIST storage area.

A DEQ_EVENTQ request can be issued only for keyed list structures allocated in a coupling facility of CFLEVEL=3 or higher. DEQ_EVENTQ requests issued for a list structure allocated in a coupling facility of CFLEVEL 0, 1, or 2 will fail.