Description

A MONITOR_LIST request allows you to start (ACTION=START) or stop (ACTION=STOP) monitoring a specified list (LISTNUM) for the presence of entries. When starting list monitoring, you must specify the list notification vector index (VECTORINDEX) to be associated with the LISTNUM list. List services uses the specified vector index to indicate whether the list is in the empty or non-empty state.

If you want to be notified when one of the lists for which list monitoring has been activated has changed state from empty to non-empty, you can specify DRIVEEXIT=YES. This option causes your list transition exit to be driven, informing you that a list that you monitor now has at least one entry on it. Your list transition exit must be identified on the LISTTRANEXIT parameter of the IXLCONN macro. To determine which of the monitored lists has changed state, you must use the IXLVECTR macro.

There are some considerations involving when you must stop list monitoring. If you have started list monitoring for a certain list with a certain vector index specified and you want to:

Monitor a different list with the same vector index: You must stop list monitoring of the old list with the index before you start list monitoring of the new list with that index.
Monitor the same list with a different vector index: Do not stop monitoring the list with the old vector index. Simply start monitoring the list with the new index; the new index will automatically replace the old.