JOB, EXEC and DD statements

The job stream to generate batch reports and extract data sets consists of the following:

JOB
Job Statement Information from the CICS PA Settings profile options.
PGM=CPAMAIN,PARM='parameter list'
Request CICS PA reporting with optional parameters:
UPPER
UPPER translates all report output to upper case. This parameter is generated if you specify YES for Reports in Upper Case in the CICS PA Settings profile options. The default is mixed case (UPPER not specified).
STEPLIB DD
This is the library containing the CICS PA modules. It is specified in CICS PA Load Library in the CICS PA Settings profile options.
CMDLIB DD
This is the optional CICS PA command library containing pre-coded batch commands which can be inserted in the SYSIN command stream using the COPY or INCLUDE command.
CPAHDBRG DD
This identifies the Repository data set. The Repository is a VSAM KSDS that is the repository for all definitions associated with an HDB. It is also the repository for shared system definitions and Application Groups. It is required for all HDB command requests, including Load, Report, Extract, and Take-up.
CPAHDBCD DD
This identifies the Repository container data sets. This DD is written in the context of an HDB load step and is expected to be read by a subsequent DB2 load step.
Start of changeCPAHDBDL DDEnd of change
Start of changeThis identifies the Repository container data sets. This DD is used in the context of a DB2 load step where the HDB container data sets are not required to be kept (that is, the data retention period is 0).End of change
CPAMANCD DD
This identifies the HDB manifest container data set. The manifest is a catalog of HDBs. It is used by the CICS PA plug-in. This DD is used in the context of a manifest build step.
MANB0001 DD
This DD is used in the context of a manifest build step. It lists the HDBs that were included in the manifest.
SYSPRINT DD
CICS PA message data set. This DD statement defines the file used by CICS PA for its messages and run time information. It must be specified and should be checked for error messages.
SYSIN DD
Command input. This DD statement contains the CICS PA commands.

The CICS PA dialog automatically builds these commands at job submission time, based on the reports and extracts activated in the Report Set.

Report Output Files DD
These DD statements define the report output files. These files are specified using the OUTPUT(ddname) operand.
If not specified, CICS PA assigns a default DDname xxxxnnnn where nnnn is a sequential number 0001-9999 to uniquely identify the report, and xxxx identifies the type of report:
LIST
Performance List report
LSTX
Performance List Extended report
SUMM
Performance Summary report
TOTL
Performance Totals report
WAIT
Wait Analysis report
PROF
Transaction Profiling report
CROS
Cross-System Work report
TRGP
Transaction Group report
CBTS
BTS report
WKLD
Workload Activity report
TTLS
Transaction Tracking List
TTSU
Transaction Tracking Summary
XLST
Exception List report
XSUM
Exception Summary report
FILE
File Usage Summary report
TEMP
Temporary Storage Usage Summary report
DPLS
Distributed Program Link Usage Summary report
RESU
Transaction Resource Usage List report
STAL
Statistics Alert reports
Start of changeSTTGEnd of change
Start of changeCICS® Transaction Gateway Statistics reportsEnd of change
DB2R
DB2 report
MQ00
WebSphere MQ report
OMEG
OMEGAMON reports
LOGR
System Logger report
GRTE
Transaction Rate graph report
GRSP
Transaction Response Time graph report
CROX
Cross-System Work Extract Recap report
EXPT
Performance Data Extract Recap report
RSEL
Record Selection Extract Recap report
HDBL
HDB Load Recap report
LOEX
System Logger Extract Recap report
STEX
Statistics Extract Recap report

For example, if two LIST reports were requested without the OUTPUT operand specified, CICS PA writes the output to files with ddnames LIST0001 and LIST0002.

If a Report Output File is not specified in the JCL, CICS PA will dynamically allocate it with the same attributes as SYSPRINT, regardless of whether the OUTPUT operand was specified or not.

CPAOxxxx DD
Extract output data sets. These DD statements define the Extract Data Sets. The Extract Output Files are specified using the DDNAME(ddname) operand. CICS PA will accept any ddname via the DDNAME operand; it need not be prefixed by CPAO. However, if the DDNAME operand is omitted, CICS PA expects that the default Extract Output ddname is specified in the JCL. See Table 1 for the default ddname for each type of Extract.
The CICS PA dialog automatically generates the DD statements at Report Set run time. When generating the JCL, CICS PA assigns a default ddname CPAOxxnn where nn is a sequential number 01-99 to ensure ddnames are unique, and xx indicates the type of extract data set:
XS
Cross-System Work Extract data set
EX
Performance Data Extract data set
RS
Record Selection Extract data set
LE
System Logger Extract data set

If the extract data set is not cataloged, CICS PA uses the allocation details specified for Extract Data Sets in the Reporting Allocation Settings profile options. If the data set is already cataloged, CICS PA uses DISP=MOD or DISP=OLD to either append or overwrite the data set contents according to your specification on the Extract panel. Alternatively, you can use a GDG to create a new data set each time the Extract is run.

SMFINnnn DD
SMF data set. These DD statements define the SMF data sets to be processed by CICS PA. CICSPA commands refer to these DD statements via the INPUT operand (see INput). This determines which SMF Files are processed by the reports.

The CICS PA dialog automatically generates these DD statements at job submission time, based on the CICS APPLIDs selected for reporting and their associated SMF Files.

SMF File ddnames need not be prefixed by SMFIN. CICS PA will accept any ddname via the INPUT operand.

CPADICTR DD
Dictionary data set. These DD statements define the data sets which contain Dictionary records. It is only required if you want to include User Fields in your reporting.

Usually, the SMF File contains a Dictionary record to define the format of its performance records. If the Dictionary record is missing from the file, CICS PA will look in the CPADICTR data sets to find a Dictionary record for the particular CICS system (APPLID or APPLID/MVS) so report processing can proceed. If not present, CICS PA will use the default Dictionary record for the CICS system being processed.


Information Information

Feedback


Timestamp icon Last updated: Friday, 8 February 2013


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic//cpaug151.htm