Performance Summary report

The Performance Summary report is a summary of the CMF performance class records.

To request the report, enter line action S against the Summary Performance Report on the Report Set panel. If reports of this type have been previously specified, the list of Performance Summary Reports is displayed. Otherwise, the Performance Summary Report panel is displayed for you to define your first report of this type.
Figure 1. Performance Summary Reports
   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.

CICS PA provides a default Report Output DDname in the format SUMMnnnn where nnnn is 0001-9999.

If Form is not specified, CICS PA uses the default Form. See Figure 1 for the default SUMMARY Report Form.

To display the Performance Summary Report panel, enter line action S against the Summary Performance Report on the Report Set panel, then if the list of previously specified reports is displayed, enter line action S against a particular report in the list.
Figure 2. Performance Summary 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    
 
 HDB Register  . : CICSPA.HDB.REGISTER 
 
  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).

The report options are the same as those for the Performance List Report (see Performance List report) but with the following additional options:
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 or not. 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 desired 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 desired 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 large volumes of data.

If not selected, an internal sort is used.

HDB Register
The data set name of the HDB Register 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.