Start of change

Statistics Summary reports

The Statistics Summary report shows summarized statistics, such as total or maximum values, for CICS® Transaction Server and CICS Transaction Gateway.

To request a report, enter line action S against the Summary report in the Statistics Report category on the Report Set panel. If reports of this type have been previously specified, the list of Statistics Summary reports is displayed. Otherwise, the Statistics Summary Reports panel is displayed for you to define your first report of this type.

Figure 1. An existing Statistics Summary report
   File  Filter  Edit  Systems  Options  Help 
 ------------------------------------------------------------------------------
                      SS1 - Statistics Summary Reports             Row 1 from 1 
 Command ===>                                                  Scroll ===> PAGE

         ---- System Selection -----
 /  Exc  APPLID + Image +  Group +   Output    Form +    Alert +
         *                           SSUM0001  STSUM5    SAD2     
 ******************************* Bottom of data ********************************

This panel displays the list of Statistics Summary reports in this report set. You can delete reports, add new ones, or perform various other actions; type line action / to see the list of actions.

The options are:

/
The line actions available on this panel are the same as on similar reports list panels. See Performance List report.
Exc
An asterisk * in this field indicates that the report is excluded from report processing.

Use line action X to reverse the Exclude indicator.

System Selection
Identifies the CICS APPLIDs whose data you want to select for processing.

You can specify any combination of APPLID, Image, or Group, but these must be defined in your System Definitions. If you do not specify System Selection here or in the Global Options, you are prompted at run time to specify the System Selection. This will apply globally to all reports and extracts without their own System Selection. This is recommended as it allows you to run your Report Sets against any of your defined Systems. Press the Prompt key (F4) to select from a list of defined Systems, Images, or Groups. To modify your System Definitions, select Systems in the action bar.

Specify one of the following:
  • A CICS APPLID. An APPLID that matches a defined System's name pattern is also allowed. For example, CICSP1 can be specified if CICSP* is a defined system.
  • An APPLID and an MVS™ Image. This identifies the MVS Image where your CICS system runs.
  • An MVS Image. All CICS systems executing on this MVS Image are selected.
  • An APPLID and Image combination plus a Group. This is useful for uniquely identifying a CICS system when there are multiple CICS systems with the same name defined.
  • A Group alone. CICS PA will select all CICS APPLIDs defined to the Group. For example, for transaction grouping, or for systems that connect via IRC/MRO, ISC/APPC, or IPIC.

CICS PA uses the System Selection in JCL generation to build the APPLID(applid1,applid2,applid3,...) and INput(SMFIN001,SMFIN002,SMFIN003,...) operands, and corresponding //SMFINnnn DD statements.

System Selection can also be specified either:
  • In Global Options. The report-level specification takes precedence over the global.
  • At run time. The run-time System Selection overrides the Global Options and optionally the report-level specification.
Output
CICS PA provides a default output name for the report in the format SSUMnnnn where nnnn is 0001-9999.
Form
The name of a statistics summary form to be used to tailor the format and content of the report.
Alert
Optional. The alert definition containing the conditions used to select the records that you want to report. You must have already created this alert definition in the currently active repository. To select from a list of alert definitions in the repository, press Prompt (F4). To create a new alert definition, return to the primary option menu, and then select option 8.5. For details, see Statistics alert reporting.

To display the Statistics Summary Reports panel, enter line action S against the Summary Statistics 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. Statistics Summary report
   File  Systems  Options  Help 
 ------------------------------------------------------------------------------
                      SS1 - Statistics Summary Report
 Command ===>                                                                  

 System Selection:                       Report Output:
  APPLID . . *         +                  DDname . . . . . . . . . SSUM0001 
  Image  . .           +                  Print Lines per Page . .      (1-255)
  Group  . .           +

 Report Format:                          Report by time interval:
  Form . . . STSUM5    +                  Interval  . . . 03:00     

 Reporting Options:
  Title  . . Summary of Applications with excessive Attaches ______           
                                                                              

 Selection Criteria:
  Alert  . . SAD2      +
  Type . . . /  EOD  /  INT  /  USS  /  RRT 

 Execution Option:
     Use External Sort         

 Repository  . . : NEW.HDB.REPOSTRY                               

Use this panel to specify report options for the Statistics Summary report.

APPLID, Image, and Group
Identifies the CICS APPLIDs whose data you want to select for processing.
DDname
The DDname for the report output which CICS PA uses when generating the JCL to run the report set. The DDname is mandatory and should be unique to separate the output of multiple reports.

This option generates the OUTPUT(ddname) operand.

Print Lines per Page
The maximum number of lines, including headings, to print on each page of the report. Valid values are from 1 to 255. The default is 60.

The global value applies to all reports. If a value is specified on this report panel, the report value takes precedence over the global for this report only.

CICS PA JCL generation translates this field to the LINECount(nnn) operand.

Form
The name of a statistics summary form that provides the format and content of the report.
Interval
Optional. Interval affects the summary report only if COLLECTTIME is one of the key fields in the report. When COLLECTTIME is used, Interval is the time interval over which statistics are summarized in the report. The format of the field is hh:mm|day of week|MONTH. Some examples of valid interval values are: 03:00, 06:00, MONDAY, SUNDAY, MONTH.

For a time interval that is less than an hour, CICS PA rounds the time interval down to the nearest interval that divides evenly into the hour, for example 00:30 or 00:20, but not 00:35. Similarly, for a time interval that is less than a day, CICS PA rounds the time interval down to the nearest interval that divides evenly into the day; for example, 10:30 is rounded to 08:00.

When Interval is a day of the week, each summary record in the report contains data from the first record for the specified day of the week to the last record for the day of the week that is seven days later.

When Interval is MONTH, CICS PA summarizes records from the first record processed for the month to the last record processed on the last day of the month.

Note: The date and time in the Collection Time column of the report is the start date and time of the interval.
Title
Title of the report. Specify up to 128 characters of text to describe the report. CICS PA concatenates the two lines of 64 exactly as entered to make one line which prints at the top of each page of the report below the heading. The default is blank (no title).

This option generates the TITLE1('left-half') and TITLE2('right-half') operands.

Alert
Optional. The alert definition used by the report set to filter the records before they are summarized. The alert definition is stored in the repository that is in use.
Type
The types of interval to summarize.
EOD
End-of-day
INT
Interval
USS
Unsolicited
RRT
Requested reset
Note: REQ statistics intervals are not included for a statistics summary report because they would distort the summarized data.
Use External Sort

Select / to use an external sort utility to process summary records. Selecting this option 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(APPLID) will generate a report line for each APPLID and can usually be handled by an internal sort.
  • FIELDS(APPLID(ASCEND),PGD_PROGRAM_NAME(ASCEND)) will generate a report line for every combination of APPLID and program name. In this case, consider using an external sort.

If this option is not selected, an internal storage queue is used. That is, CICS PA maintains the records in virtual storage.

Repository
Read-only. The name of the repository in use, which determines the alerts you can select. If you need to change the repository, on the primary menu select option 0.3 CICS PA Control Data Sets.
End of change