How to resolve CA WA ESP variables when running the CA JCLCheck ISPF panel interface JCKSPF

Document ID : KB000126437
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 the JCLCheck ISPF panels interface (JCKSPF).
2. From an ISPF Edit session when EJCK is executed.
3. From a JCLCheck batch job. 

This article explains how to use the CA JCLCheck RESOLVE option from the JCLCheck ISPF panels interface (clist JCKSPF).
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:
Requirements:

1.  Create an ESP parameter file.  This is a sequential file or a PDS member containing ESP parameters.  In this article, sequential data set name        'PUBLIC.ESPWA.RESOLVE' contains the following ESP 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 
 
     Reference: https://docops.ca.com/display/CJWA12/Specify+CA+WA+ESP+Edition+Parameters
 

2.  Modify Clist member JCKUSR from the CA JCLCheck CAZ2CLS0 library to set the JCLCheck and ESP load libraries.  Example: 
          SET &JCLOAD = &STR(hlq.JCLCHECK.CAZ2LOAD
          SET &JCLOAD1 = &STR(hlq.ESP.CD7YLOAD)  

     Bypass this step if both of the load libraries are in the linklist.

3.  Modify skeleton member JCKSKLES from the CA JCLCheck CAZ2SKL0 library as follows:
     . Comment out JCHKPLIB DD and the concatenated DD from stepname JCLCHECK if JCLCheck processing option AUTOPROC (or AU) is used. 
       If AUTOPROC (or AU) is not used, set JCHKPLIB DD to your procedure libraries.
    

Instructions:
  1. Select option number 0 (zero) on the CA JCLCheck™ Workload Automation ISPF main menu panel (panelid JCK0200).
  2. Select option number 1 on the Control Options Menu panel (panelid JCK0210).
  3. Specify a 'Y' in the 'Go to ADDITIONAL PROCESSING OPTIONS PANEL' field on the Process Control Options panel (panelid JCK0202).
  4. Specify ESP in the RESOLVE field on the Additional Processing Options panel (panelid JCK0203). 
  5. Return to the CA JCLCheck™ Workload Automation ISPF main menu panel (panelid JCK0200).   ESP is now defined for JCLCheck.
  6. Select option number 7 - RESOLVE - External Variable Resolution (panelid JCK0209).
  7. Fill in the required entries, and hit enter to begin the submission.   See Table 1 for an example of panel JCK0209.
  8. Select F (for Foreground) or B (for Batch) JCLCheck submission on the External Variable Resolution Submission panel (panelid  JCK0217).   
Note: 
- Foreground mode: The RESOLVE output is written to DDname JCKPRINT, dataset name 'prefix.CAZ1PRES.JCKPRINT' by default.  This dataset name is defined in Clist CAZ2CLS0(JCKSPFES).  
- Batch submit mode:  Uses skeleton member CAZ2SKL0(JCKSKLES).

Table 1: Panel JCK0209

JCK0209 ------ CA JCLCheck External Variable Specification - ESP --------------
COMMAND ===>                                                                   
DATE: 2019/02/01                   USER:                                              TIME: 17: 00 
SCAN or SIMULATE   ===> SIMULATE   (Required)                                  
ESP Subsystem Name ===> ESPM        SYMBOL ===>                                 
Input File    ===> PUBLIC.JCL.LIBRARY(TESTJCK)                                   
EVENT         ===> CYB.PAYROLL                                            
SCHED         ===>                                                             
SYMLIB        ===>                                                             
For SCAN only:                                                                 
  CALENDARS   ===>                                                             
For SIMULATE only: (EVENT and PROCJOB are Required)                            
  PROCJOB     ===> TESTJCK                                                     
  VARS        ===>                                                             
  USER1       ===>                                                             
  USER2       ===>                                                             
  USER3       ===>                                                             
  USER4       ===>                                                             
  JCLSCAN     ===>                Continue on another panel  ===> N  (Y/N)     
Resolve Parm File  ===> PUBLIC.ESPWA.RESOLVE                                  
RESJCL File Size   ===>       ===>       (Primary, Secondary Cylinders)        
Debugging Control  ===>                  (R-Record, S-RecordSeq, RS, or ' ')   
                                                                               
Update PROFILE with these options  ===> Y   Press Enter to continue     
      
                                                                               
 

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