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:
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.
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:
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.
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.
CA TLMS Volume Master File (VMF).
Required if CA TLMS support is installed and you select the CA TLMS support option.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Accesses the CA JCLCheck Standards Rules database.
This DD statement specifies the data set name for the database.
Optional.
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.
Points to the REXX EXEC library used with the STDREXX option.
Optional.
Provides a SYSOUT data set to contain any diagnostic information due to abnormal termination or use of the CA JCLCheck DEBUG option.
Optional.
Copyright © 2014 CA.
All rights reserved.
|
|