Information about a user and a designated sublist being monitored
by the user is stored in an event monitor controls (EMC) object for
the user. There can be at most one EMC per user per sublist being
monitored. The information in an event monitor controls object includes
the following:
- List number of the list with which the EMC is associated.
- List entry key of the sublist with which the EMC is associated.
- User notification control data either supplied by the connector
when this EMC was established to monitor the sublist or updated by
a subsequent MONITOR_SUBLIST or MONITOR_SUBLISTS request.
- Connection identifier of the user with which the EMC is associated.
The IXLLIST REQUEST=MONITOR_SUBLIST and REQUEST=MONITOR_SUBLISTS
request types allow you to create EMCs and update their user notification
control data.
There are two additional IXLLIST request types that allow you to
reference EMCs:
- The IXLLIST REQUEST=READ_EMCONTROLS request allows you to determine
if an EMC for a specific sublist is queued to your event queue. If
the EMC exists, the system returns the EMC information, including
the user notification controls data, in an answer area that you specify
on the request. If the EMC does not exist, the system returns reason
code IXLRSNCODENOENTRY.
- The IXLLIST REQUEST=DEQ_EVENTQ request allows you to atomically
read the EMCs and dequeue them from the event queue with a single
command. The system removes the EMCs from your event queue but maintains
their association with the sublist(s) you are monitoring. The system
returns the EMC information in a buffer area that you specify on the
request. The system also returns a count of how many EMCs were read
and dequeued from the event queue and a count of how many EMCs remain
queued on the event queue.