Description

The IXLLSTC macro provides operations to atomically perform locking functions, monitor list and sublist state changes, read and write list controls, read event queue controls and event monitor controls, and dequeue event monitor controls.

The IXLLSTC macro provides list services equivalent to the following IXLLIST request types:

IXLLIST REQUEST=DEQ_EVENTQ
IXLLIST REQUEST=LOCK
IXLLIST REQUEST=MONITOR_EVENTQ
IXLLIST REQUEST=MONITOR_LIST
IXLLIST REQUEST=MONITOR_SUBLIST
IXLLIST REQUEST=MONITOR_SUBLISTS
IXLLIST REQUEST=READ_EMCONTROLS
IXLLIST REQUEST=READ_EQCONTROLS
IXLLIST REQUEST=READ_LCONTROLS
IXLLIST REQUEST=WRITE_LCONTROLS

New functions are available with the IXLLSTC macro at OS/390® Release 9. These new functions require that the list structure be allocated in a coupling facility of CFLEVEL=9 or higher.

Keyrange monitoring (with REQUEST=MONITOR_KEYRANGE) allows you to monitor the empty or not-empty state of a set of keyrange values, based on user-defined threshold counts. Both the threshold counts and the starting and ending keyrange values are defined with IXLLSTC REQUEST=WRITE_LCONTROLS.
Support for secondary keys is provided on the REQUEST=READ_EQCONTROLS, REQUEST=READ_EMCONTROLS, REQUEST=DEQ_EVENTQ, REQUEST=MONITOR_EVENTQ, MONITOR_SUBLIST, MONITOR_SUBLISTS request types.
Support for a request that whenever a list entry is queued to a monitored sublist, an EMC is queued to the registered user's event queue is provided on the REQUEST=MONITOR_SUBLIST and REQUEST=MONITOR_SUBLISTS request types.

See z/OS MVS Programming: Sysplex Services Guide for information about using the IXLLSTC macro.