The following steps briefly describe how to use the dialog to start
reporting.
Initial setup (defaults apply)
This
is applicable when using CICS PA for
the first time.
Initial setup is optional. CICS PA uses
default settings and prompts you to allocate data sets (with default
allocation attributes) as they are required. However, if you want
to step through the process, the initial setup procedure is:
- Check your ISPF environment settings. See Recommended ISPF setup.
- Specify the CICS PA Settings. This
allows some customization of the CICS PA dialog
and JCL used for generating reports and extracts. See CICS PA Settings.
- Specify default Reporting Allocation Settings (UNIT= and
SPACE=) for the Extract data sets, External Work data sets, and Sort
Work data sets. These are used by the CICS PA dialog
to generate the corresponding DD statements in the JCL. See Reporting Allocation Settings.
- Specify the Control Data Sets that contain the Report Sets,
Report Forms, Object Lists, and the Repository.
See CICS PA Control Data Sets.
- If you plan to export HDB data to DB2®,
specify your DB2 settings. Select
option 0, CICS PA Profile,
from the Primary Option Menu, and then select DB2 Settings.
- Specify which system definitions (personal or shared
or both) to use at run time. If you plan to report on data stored
in log streams, specify Log stream options. Select option 0, CICS PA Profile,
from the Primary Option Menu, and then select File Selection.
Everyday operation
The
normal procedure to request and generate reports and extracts is as
follows:
- Specify the System Definitions by identifying
your personal and shared systems (CICS® APPLID, MVS™ Image, DB2 SSID, MQ SSID, System
Logger), SMF Files, and Groups. You can automate much of this process
by using the Take-up facility. See Personal System Definitions and Shared System Definitions.
- Define a Report Set:
- Create a new Report Set. See Creating new Report Sets.
- Specify any Global Options and Selection Criteria. The
Global Options apply to all reports and extracts within the Report
Set. The global Performance Selection Criteria apply to all Performance
reports and extracts within the Report Set. The global Exception Selection
Criteria apply to all Exception reports within the Report Set.
- Select and tailor the Reports and Extracts that you require.
If report-specific options and selection criteria are specified, they
take precedence over the corresponding Global Options and Selection
Criteria at JCL build time. You can request more than one of each
type of report or extract (for example, 3 Performance List Reports
and 2 Cross-System Work Extracts), and specify different options for
each. Exclude any of a particular type you do not want to generate,
and Deactivate if you want to generate none of a particular type.
See Maintaining Report Sets for details of all reports,
extracts, and their options.
- Define any Report Forms that will be used
to tailor the format of certain reports and extracts. See Maintaining Report Forms.
- Define any Object Lists used to enhance the Selection Criteria.
See Maintaining Object Lists.
- Enter the RUN command to run the Report Set.
The Active status controls which reports in the Report Set are run.
Only active reports in active categories are selected, but you can
use the RUN line action to temporarily override this. A panel
is displayed for you to enter run-time options. Then CICS PA generates
the JCL for batch report processing. Global Options and Selection
Criteria, requested reports and extracts, and any Report Forms and
Object Lists they use, are converted to a stream of commands for batch
execution. You can choose to submit the JCL directly, or edit it first
and optionally save the JCL in an external library. See Running Report Sets.
- View or print the job output using
your usual method, such as SDSF or ISPF Outlist utility.
- Process the Extract
data sets using a method appropriate to each. For example:
- Define and maintain Historical Databases (HDBs) as
repositories of performance data. Generate reports from your HDBs
or export HDB data to DB2 tables
for further analysis.
Use the interactive Statistics Reporting facilities
in the CICS PA dialog
to view CICS TS and CICS TG statistics stored in SMF
Files or HDBs. See Using the Statistics reporting dialog. 