STATISTICSLIST - Statistics List reports and extracts
The STATISTICSLIST operand requests a Statistics List report or form-based extract.
The command format for a Statistics List report is:

CICSPA STATISTICSLIST(
[OUTPUT(ddname),]
[DDNAME(ddname),]
[DELIMIT('field-delimiter'),]
[LABELS|NOLABELS,]
[LINECNT(nnn),]
[STALTDEF(statistics-alert-definition)),]
[SEVERITY(CRITICAL|WARNING|INFO|ELIGIBLE|ALL),]
[INCLUDESEV,]
[TYPE(EOD,INT,USS,REQ,RRT),]
FIELDS(field1[,field2]...),
[TITLE1('...up to 64 characters...'),]
[TITLE2('...up to 64 characters...')])
The options are:
- OUTPUT
- The DD name of the output report. In the case of a statistics list extract, the output report is the recap report. See OUTPUT for further information.
- DDNAME
- Applicable for extracts only. DDNAME specifies the name of the extract data set in the format CPAOSXnn where nn is the report sequence number 01-99.
- DELIMIT
- Applicable for extracts only. DELIMIT specifies the field delimiter, enclosed in single quotation marks, that will separate each data field in the extract data set. The default value is a semicolon DELIMIT(';').
- LABELS|NOLABELS
- Applicable for extracts only. LABELS indicates that the first record written to the
extract will be a field labels record. This is the default value.
NOLABELS indicates that CICS PA will not write a field labels record to the extract data set.
- STALTDEF(statistics-alert-definition)
- 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.
In the JCL for the report, the DDname CPAHDBRG identifies the Repository data set that defines the Alert Definition.
- 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.
- INCLUDESEV
- 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.
- TYPE(...)
- The types of statistics intervals to include in the report.
FIELDS
Specifies the field names that are included in the report. The syntax of the FIELDS suboperand
is as
follows:FIELDS(field[, field] ⋮ )
- TITLE1, TITLE2
- Controls the report title (left and right half of subheading line) for the report. See TITLE1 and TITLE2 for further information.