JCLCheck has two runtime options to provide an alternate location for control cards validation.
This Knowledge Document describes the runtime options and how to use them.
Component: JCLCheck Workload Automation
The runtime options are CNTLOVER(data.set.name) and CNTLOVDD(ddname).
CNTLOVER(data.set.name) - When this option is used, utility control statements are read and validated from the specified data set. This dataset is dynamically allocated by JCLCheck. If this data set is not found, the actual SYSIN DD data set coded in the JCL is referenced. Multiple CNTLOVER statements can be specified and are concatenated in the order they are specified.
CNTLOVDD(ddname) - When this option is used, utility control statements are read and are validated from the override library that is allocated under the specified DDname.
Below is a sample JCL to be validated, and how these runtime options work:
//STEP1 EXEC PGM=IDCAMS
//SYSPRINT DD SYSOUT=*
//SYSIN DD DISP=SHR,DSN=PROD.CNTL.CARDS(DEFINE)
(Option CNTLOVER and CNTLOVDD are activated only if SYSIN points to a PDS member.)
- Example 1: Option CNTLOVER(TEST.CNTL.CARDS) and CTLSCAN are specified.
JCLCheck searches "TEST.CNTL.CARDS" for member named DEFINE. If not found, "PROD.CNTL.CARDS" is searched.
- Example 2: Option CNTLOVDD(MYCTL) and CTLSCAN are specified.
The JCLCheck job has:
//MYCTL DD DISP=SHR,DSN=TEST.CNTL.CARDS
// DD DISP=SHR,DSN=QA.CNTL.CARDS
JCLCheck searches "TEST.CNTL.CARDS" for member named DEFINE. If not found, "QA.CNTL.CARDS" is searched. If not found, the library specified in the JCL which is "PROD.CNTL.CARDS" is searched.
When JCLCheck is used in ISPF Edit, or in ISPF FOREGROUND mode, DDname MYCTL must be pre-allocated.
When JCLCheck is used in ISPF Batch Submit mode:
1. The override libraries must be defined in CLIST JCKUSR (variable &CCODS1 through &CCODS8)
2. JCLCheck options panelid JCK0203 must have option CNTLOVER set to Y
3. JCLCheck Control Card Overrides panelid JCK12 must have CNTLOVDD set to a DDname.
All of the above will be populated to skeleton member JCKSKEL for the batch submission.
Reference: Control Card Override Panel (JCK12)
Member JCLUPT in the JCLCheck CAZ2SRC library provides the list of utilities that are syntax-checked, and validated.