Statistics List reports

The Statistics List report provides fully customizable batch reporting of CICS® TS and CICS TG Statistics, allowing you to select the desired fields and order of the fields in List type reports.

Start of changeThe Statistics List report isEnd of change arranged in tabular form with records from multiple intervals combined on the same page. Interval identification information columns including System Interval type and time are displayed before the interval data. This compact format allows easy reading and comparison of multi-interval or system data. A statistics form is used to customize the reports.

Some systems can generate very large volumes of data. To restrict reporting to only data of interest, Statistics Alert definitions can be used to filter the report records. These definitions provide a very powerful form of selection criteria through their support for formulas and thresholds.

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

Start of change
Figure 1. Statistics List Reports
   File  Filter  Edit  Systems  Options  Help 
 ──────────────────────────────────────────────────────────────────────────────
                       FSB520RS - Statistics List Reports          Row 1 from 2 
 Command ===>                                                  Scroll ===> PAGE

         ──── System Selection ────
 /  Exc  APPLID + Image +  Group +    Output    Form +     Alert +
                                      SLST0001  SYSFM1     TBSAL1   
         IYCUZC02 MV2A                SLST0002  SASFM2     TBSAL2   
 ******************************* Bottom of data ********************************

  F1=Help      F3=Exit      F4=Prompt    F7=Backward  F8=Forward  F10=Actions
 F12=Cancel
End of change

This panel displays the list of Statistics List 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 are:

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.
Form
The name of a statistics form to be used to tailor the format and content of the report.
Start of changeOutputEnd of change
Start of changeThe DDname for the report output which CICS PA uses when generating the JCL to run the Report Set.

This option generates the OUTPUT(ddname) operand.

End of change
Alert
A Statistics Alert definition containing the conditions used to select the records that you want to report.

The line actions available on this panel are the same as on similar Reports list panels. See Performance List report.

To display the Statistics List Report panel, enter line action S against the List 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 List Report
   File  Systems  Options  Help 
 ──────────────────────────────────────────────────────────────────────────────
                        FSB520RS - Statistics List Report
 Command ===>                                                                  

 System Selection:                       Report Output:
  APPLID . . IYCUZC02 Start of change +                  DDname . . . . . . . . . End of changeSLST0001 
  Image  . . MV2A      +                  Print Lines per Page . .      (1-255)
  Group  . .           +

 Report Format:
  Form . . . SBSFM2    +
  Title  . . Daily peaks analysis                                             
                                                                              

 Selection Criteria:
  Alert  . . SBSAL1    +
   Severity  WARNING   +
      Include Severity column   
  Interval Type  . . /  EOD  /  INT  /  USS  /  REQ  /  RRT 

 Repository  . . : SYB.CPA520.PROTO.REPOSTRY                      
  F1=Help      F3=Exit      F4=Prompt    F7=Backward  F8=Forward  F10=Actions
 F12=Cancel

Use this panel to specify report options for the Statistics List report. The only mandatory option is the statistics form. You can let the other options default.

The options are:

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.
Start of changeReport Output DDnameEnd of change
Start of changeThe DDname for the report output which CICS PA uses when generating the JCL to run the Report Set.

This option generates the OUTPUT(ddname) operand.

End of change
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 form to be used to tailor the format and content of the report. The statistics form specifies:
  • Which statistics types (STIDs) are activated. Only STIDs that are active in the form will be reported.
  • Which fields are to be reported for each STID and in what order.
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.

Selection Criteria
Use the Selection Criteria fields to filter the records to include in the reports.
Alert
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.

Using statistics alert definitions to filter statistics reports is different in some respects from how selection criteria are used with other reports. For details, see Filtering Statistics List and Statistics Summary reports.

To use a different Repository, return to the primary option menu, and then select option 0.3. If you define more than one Statistics List report in a Report Set, the reports must all refer to Alert Definitions stored in the same Repository; the JCL for a Report Set can refer to only one Repository.

CICS PA JCL generation translates this option to the STALTDEF operand.

Severity
Determines the minimum threshold level to evaluate which records are to be reported.
CRITICAL
Only records with Critical alerts are reported, according to the CRITICAL threshold values specified in the Statistics Alert definition.
WARNING
Only records with Critical or Warning alerts are reported, according to the CRITICAL and WARNING threshold values specified in the Statistics Alert definition.
INFO
Only records with Critical, Warning, or Informational alerts are reported, according to the CRITICAL, WARNING, and INFO threshold values specified in the Statistics Alert definition.
ELIGIBLE
Only records that are eligible for alert processing are reported. Eligible records are those that have field values that match the Resource values defined in the Statistics Alert definition. All eligible records are reported regardless of whether they generate an alert.

This option provides the means to filter out records that would never generate an alert because their resource values do not match resource values specified in the alert definition.

ALL
All records are reported regardless of whether they are eligible or whether they generate an alert.
Include Severity column
This option is used to insert a Sev column in the List report, showing the highest severity encountered for each record. (No other information is shown regarding the alert such as the field or alert that caused it.) This option must be selected if Severity=ALL.
Interval Type
To limit the types of CICS statistics intervals that CICS PA includes in the report, enter / next to the types you are interested in:
EOD
End-of-day
REQ
Requested
USS
Unsolicited
INT
Interval
RRT
Requested reset

Selecting none of the types is the same as selecting all types.

This option generates the TYPE operand.