Performance Summary report
The Performance Summary report is a summary of the CMF performance class records.
File Filter Edit Systems Options Help
------------------------------------------------------------------------------
SAMPLE - Performance Summary Reports Row 1 from 4
Command ===> ________________________________________________ Scroll ===> ____
---- System Selection ----- Selection
/ Exc APPLID + Image + Group + Output Form + Alert + Criteria
S CICSP001 ________ ________ SUMM0001 SUMMARY1 ________ YES
_ DEVT____ MVS1____ ________ SUMM0002 SUMMARY2 ________ NO
_ CICST001 ________ ________ SUMM0003 SUMMARY1 ________ YES
_ * ________ ________ RSYSGRP1 SUMM0004 ________ ________ NO
********************************* End of list *********************************
This panel displays the list of Performance Summary Reports in this Report Set. You can select (edit), delete, or include/exclude any report, insert new ones, or rearrange them (move/copy).
The options and line actions are the same as those for the Performance List Reports panel. See Performance List report.
File Systems Options Help
------------------------------------------------------------------------------
SAMPLE - Performance Summary Report
Command ===> _________________________________________________________________
System Selection: Report Output:
APPLID . . CICSP001 + DDname . . . . . . . . . SUMM0001
Image . . ________ + Print Lines per Page . . ___ (1-255)
Group . . ________ +
Report Focus: Report by time interval:
Form . . . TDSUM___ + Interval . . . 00:01:00 (hh:mm:ss)
Alert . . ________ + Override Form ________ +
_ Eligible transactions only Timestamp . . . ________ +
Reporting Options:
Totals Level . . 8 (blank or 0-8)
Title . . ________________________________________________________________
________________________________________________________________
Selection Criteria: Execution Option:
_ Performance * / Use External Sort
Repository . . : CICSPA.XYX.REPOSTRY
F1=Help F3=Exit F4=Prompt F7=Backward F8=Forward F10=Actions
F12=Cancel
Use this panel to specify report options, report focus, and record selection criteria for the Performance Summary report. The only mandatory option is the DDname for the report output. You can let the other options default.
The precision of numerical fields in the report is specified in Global Options (see Figure 1).
- Alert
- Specifies the Performance Alert Definition name.
- Eligible transactions only
- Indicates that the report should only process transactions that are eligible for alert processing. That is, their resource values match those specified in the alert definition. This option results in only alert eligible transactions being summarized in the report regardless of whether they generate an alert. This option effectively makes it an alert specific report. This option is ignored if no Performance Alert Definition name is specified.
- Report by time interval
- Provide flexibility when reporting by time interval. You can override the Form key fields by prefixing, appending, or replacing it with one of the timestamp fields. This gives you an easy means of using a common Summary Form to generate various interval-based reports without creating individual Forms for each report. This is achieved by allowing you to manipulate the Form key through the use of these options to create the required reports.
- Interval
- The time interval applies when you want to summarize transaction
activity over time. It is used when you specify a SUMMARY Report Form
which has any of the key fields OSTART, START,
or STOP included. When reporting, CICS PA accumulates
the data for each interval in the report period and writes a report
line for each.
Specify a value in the range 00:00:01 (1 second) to 24:00:00 (24 hours). The default is 00:01:00 (1 minute).
A time interval of less than one hour must fit evenly into the hour. CICS PA will round it down to the nearest interval that aligns to the hour. For example, 1.35 is reduced to 00:01:30 minutes which will produce 40 interval report lines for each hour of data.
A time interval of more than one hour must fit evenly into the day. CICS PA will round it down to the nearest interval that aligns to the day. For example, 10.30.23 is reduced to 08:00:00 hours which will produce 3 interval report lines for each day of data.
Minutes take precedence for an abbreviated entry. For example:- 1
- becomes 00:01:00
- 1.1
- becomes 00:01:00 (rounded down from 00:01:01)
- 1.1.1
- becomes 01:00:00 (rounded down from 01:01:01)
This option generates the INTERVAL(hh:mm:ss) operand.
- Override Form
- Specifies whether to PREFIX, APPEND or REPLACE the
key fields specified in the Form. Based on the action in this option,
JCL generation will generate the required Form key using the override
option and field specified in Timestamp. Ensure that the resulting
key conforms to the Summary key rules. No action will be taken if
this field is blank. The Form itself is not affected, only the generated
FIELDS key fields.
This option is ignored if no Form is specified.
- Timestamp
- Specifies the field name to override the Form key fields. Valid timestamp fields are START, STOP, and OSTART.
- Totals Level
- This option applies only to the Summary report. Leave blank if
you do not want to include total lines in the report. This generates
the NOTOTALS operand.
Specify a number between 1 and 8 to accumulate subtotals for up to 8 sort fields, print the subtotals when the sort field changes, and print a grand total at the end of the report. This generates the TOTALS(n) operand where n is a value between 1 and 8. Default: 8
Specify 0 for no subtotals, but print only the grand total. This generates the TOTALS(0) operand.
- Use External Sort
-
Select / to use an external sort utility to process summary records. This is the default. It generates the EXTERNAL(ddname) operand. This provides the DDname of the work data set used by the external sort utility. CICS PA assigns an External Work File from a pool of External Work Files with default DDnames in the format CPAXWnnn where nnn is a sequential number 001-999 to uniquely identify the work file.
An external sort should be used when processing records that would generate a very large number of unique key values. The volume of data is not determined by the number of input records. It depends on the number of unique values that have to be tracked for the SUMMARY report sort key.
For example:- FIELDS(TRAN) will generate a report line for each Transaction ID and can usually be handled by an internal sort.
- FIELDS(USERID,TRAN) will generate a report line for every combination of Userid and Transaction ID. In this case, consider using an External Sort.
If this option is not selected, an internal sort is used. That is, CICS PA sorts the records in virtual storage.
- Repository
- The data set name of the Repository that contains the Performance Alert Definitions.
CICS PA provides a default Report Output DDname in the format SUMMnnnn where nnnn is 0001-9999.
To select a Form from a list of predefined SUMMARY Report Forms, use Prompt (F4). If a Form is not specified, CICS PA uses the default Form. See Figure 1 for the default SUMMARY Report Form.