Obtaining List Monitoring Information

Each list has associated with it an array of list monitoring entries. Each list monitoring entry describes the list monitoring activities associated with that list for a particular connection ID. A list monitoring entry is returned for each connection ID regardless of whether that connection ID represents an active user of the structure. List monitoring entries for unused connection IDs are set to zeros. Each list monitoring information entry is mapped by the IXLYLMI macro.

The array of list monitoring information entries is returned in the buffer specified by BUFFER or BUFLIST. When control returns from a READ_LCONTROLS request, the LAALMICNT field in the answer area contains the number of list monitoring information entries in the array. The entries are numbered from 0 to LAALMICNT-1 but entry 0 does not contain list monitoring information and should not be accessed. The list monitoring information, indexed by connection ID number, begins with entry 1.

To access information for a particular connection ID, use the ID number as an index into the array or scan the array from entry 1 to entry LAALMICNT-1. Each list monitoring information entry contains the following information about the associated connection ID:

Whether the connection ID is monitoring the list
Whether the connection ID is using a list transition exit to receive notification of this list's transitions.
The vector index in the connection ID's list notification vector representing the list.