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.
CPAHDBDL DD
This 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).
- 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
STTG
CICS® Transaction Gateway Statistics reports
- 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.