Filtering Start of changeStatistics List and Statistics SummaryEnd of change reports

Statistics alerts provide the ability to filter records to include in Statistics batch reports. Statistics alerts allow you to select records based on any field, including statistical, identification, or state fields and support formulae.

Statistics filtering rules

  1. Only one field type can be specified in each condition within an alert definition.
  2. All fields in a single condition must belong to the same STID (statistics type).
  3. Multiple conditions can be defined for a single STID.
  4. Each condition is evaluated independently of all other conditions.
  5. The first Exclude result will terminate record processing. That is, all Include conditions must be met.
  6. If a Severity level is selected in a Start of changeStatistics ListEnd of change report, only conditions at that level or higher are evaluated and reported. For example, if the report specified Severity=Warning, Warning and Critical thresholds are evaluated but Info thresholds are ignored.

Start of changeFiltering Statistics List reportsEnd of change

Start of changeStatistics ListEnd of change reports have particular filtering requirements for which the standard selection criteria mechanism is not optimal. Instead, the Statistics List Report definition uses statistics alerts to implement both record selection and alerting:
  • If an alert definition is specified in the report's selection criteria options, it and an additional severity level option are used to select records for inclusion in the report.
  • The Include Severity column option inserts a Sev column in the report to show the severity level that triggered the selection:
    Severity=Critical, Warning, or Info
    The record triggered an alert at the specified severity or higher.
    Severity=Eligible
    The record matched the resource criteria of an alert entry, but might have or might not have triggered an alert.
    Severity=ALL
    All records are selected for reporting. The alert definition acts only as a severity indicator.
Start of change

Filtering Statistics Summary reports

Statistics Summary reports have particular filtering requirements for which the standard selection criteria mechanism is not optimal. Instead, the Statistics Summary Report definition uses statistics alerts to implement record selection.

A statistics alert for a statistics summary report is composed of the following components:
  • Alert. A textual description of the alert.
  • Formula. An expression to evaluate, for example a statistics field name.
  • Critical, Warning, or Info. Optionally you can filter the results by entering a comparison operator and a numeric value for one of these three fields, for example >50.
  • Res or List. An optional resource value (Res) or resource list (List). You can use masking characters % (exactly one character) or * (zero or more characters). For example, suppose the Formula contains fields from the Dispatcher TCB Modes report. To report the condition only for TCB mode names that begin with the letter L, enter L* in the Resource field.
  • APPLID. An optional APPLID so you can limit reporting to a particular CICS system. You can use masking characters to specify multiple systems.
End of change