JCLCheck displays control cards for IBM utilities in Report 2 and can recognize the required DD names. This article provides an example on how to add a user program to the JCLCheck Utility Program Table so the user program's control statements are displayed, and required DD statements are checked.
Release: 12.0
Component: JCLCheck Workload Automation
1. Edit Usermod MZ2C025 from the JCLCheck CAZ2JCL library. Add the following to ++SRCUPD:
./ CHANGE NAME=JCLUPT
* JCLUPT - JCLCHECK UTILITY PROGRAM TABLE. THIS NON-EXECUTABLE **00470001
$UPT INHSUTIL, Your in house program -00470002
CTL=SYSIN, -00470003
REQ=(SYSPRINT,SYSOUT) 00470004
./ ENDUP
The above statements update the programs table JCLUPT from the CAZ2SRC library. The new user utility program is "INHSUTIL". SYSIN is the DD name for the control statement(s) that will be displayed. SYSPRINT and SYSOUT are the required DD names.
Note: Macro name $UPT must begin in column 10. INHSUTIL, CTL, and REQ must begin in column 16. Continuation character is in column 72, and sequence numbers begin in column 73.
2. Submit Usermod MZ2C025 to RECEIVE and APPLY the change.
To list the control cards, use JCLCheck runtime options "CCLIST(nnn)", where nnn is from 1-999.
If a required DD name is not provided in the JCL, JCLCheck issues an error message such as "CAY6119E DD STATEMENT 'SYSPRINT' IS REQUIRED BY PROGRAM 'INHSUTIL' BUT WAS NOT PROVIDED".