Step 5. Adding SMF and JES exits for event tracking

Perform this task if you are installing a tracker.

Tivoli Workload Scheduler for z/OS tracks the progress of jobs and started tasks through the z/OS system by using JES and SMF exit points. Add all these exits on each z/OS system where you will start Tivoli Workload Scheduler for z/OS.

To simplify the installation of Tivoli Workload Scheduler for z/OS event tracking, several sample event-tracking exits can be found in your sample library, SEQQSAMP. To assemble and install exits, you can use the sample JCL provided to install the exits as SMP/E usermods or alternatively you can assemble and link-edit the exits yourself. For JES exits, apply usermods in the CSI where JES is included: this is the best method. It has the advantage that SMP automatically reassembles the exits if maintenance is applied to the JES control blocks that Tivoli Workload Scheduler for z/OS is dependent on.

If you install a new release of Tivoli Workload Scheduler for z/OS in a new CSI, and the JES usermod is already installed in the same CSI as a previous release, follow these steps:

  1. Apply any necessary tolerance PTFs so that the previous release can run with the new exit code.
  2. Change the DDDEFs for JES so that they point to the SEQQSAMP and SEQQMAC0 libraries of the new release.
  3. APPLY REDO the JES usermod. This reassembles the exits with the new code.

The sample exits all use the EQQEXIT macro to create event-generating code. For more information on the EQQEXIT macro, see Appendix C. Invoking the EQQEXIT macro.

Table 21 describes the samples that you can use to generate and install the exits. The sample exit, skeleton JCL, and usermod entries identify members of the SEQQSAMP library. The event types in the table are prefixed with A for JES2 or B for JES3, when they are created by the exit. (SeeVerifying tracking events for more information about event types.)

Table 21. Sample exits for Tivoli Workload Scheduler for z/OS
Exit name Exit type Sample exit Sample JCL/ usermod Event supported Event type
IEFACTRT SMF EQQACTR1 EQQSMF Job and step completion 3J,3S
IEFUJI SMF EQQUJI1 EQQSMF Job start 2
IEFU83 SMF EQQU831 EQQSMF End of print group, purge (JES3 only), data set triggering support, and automatic change support 4,5,S,T
EXIT7 JES2 EQQXIT74 EQQJES2/ EQQJES2U JCT I/O exit for JES2, purge 1,3P,5
EXIT51 JES2 EQQXIT51 EQQJES21/ EQQJES2V JES2 QMOD phase change exit, z/OS® 1.7 and later 1
IATUX19 JES3 EQQUX191 EQQJES3/ EQQJES3U Output processing complete 3P
IATUX29 JES3 EQQUX291 EQQJES3/ EQQJES3U On job queue 1