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:

Start of change
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...')])
End of change

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.
Start of changeFIELDSEnd of change
Start of changeSpecifies the field names that are included in the report. The syntax of the FIELDS suboperand is as follows:
FIELDS(field[, field]
      ⋮     
      )
End of change
TITLE1, TITLE2
Controls the report title (left and right half of subheading line) for the report. See TITLE1 and TITLE2 for further information.