>>-LISTEN--EVENT(data-value)--NOTIFICATION(data-ref)------------> >--+-----------------------+--+-------------------+-------------> +-FILTER(cpsm-token)----+ '-TOKEN(data-value)-' '-NOTFILTER(cpsm-token)-' >--+---------------------+--THREAD(cpsm-token)------------------> '-CONTEXT(data-value)-' >--RESPONSE(data-ref)--REASON(data-ref)------------------------><
This command requests that a notification be sent to the processing thread when a specific event occurs in the CICSplex.
ADDRESS, CANCEL, RECEIVE
If you do not specify the CONTEXT option, the default context for the thread is assumed.
Using the FILTER option, you can limit the notifications you receive to events that are associated with a specific CMAS or CICSplex. For example, you could create a filter like this:
PLEXNAME=EYUPLX01.
and specify that filter on the LISTEN command to be notified only of events generated by CICSplex EYUPLX01.
The cpsm-token value that identifies a filter is returned by the SPECIFY FILTER command.
The cpsm-token value that identifies a filter is returned by the SPECIFY FILTER command.
This identifying token must be specified on the CANCEL command when you want to cancel the notification request.
The following is a list of the RESPONSE values that can be returned by the LISTEN command. The description of each RESPONSE includes a list of associated REASON values, if appropriate.