Previous Topic: Invoking with the Batch FacilityNext Topic: Cataloged Procedure


Required Execution JCL

To invoke CA JCLCheck, member AZ1JCHK in CAZ2JCL is supplied. This member executes the JCLCHECK procedure that is located in CAZ2PROC or CAZ2OPTN CAZ1JCHK. AZ1JCHK also submits the JCL you want CA JCLCheck to analyze. Enter the JCL you want CA JCLCheck to analyze between the DLM=$$ and $$ as shown in the following example:

//AZ1JCHK JOB ...
//Z1EXJCHK  EXEC CAZ1JCHK,
//             DSNQUAL='CAI',
//             DSNLOAD='CAILOAD',
//             OPTION='O(OPTS)'
//OPTS   DD  *
/*
//SYSIN  DD  DATA,DLM=$$
  (JCL to analyze)
$$

Note: Within this member, you see comments explaining how to process partitioned data sets and library files.

CAZ1JCHK looks like the following example (without the commented statements):

//CAZ1JCHK  PROC  DSNQUAL='CAI',
//            DSNLOAD='CAILOAD',
//            GOUT='*',
//            OPTION=''
//JCLCHECK  EXEC  PGM=JCLCHECK,PARM='&OPTION'.,REGION=0K
//STEPLIB   DD  DSN=&DSNQUAL..&DSNLOAD.,     JCLCHECK LOAD LIBRARY
//          DISP=SHR
//SYSTERM   DD  SYSOUT=*                     TERMINAL ERROR REPORT
//SYSPRINT  DD  SYSOUT=*                     REPORTS 1-9 AND 11
//SYSTSPRT  DD  SYSOUT=*                     REXX OUTPUT
//SYSGRAPH  DD  SYSOUT=&GOUT.,DCB=RECFM=FBA  GRAPH REPORT
//SYSMDUMP  DD  SYSOUT=*                     DIAGNOSTICS DATA
//SYSPROC   DD  DSN=SYS1.PROCLIB,DISP=SHR        <==================*//
//SYSRDR    DD  SYSOUT=(A,INTRDR),DCB=BUFNO=1    <==================*//

You can edit this member based on the following DD statement descriptions. In addition, you must customize the CA JCLCheck procedure JCL for your site.

Note: If you use the AUTOPROC option, it is not necessary to maintain PROCLIB allocation information in the CA JCLCheck cataloged procedures, CLIST, or SUBCHEK/EDCHEK control files. For more information, see CA JCLCheck Runtime Options.

To invoke CA JCLCheck, use the following EXEC statements:

EXEC

Statement that calls the JCLCHECK program and supplies all the PARM requirements.

For a complete description of all the PARM options available, see CA JCLCheck Runtime Options.

Required.

STEPLIB

Statement that points to the JCLCHECK load library to call the JCLCHECK procedure.

Required if it is not set up in the linklist.

Use the following list of required and optional DD statements when you invoke CA JCLCheck:

SYSPRINT

File that receives the CA JCLCheck reports.

The files logical record length is 133 and it can be blocked. To change the ddname of this file, use the LIST option.

Required unless you specify PARM=NOLIST, or the NOLIST option in the options file.

SYSPROC

Statement that points to the procedure library that CA JCLCheck uses to resolve references to cataloged procedures.

If you have more than one procedure library, you can concatenate other data sets on DD statements to this one. To change the ddname of this file, use the PROC option. Specify the same procedure libraries for this file as you have specified in your JES procedure. Generally, the ddname is PROC00 for JES2 and IATPLBST for JES3.

Required unless you are using AUTOPROC.

CAIVMFI

CA TLMS Volume Master File (VMF).

Required if CA TLMS support is installed and you select the CA TLMS support option.

PROCnn

Provides CA JCLCheck support for the PROCLIB parameter of the JES2 /*JOBPARM control statement and JCLLIB JCL statement.

Required unless you are using AUTOPROC.

You should add the PROCLIB allocation statements from the JES2 procedure to the JCL which executes CA JCLCheck.

Do not use with AUTOPROC.

IATPLBnn

Provides CA JCLCheck support for the PROC= parameter of the JES3 //*MAIN control statement.

If you want support, add the alternate PROCLIB allocation statements from your JES3 procedure to the JCL which executes CA JCLCheck.

Optional.

JCHKFREE

Marks the beginning of the sequence of DD statements that describe the data sets that you want CA JCLCheck to dequeue under CA Roscoe.

Optional unless you specify PARM=DEQUE.

JENDFREE

Specifies the end of the sequence of DD statements that you want CA JCLCheck to free under CA Roscoe.

Optional unless you specify PARM=DEQUE.

SYSGRAPH

Receives the Flow Diagram Report (Report #10).

The default ddname is SYSGRAPH. You can specify another ddname by using the GRAPH option. The default and minimum possible value for LRECL is 133.

Optional unless you specify PARM=GRAPH.

COBLIB

Describes a load library that can contain a CA JCLCheck COBOL exit routine; use with the COBEXIT option.

When you include this statement, CA JCLCheck loads the COBOL exit program named in the COBEXIT option from this library. Use this statement to facilitate development and testing of COBOL exit programs.

Note: For information about the COBOL exits, see the Programming Guide.

Optional.

SYSDICT

Accesses the CA APCDOC Cross-Reference database.

The SYSDICT DD statement specifies the cluster data set name for this database.

Required if you install the CA APCDOC interface at Version 1.0. For Version 1.1 and above, use the DBHLQ runtime option to dynamically allocate the database.

SYSDICT1

Accesses the CA APCDOC Cross-Reference database.

The SYSDICT1 DD statement specifies the path name for the Cross-Reference database.

Required if you install the CA APCDOC interface at Version 1.0. For Version 1.1 and above, use the DBHLQ runtime option to dynamically allocate the database.

SYSTERM

Contains the terminal report file.

The logical record length of this file is 80 and the file can be blocked. You can change the ddname of this file with the Term option discussed in CA JCLCheck Runtime Options.

Optional unless you specify PARM=TERM.

SYSRDR

Defines the destination for error-free job streams.

JES2 automatically processes these jobs if the statement is coded as shown on the previous page. CA JCLCheck writes the JCL for jobs containing errors to the point of the error, then terminates with a JES2 /*PURGE (or HASP /*DEL) control statement.

Optional unless you specify PARM=SUBMIT.

SYSDDxxx

Performs for the dynamic allocation of data sets required by the CTLSCAN, EASYPROC, or PXREF options in non-z/OS systems.

When using any of these options, you should add a SYSDDxxx DD statement for every volume that contains a control statement data set (for CTLSCAN), a private procedure library (for EASYPROC), or a program library (PXREF). In practice, it is probably best to include a volume allocation DD statement for every resident or reserved volume in the installation, as part of a standard CA JCLCheck procedure. You can change the ddname prefix on these DD statements with the PREFIX option.

Optional in non-z/OS and not used in z/OS.

SYSIN

Points to the JCL stream that you want CA JCLCheck to analyze.

CA JCLCheck also requires the DLM parameter if an input stream data set contains any statements beginning with "/*" (such as JES2 control statements). This data set is one of the following: a card image file, a partitioned data set (with the PDS option), a CA Panvalet library (with the Panvalet option), or a CA Librarian library (with the Librarian option).

You can change the ddname of this file with the Input option discussed in CA JCLCheck Runtime Options.

Note: SYSIN requires an LRECL of 80.

Required.

STDRULE

Accesses the CA JCLCheck Standards Rules database.

This DD statement specifies the data set name for the database.

Optional.

SYSTSPRT

Receives the REXX error messages and output from REXX commands, use with the STDREXX option.

Its logical record length is 133 and it can be blocked. The ddname may be different if your site has changed the REXX installation defaults.

Optional.

SYSEXEC

Points to the REXX EXEC library used with the STDREXX option.

Optional.

SYSMDUMP

Provides a SYSOUT data set to contain any diagnostic information due to abnormal termination or use of the CA JCLCheck DEBUG option.

Optional.