Previous Topic

Next Topic

Book Contents

Book Index

General Information for OVERLIB

The OVERLIB parameter enables submission of a modified copy of the actual JCL of the job, without changes to either the regular JCL (in the MEMLIB library) or the job scheduling definition.

The library containing the regular JCL member of the job is specified in the MEMLIB parameter. When temporary changes are desired, the JCL member can be copied to the library specified in the OVERLIB field and modified as needed.

Note: General Information for OVERLIB

If the MEMNAME member is found in the OVERLIB JCL library, that member is used. Otherwise, the member is taken from the MEMLIB library.

When the job is scheduled, the OVERLIB field is scanned. If it is not empty, Control-M resolves AutoEdit variables in the field, if any are specified, and then searches the OVERLIB library for the member specified in field MEMNAME.

The override can be canceled by deleting the MEMNAME member from the OVERLIB library. If the MEMNAME member is not found in the OVERLIB library, the member is taken from the MEMLIB library. Alternatively, the override can be canceled by deleting the OVERLIB specification from the job scheduling definition.

Note: OVERLIB cannot be specified for a started task.

The library can be any cataloged, standard partitioned data set, LIBRARIAN or PANVALET. The record length must be 80.

GENERAL or USER=name, which are valid MEMLIB values, cannot be specified in field OVERLIB.

The library and the member do not have to exist when the OVERLIB parameter is defined. Their existence is checked by Control-M before actual submission of the job.

If, during the access to a library by Control-M (before submission) the library is held exclusively by another user (such as TSO user, job), the monitor re-tries to access the library every few seconds until the library is released and the job can be submitted.

Use of the library name DUMMY is intended for scheduling events (for example, adding a prerequisite condition without actually running the job). If the library name DUMMY is used, the job is not submitted (submission and sysout checking is skipped). The job is assumed to have ended OK; ON PGMST...DO processing is not performed. All Post-processing parameters associated with an ENDED OK status are activated (OUT, SHOUT WHEN OK, and so on).

Three optional functions that were performed by the CTMX015C and CTMX015O exits in previous versions are now incorporated into the Control-M monitor. These functions are controlled by the following installation parameters, with one exception. Jobs using DDNAME= in the MEMLIB field still require the exit CTMX015C:

For a description of these parameters, see the chapter that discusses customizing INCONTROL products in the INCONTROL for z/OS Installation Guide.

Parent Topic

OVERLIB: General Job Parameter