z/OS MVS Programming: Sysplex Services Guide
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Understanding Event Monitor Controls

z/OS MVS Programming: Sysplex Services Guide
SA23-1400-00

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.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014