Understanding the Execution JCL

18.1
This article provides information on the JCL that executes the
CA Endevor
Inventory Analyzer tool.
JCL to Execute the Inventory Analyzer
This sample shows the JCL required to execute the Inventory Analyzer:
//*(JOBCARD) //*-------------------------------------------------------------------* //* * //* COPYRIGHT (C) 2007 CA. ALL RIGHTS RESERVED. * //* * //* NAME: BC1JANLZ * //* * //* SAMPLE JCL THAT WILL RUN THE ANALYSIS UTILITY * //*-------------------------------------------------------------------* // INCLUDE [email protected] //ANLZJCL EXEC PGM=NDVRC1,PARM=('C1BM7000SOURCE OPTIONAL') // INCLUDE [email protected] //SYMDUMP DD DUMMY //SYSUDUMP DD SYSOUT=* //C1MSGS1 DD SYSOUT=* //C1SUMARY DD SYSOUT=* //BSTIPT01 DD * (PLACE INPUT HERE) //BSTRULES DD DISP=SHR,DSN=&[email protected]&[email protected](DEFINES) // DD DISP=SHR,DSN=&[email protected]&[email protected](NODBMS) // DD DISP=SHR,DSN=&[email protected]&[email protected](DB2DBMS) // DD DISP=SHR,DSN=&[email protected]&[email protected](IDMSDBMS) // DD DISP=SHR,DSN=&[email protected]&[email protected](IMSDBMS) // DD DISP=SHR,DSN=&[email protected]&[email protected](TOTALDBM) // DD DISP=SHR,DSN=&[email protected]&[email protected](OTHERS) //BSTMODEL DD DISP=SHR,DSN=&[email protected]&[email protected](MODEL) //LOADSCL DD DSN=&[email protected]&[email protected],DISP=(,CATLG,DELETE), // UNIT=&[email protected], // SPACE=(TRK,(5,5)), // DCB=(RECFM=FB,LRECL=80) //SYSUDUMP DD SYSOUT=*
How to Override the DDnames
An optional parameter resides in the JCL-PARM='PARM DATA'-. This parameter lets you override the DDnames initially assigned to the input and report files.
Specify data in the parameter as follows:
►►──¤───┬────────────────────────────────────┬──¤──.──────────────────────────────────────────────►◄ ├──SOUrce OPTional───────────────────┤ └─┬─┬─MESsage─┬─┬──DDName──=──ddname─┘ │ └─MSG─────┘ │ ├─MODel───────┤ ├─REQuest─────┤ ├─RULes───────┤ └─SUMmary─────┘
This list explains the parameter fields:
  • SOURCE OPTIONAL
    Indicates to the Inventory Analyzer that the FROM clause may be omitted from an ANALYZE request. When the FROM clause is omitted, the USING clause must be specified. The analysis proceeds based entirely on the members found in the USING data sets. Any WHEN clauses (in the rules) that require source to be scanned are considered FALSE.
  • DDnames
    Each of the five regular input and output data set DDnames can be customized using the PARM= field. The DDnames defined within the output models, however, cannot be changed using this field.
This table lists the default DDname and description for each parameter:
Parameter
Input/ Output
Default DDname
Description
REQUEST
Input
BSTIPT01
Analysis requests (You provide this data.)
RULES
Input
BSTRULES
Rule definitions (You can customize this parameter for type and processor group.)
MODEL
Input
BSTMODEL
Output model definitions (You customize this parameter for output format.)
MESSAGES (MSG)
Output
C1MSGS1
Execution Reports
SUMMARY
Output
C1SUMARY
Summary Reports
How the Program Parameter Works
This example illustrates how the program parameter works. In this example, assume that you code the following parameter:
PARM='MSG DDN=C1MSGS2 REQ=BSTIPT02'
This parameter specifies the following information:
  • The analysis requests is read from DDname BSTIPT02.
  • The Execution Reports is written to DDname C1MSGS2.
  • The rule definitions is read from DDname BSTRULES.
  • The output model definitions are read from DDname BSTMODEL.
  • The output Summary Reports are written to DDname C1SUMARY.
You supply the first two DDnames in the parameter. The remaining DDnames are the default values.