CA JCLCheck Runtime Options › Description of Runtime Options › CNTLOVDD

CNTLOVDD

The CNTLOVDD runtime option lets you specify the DDNAME of a pre-allocated set of control card override libraries. This runtime option is mutually exclusive with the CNTLOVER runtime option.

This option has the following format:

CNTLOVDD(ddname)|NOCNTLDD

ddname

Specifies the DDNAME of a pre-allocated set of control card override libraries. The control card override libraries have already been allocated under the DDNAME specified before CA JCLCheck is invoked.

Usage notes:

• All data sets in the CNTLOVDD concatenation must be DSORG=PO files (that is, PDS or PDSE). You can use simulated PDS files in the concatenation, for example, CA Librarian with SUBSYS=LAM.
• The CNTLOVDD runtime option must be used with CTLSCAN.
• When the control card member is not found in the CNTLOVDD 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: Specify the CNTLOVDD Runtime Option under EDCHEK

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

• You can pre-allocate the override concatenation using a private CLIST, REXX, or the TSO logon procedure, and then specify %EJCK CNTLOVDD(ddname) on the ISPF EDIT command line.
• You can also specify the CNTLOVDD option in the EDCHEKDD file. The following example shows how to use the CNTLOVDD option in the EDCHEKDD file:

  EDCHEK AUTOPROC                  - 
         LIST(EDCPRINT)            -
         CNTLOVDD(CNTLCRDS)
  ALLOC FI(CNTLCRDS)   DA(MY.CNTLCRDS)
         GO
  

Example: Specify the CNTLOVDD Runtime Option in Batch

This example shows how to specify the CNTLOVDD 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
//CNTLCRDS DD   DISP=SHR,DSN=QA.CNTL.CARDS
//         DD   DISP=SHR,DSN=TEST.CNTL.CARDS
//         DD   DISP=SHR,DSN=DEVL.CNTL.CARDS 
//SYSIN    DD   DATA,DLM=FF
//IDCAMSTP EXEC PGM=IDCAMS
//SYSIN    DD   DISP=SHR,DSN=PROD.CNTL.CARDS(PRDCARDS)
//SYSPRINT DD   SYSOUT=*
FF  
//JCLOPTS  DD   *  
 CNTLOVDD(CNTLCRDS) 
 CTLSCAN  LIST  
// 

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