JCL Exit

A JCL Exit is a module that you can use to modify a generated Job before it is submitted to the internal reader. Usually, when you create a z/OS Job in the AE and start it, the generated Job is sent to the z/OS Agent which completes it and executes it in the target system. However, when you use a JCL Exit, the Agent calls this specific module before it executes the Job. As a result, you can change the JCL in z/OS subsequently. You can add, change, or evaluate JCL lines, thereby preventing the start of particular programs, for example.

This page includes the following:

You can either create the JCL Exit module in Assembler code or C programming language. The Agent only loads one JCL Exit module.

The supplied image contains a folder for z/OS Agents. It includes a sample module in the uc4jcle.asm file (Assembler) which inserts comment lines. It also contains a description of how you can assemble this module.

Note: You can individually activate the JCL Exit module for each z/OS Agent. The module is loaded when the Agent starts.

Configuring the C Module (default)

The Agent always uses the C-based JCL Exit module provided that is has been specified.
Enter the name of your JCL Exit module and the various functions in the INI file of the z/OS Agent. Use the following parameters:

(JCL-Exit)

ExitModul=Module name

ExitFunction=ExitFunction name

InitFunction=InitFunction name (optional)

CloseFunction=CloseFunction name (optional)

Restart the Agent

Configuring the Assembler Module

This module is used when you did not specify the C-based JCL Exit.
Enter the name of your JCL Exit module in the INI file of the z/OS Agent and specify the size of the output range.

(JCL-Exit)
name=Module name
maxJclRecords=1000

Copy this module either to the AE load library or add the STEPLIB definition for the Agent to the library with the JCL Exit.
Restart the Agent, the module starts automatically with it.