How to resolve ESP variables when running JCLCheck batch
Article ID: 126321
Updated On:
Products
Issue/Introduction
The JCLCheck RESOLVE option allows for external variables that are imbedded in the JCL for a scheduling product to be resolved before the JCL is validated. The following scheduling products are supported:
CA 7
Workload Automation ESP
IBM Tivoli Workload Scheduler (TWS)
BMC Control-M
The JCLCheck RESOLVE option may be used from the following:
1. From an ISPF Edit session when EJCK is executed.
2. From the JCLCheck ISPF panel interface (JCKSPF).
3. From a JCLCheck batch job.
This article explains how to use the JCLCheck RESOLVE option when invoking JCLCheck in batch mode.
Without the JCLCheck RESOLVE option, external variables won't be resolved, and will result in errors when the JCL is validated by JCLCheck.
Environment
JCLCheck release 12.0
ESP release 11.4 and higher
Resolution
Requirement:
A pre-defined sequential file or a PDS member containing ESP parameters. In this article, the sample data set name is 'PUBLIC.ESPWA.RESOLVE' and contains the following parameters:
SUBSYS=espm <== The active ESP subsystem name
SYMBOL=% <== The ESP symbol-introducer character
EVENT=cyber.payroll <== The name of the ESP event which has job (JCL) to be validated
PROCJOB=TESTJCK <== JCL member being validated by JCLCheck
Sample job using the JCLCheck RESOLVE option:
// JOB statement
//CAZ1JCES PROC CAILOAD='jclcheck.caz2load',
// ESPLOAD='esp.cd7yload',
// JCLLIB='jcl.library',
// OPTION='AU', JCLCHECK RUNTIME OPTIONS
// RESPARM='RESOLVE(ESP,DDNAME:RESPARMS),JOBNAME(testjck)',
// JOBNAME='testjck'
//*
//**********************************************************************//
//* This step executes CAZ1PRES to resolve the ESP JCL *//
//**********************************************************************//
//STEP1 EXEC PGM=CAZ1PRES, PARM='&RESPARM'
//STEPLIB DD DISP=SHR,DSN=&CAILOAD JCLCHECK LOAD LIBRARY
// DD DISP=SHR,DSN=&ESPLOAD ESP LOAD LIBRARY
//RESJCL DD DSN=&&RESJCL,DISP=(NEW,PASS,DELETE), RESOLVED JCL
// SPACE=(CYL,(10,10),RLSE),
// UNIT=SYSDA,DCB=(RECFM=FB,DSORG=PS,LRECL=80)
//RESPARMS DD DISP=SHR,DSN=PUBLIC.ESPWA.RESOLVE ESP PARAMETERS FILE
//JCKPRINT DD SYSOUT=*
//SYSIN DD DISP=SHR,DSN=&JCLLIB(&JOBNAME) INPUT JCL MEMBER
//*
//*******************************************************************//
//* This step executes JCLCheck *//
//*******************************************************************//
//STEP2 EXEC PGM=JCLCHECK,COND=(4,LT,RESOLVE),REGION=0K,
// PARM='&OPTION'
//STEPLIB DD DISP=SHR,DSN=&CAILOAD, JCLCHECK LOAD LIBRARY
//SYSPRINT DD SYSOUT=*
//SYSIN DD DSN=&&RESJCL,DISP=(OLD,DELETE,DELETE)
// PEND
//RESOLVE EXEC CAZ1JCES
Note: Sample JCL procedure CAZ1JCES is located in the JCLCheck CAZ2PROC library.
Additional Information
Recommended Readings:
- Configure JCLCheck to Resolve External Variables:
https://techdocs.broadcom.com/us/en/ca-mainframe-software/automation/ca-jclcheck-workload-automation/12-0/using/resolve-external-variables/configure-ca-jclcheck-to-resolve-external-variables.html
- Specify ESP Parameters
https://techdocs.broadcom.com/us/en/ca-mainframe-software/automation/ca-jclcheck-workload-automation/12-0/using/resolve-external-variables/specify-ca-wa-esp-edition-parameters.html
- RESOLVE processing option:
https://techdocs.broadcom.com/us/en/ca-mainframe-software/automation/ca-jclcheck-workload-automation/12-0/reference/jclcheck-runtime-options/description-of-runtime-options/resolve.html
Feedback
