CA JCLCheck option CNTLOVER or CNTLOVDD to search a different control card library.

Document ID : KB000044334
Last Modified Date : 14/02/2018
Show Technical Document Details


Introduction:

CA JCLCheck has a runtime option to provide an alternate location for control card validation for utilities that are syntax checked and validated.  The list of utilities are present in the CAZ2SRC library in member JCLUPT.


Instructions:

The runtime options that provide an alternate location for control card validation 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 CA 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 override library allocated under the specified ddname.

Here is a sample JCL to be validated and below will describe the instructions on how to setup for the use of CNTLOVER and CNTLVDD(ddname) options. 

//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 used

CA 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 used.
DDname[i] MYCTL must be allocated in the JCLCheck job as follows:

//MYCTL DD DISP=SHR,DSN=TEST.CNTL.CARDS
// DD DISP=SHR,DSN=QA.CNTL.CARDS

CA 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, the override libraries must be defined in the JCKUSR Clist so they get populated into skeleton member JCKSKEL.


As always, please contact CA Technologies support for CA JCLCheck Workload Automation if you have further questions.