HCL Workload Automation, Version 9.4

JES2 exits

This section provides details about adding the JES2 event tracking exits used by the agent for z/OS. However, if you have the agent for z/OS and IBM Workload Scheduler for z/OS tracker running on the same system, the JES2 exits are already installed.

The EELSAMP sample library contains a number of members that you can use to assemble and link-edit JES exits. EELJES2 and EELJES21 provide sample JCL to assemble and link-edit the JES2 exits. However, you are encouraged to use members EELJES2U and EELJES2V. These samples provide the JCL to install the JES2 exits as SMP/E usermods. The usermods are defined so that both the JES and the agent for z/OS target zones are informed of the dependencies. This ensures that future maintenance to either component (JES2 or the agent for z/OS) will be handled correctly.

The sample EELJER2V is provided to reject and restore the JES2 exits as SMP/E usermods, if needed.

The load modules of the JES2 exits, which are EXIT7 and EXIT51, are called TWSEXIT7 and TWSXIT51, and their entry points are called TWSENTR7 and TWSENT51, respectively.

The sample library member EELXIT74 contains the assembler source code of a JES2 JCT I/O exit, JESEXIT7. EELXIT74 is used for JES2. The agent for z/OS uses JESEXIT7 to detect new jobs on the internal reader and also to detect output group purge.

The sample library member EELXIT51 contains the assembler source code of the JES2 QMOD Phase Change exit, JES2 EXIT51. The agent for z/OS uses JES2 EXIT51 to detect job errors occurring during the JES2 input phase.

Include these records in the JES2 initialization member:

JES2 Initialization Statements

Add the following records to the JES2 initialization member:

Load agent for z/OS exit mod */
EXIT(7) ROUTINES=TWSENTR7,STATUS=ENABLED /*
Define EXIT7 entry point */

And also:

LOAD(TWSXIT51) /*
Load agent for z/OS exit mod */
EXIT(51) ROUTINES=TWSENT51,STATUS=ENABLED /*
Define EXIT51 entry point */

To dynamically install the JES2 exits, use these commands when the modules are available in the LNKLST:

$ADD LOADMOD(TWSEXIT7),STORAGE=PVT

$T EXIT(7),ROUTINES=TWSENTR7,
 STATUS=ENABLED

$ADD LOADMOD(TWSXIT51),STORAGE=PVT

$T EXIT(51),ROUTINES=TWSENT51,
 STATUS=ENABLED

To put a new version of an exit (that was previously installed) in place, use these commands when the modules are available in the LNKLST:

$TLOADMOD(TWSEXIT7),REFRESH 
$TLOADMOD(TWSXIT51),REFRESH

For more information about JES2 initialization statements, see JES2 Initialization and Tuning Reference.