Step 5. Adding SMF and JES exits for event tracking
Perform this task if you are installing a tracker.
HCL Workload Automation for Z 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 HCL Workload Automation for Z.
To simplify the installation of HCL Workload Automation for Z 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 HCL Workload Automation for Z is dependent on.
- Apply any necessary tolerance PTFs so that the previous release can run with the new exit code.
- Change the DDDEFs for JES so that they point to the SEQQSAMP and SEQQMAC0 libraries of the new release.
- 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 Invoking the EQQEXIT macro.
Sample exits for HCL Workload Automation for Z 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.)
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 | 1 |
IATUX19 | JES3 | EQQUX191 | EQQJES3/ EQQJES3U | Output processing complete | 3P |
IATUX29 | JES3 | EQQUX291 | EQQJES3/ EQQJES3U | On job queue | 1 |