Implementing support for data set triggering

Use the Tivoli Workload Scheduler for z/OS data set triggering function to start dependent processing or schedule unplannable work by automatically generating special resource availability events when a data set is closed after being opened for:

• Read processing
• Output processing
• Either read or output processing.

Tivoli Workload Scheduler for z/OS uses the SMF exit IEFU83 to generate a resource availability event when IEFU83 is called for SMF record types 14, 15, or 64. The data set activity SMF records are generated when a data set is closed or processed by EOV. Tivoli Workload Scheduler for z/OS will generate resource availability events only when the data set is closed. When a VSAM data set is closed, two SMF 64 records are created, one each for the DATA and INDEX components. When resource availability events are requested for VSAM data sets, the event will be created when the DATA component is closed, Tivoli Workload Scheduler for z/OS will not generate an event when the INDEX component is closed.

SMF data set activity records are written when the data set is closed, regardless of whether the JOB/STEP/TASK/USER completed successfully. For more information about the data sets that generate SMF record types 14, 15, or 64, see the documentation for MVS™ SMF.

To define the data sets for which you want events to be generated, you can perform either of the following:

• Use the EQQRXTRG program to centralize and automate the population of the data set to which the EQQJCLLIB DD name refers. For detailed information about running event-driven workload automation, see Managing the Workload.
• Build a selection table, as described in Appendix D. Invoking the EQQLSENT macro. The selection table is located in ECSA. It is automatically loaded from the data set referred to by the EQQJCLIB DD name when the event writer is started in a tracker if a table has not previously been loaded since IPL. To reload the table at any time, issue the z/OS modify command:

      F procname,NEWDSLST

  Note:

  No support is available for the data set triggering function before the event writer is started immediately after a z/OS IPL. When the event writer has started after IPL, data set triggering functions are available if the event writer is subsequently stopped. To stop data set triggering at any time issue the NEWDSLST modify command to load a table that contains only the end-of-table indicator.

To implement support for the data set triggering function, perform these actions:

• Update SYS1.PARMLIB member SMFPRMnn as described in Updating SMF parameters.
• Install SMF exit IEFU83 using the EQQU831 sample. See Macro invocation syntax for EQQEXIT on how to specify the SRREAD parameter.
• Define the data set selection criteria as described by the event-driven resource handling section in Managing the Workload.

  The procedure described in Appendix D. Invoking the EQQLSENT macro is supported for backward compatibility only.