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

book

Article ID: 126321

calendar_today

Updated On:

Products

CA JCLCheck Workload Automation

Issue/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.

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

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:  
 
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