CA JCLCheck Runtime Options › Description of Runtime Options › CNTLOVER

CNTLOVER

The CNTLOVER runtime option lets you specify a control card override library. This runtime option is mutually exclusive with the CNTLOVDD runtime option.

This option has the following format:

CNTLOVER(library[,C])|NOCNTLER

library

Specifies the data set name of a control card override library. CA JCLCheck allocates the specified data set.

C

Indicates to issue an information message and continue validation processing when the library is not found.

Usage notes:

• You can specify multiple CNTLOVER options; the libraries are concatenated in the order they are specified.
• The libraries must be cataloged PDS or PDSE libraries.
• The CNTLOVER runtime option must be used with CTLSCAN.
• When the control card member is not found in the CNTLOVER concatenation, the library member referenced in the utility CONTROL CARD DD is used.
• When the utility CONTROL CARD DD statement in the JCL being checked does not point to a PDS member, the feature is not activated for that DD statement.
• When the control card member is validated from an override library, a message informs you of the library the control cards came from.

Example: Bypass a Missing DSN

In this example, CA JCLCheck attempts to locate TEST.CNTLCRDS. If the library is not found, CA JCLCheck displays an information message and validation processing continues.

CNTLOVER(TEST.CNTLCRDS,C)

Example: Specify the CNTLOVER Runtime Option under EDCHEK

When running CA JCLCheck under EDCHEK, you have the flexibility to specify the CNTLOVER runtime option in one of two places:

• You can specify %EJCK CNTLOVER(library) on the ISPF EDIT command line.
• You can specify the CNTLOVER runtime option in the EDCHEKDD file as follows:

  EDCHEK PROC(PROC00)               - 
         LIST(EDCPRINT)             -
         CNTLOVER(QA.CNTL.CARDS)    -
         CNTLOVER(TEST.CNTLCRDS,C)  -
         CNTLOVER(DEVL.CNTL.CARDS) 
  ALLOC FI(PROC00)   DA(SYS1.PROCLIB)   
  ALLOC FI(*)        DA(SYS2.PROCLIB)   
  ALLOC FI(*)        DA(USER.PROCLIB)   
         GO   
  

Example: Specify the CNTLOVER Runtime Option in Batch

This example shows how to specify the CNTLOVER runtime option in a batch job. Before CA JCLCheck validates the IDCAMS SYSIN DD data set PROD.CNTL.CARDS(PRDCARDS), CA JCLCheck looks for the PRDCARDS member in each library of the override concatenation and uses the first one found for CA JCLCheck validation. If not found in any of these libraries, the PROD.CNTL.CARDS library member PRDCARDS is used for CA JCLCheck validation.

//USERID1J JOB  '1234','DEVELOPER',MSGLEVEL=(1,1),CLASS=A,  
//         MSGCLASS=X,REGION=0M,COND=(0,LT),NOTIFY=&SYSUID
//JCLCHECK EXEC PGM=JCLCHECK,PARM='OPTIONS(JCLOPTS)',COND=(0,LT) 
//STEPLIB  DD   DSN=FID.JCK.CAILOAD,DISP=SHR  
//         DD   DSN=FID.JCK.CAIPLD,DISP=SHR  
//SYSTERM  DD   SYSOUT=* 
//SYSPRINT DD   SYSOUT=* 
//SYSUDUMP DD   SYSOUT=* 
//SYSPROC  DD   DSN=SYS1.PROCLIB,DISP=SHR 
//SYSIN    DD   DATA,DLM=FF
//IDCAMSTP EXEC PGM=IDCAMS
//SYSIN    DD   DISP=SHR,DSN=PROD.CNTL.CARDS(PRDCARDS)
//SYSPRINT DD   SYSOUT=*
FF
//JCLOPTS  DD   *
 CNTLOVER(QA.CNTL.CARDS)
 CNTLOVER(TEST.CNTL.CARDS) 
 CNTLOVER(DEVL.CNTL.CARDS)
 CTLSCAN  LIST
//

Note: For information about using the CNTLOVER runtime option in ISPF, see the Control Card Override Panel (JCK12).