How to resolve CA WA ESP variables when running CA JCLCheck batch

Document ID : KB000126321
Last Modified Date : 12/02/2019
Show Technical Document Details
Introduction:
The CA 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 Workload Automation SE (CA 7 Edition)
CA Workload Automation ESP 
IBM Tivoli Workload Scheduler (TWS)
BMC Control-M

The CA 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 CA JCLCheck RESOLVE option when invoking JCLCheck in batch mode.
Background:
Without the CA JCLCheck RESOLVE option, external variables won't be resolved, and will result in errors when the JCL is validated by JCLCheck.
Environment:
CA JCLCheck release 12.0 
CA WA ESP release 11.4 and release 12.0
Instructions:
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:  
 
COMMAND=SIMULATE
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

Reference: https://docops.ca.com/display/CJWA12/Specify+CA+WA+ESP+Edition+Parameters

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 CA JCLCheck to Resolve External Variables:
https://docops.ca.com/display/CJWA12/Configure+CA+JCLCheck+to+Resolve+External+Variables

- Specify CA WA ESP Edition Parameters
https://docops.ca.com/display/CJWA12/Specify+CA+WA+ESP+Edition+Parameters

- RESOLVE processing option:
https://docops.ca.com/display/CJWA12/RESOLVE