Previous Topic: Condition Code TestingNext Topic: Nonexecutable Jobs


JCL Overrides for Jobs

Use the override library for one-time JCL changes. Use alternate libraries for JCL changes that you require for more than one run.

Using CA7ONL can accomplish JCL overrides in various ways. We recommend using the override library (INDEX=254) for one time JCL changes. To make one-time changes, save the required JCL to the override library and set the USE-OVRD-LIB on the DB.1 panel to Y. This field is automatically set to Y when you save the JCL to the override library using the DB.7 (JCL Edit) panel in CA7ONL. When the job next comes into the queue, the following occur:

The special override library accommodates one-time overrides only, and the temporary member is deleted after only one execution of the job. If you want to have an override that is kept after the job completes (not use the INDEX 254 library), you can set up alternate JCL libraries. Using alternate JCL libraries enables the user to place temporary JCL in a staging-type of library for use in more than a single execution of a job.

Various # statements added to JCL can change the processing of a job or queue characteristics. You can hold the job (#HLD), set it nonexecutable (#NOX), or set it not to trigger (#NTR) and many other settings. Using the override library can be beneficial when using any of the special # statements so that the update is used only once.

You can also use #J or #X statements in the JCL for inclusion or exclusion of JCL statements or other # statements. Using the #J or #X statements for inclusion or exclusion of statements in the JCL gives the flexibility of doing the inclusion or exclusion on a date/time, time, or SCHID basis.

Business Value:

This best practice helps ensure automated JCL substitutions or changes.

Additional Considerations:

If you want a job to be nonexecutable every day that it schedules into the queue if it is between the hours of 0800 and 1400, add the following in the JCL of the job:

#JI,OB=1400,OA=0800,CV=CU
#NOX
#JEND

The OB and OA are verified against clock time for the beginning time and ending time to mark the job nonexecutable in the queue.

If you want the job to be nonexecutable only when it runs under SCHID 20, add the following in the JCL of the job:

#JI,ID=020
#NOX
#JEND

The #J statements are examined and action taken by CA7ONL at the time that a job is scheduled into the request queue. CA7ONL examines the #X statements and acts at the time a job is submitted to JES. Certain things are only set with the #J statements because these things must occur as the job is entering the queue (such as the #HLD statement). The position within the JCL of the special # statements (not including the #J or #X) is not important, but we recommend placing them right after the JOB statement. This placement makes them easier to see.

If you have JCL substitutions that are required consistently for jobs to process correctly, look into using either CA Driver or global variables (or perhaps both).

More Information:

For more information about # statements, see the Database Maintenance Guide.

More information:

CA Driver or Global Variables