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

Products

JCLCheck Workload Automation

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 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 JCLCheck RESOLVE option from the JCLCheck ISPF panels interface (clist JCKSPF).

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
Workload Automation ESP release 11.4 and higher

Resolution

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

2. Modify Clist member JCKUSR from the 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 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:

Select option 0 on the JCLCheck/SPF main menu (panelid JCK0200).
Select option 1 on the Control Options menu (panelid JCK0210).
Specify a 'Y' in the 'Go to ADDITIONAL PROCESSING OPTIONS PANEL' field on the Process Control Options panel (panelid JCK0202).
Specify ESP in the RESOLVE field on the Additional Processing Options panel (panelid JCK0203). ESP is now defined to JCLCheck.
Return to the JCLCheck/SPF main menu (panelid JCK0200).
Select option 7 - RESOLVE - External Variable Resolution (panelid JCK0209).
Fill in the required entries, and hit enter to begin the submission. See Table 1 for an example.
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: 2023/05/23 USER: TIME: 15:23
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