LIST - Performance List report
The LIST operand requests the Performance List report or an extract file (see Performance Data extract).
CICSPA LIST(
[OUTPUT(ddname),]
[ALERTDEF(defname),]
[SEVERITY(CRITICAL|WARNING|INFO|ELIGIBLE|ALL),]
[FIELDS(field1[(options)],...),]
[LINECount(nnn),]
[TITLE1('...1st 64 characters of title...'),]
[TITLE2('...2nd 64 characters of title...'),]
[SELECT(PERFORMANCE(INCLUDE|EXCLUDE(field1(values1),...),...)),]
[SELECT2(PERFORMANCE(INCLUDE|EXCLUDE(field1(values1),...),...))])
CICSPA LIST(
[OUTPUT(ddname),]
[DDNAME(ddname),]
[DELIMIT('field-delimiter'),]
[LABELS|NOLABELS,]
[FLOAT,]
[ALERTDEF(defname),]
[SEVERITY(CRITICAL|WARNING|INFO|ELIGIBLE|ALL),]
[FIELDS(field1[(options)],...),]
[TITLE1('...1st 64 characters of title...'),]
[TITLE2('...2nd 64 characters of title...'),]
[SELECT(PERFORMANCE(INCLUDE|EXCLUDE(field1(values1),...),...)),]
[SELECT2(PERFORMANCE(INCLUDE|EXCLUDE(field1(values1),...),...))])
- OUTPUT
- Controls the report output DDname. See OUTPUT for further information. If not
specified, CICS PA assigns
a DDname in the format xxxxnnnn where nnnn is the report sequence
number 0001-9999 to uniquely identify the output, and xxxx
is:
- LIST for the Performance List report.
- EXPT for the Recap report for the List Extract.
- DDNAME
- Specifies the DDname of the extract data set where the extracted data is
written. When this operand is specified, instead of producing the report, CICS PA produces the extract file, and a Recap of the
extract process is written to the OUTPUT operand report file.
The DDname can be up to 8 alphanumeric characters, with the first non-numeric. The CICS PA dialog assigns DDnames in the format CPAOEXnn where nn is the extract sequence number 01-99. (See the sample JCL in Figure 1).
- DELIMIT
- Specifies the field delimiter, enclosed in quotes, to be used to separate each data field in the extract data set. The default is a semicolon DELIMIT(';').
- LABELS|NOLABELS
- LABELS indicates that the first record to be written to
the extract data set is to be a field labels record. This is the default.
NOLABELS indicates that CICS PA is not to write a field labels record to the extract data set.
- FLOAT
- Write numeric fields in the extract in S390 FLOAT format. This
only applies to the List Extract when the FIELDS
operand is specified.
Specify FLOAT format if you plan to import the extract into a DB2® table. When the DB2 Load Utility is used, it will interpret all numerical fields reliably and consistently in FLOAT format.
If FLOAT is not specified, the numeric fields are written in a mixture of integer, real and exponential using character digits. This is the default and is suitable when importing the extract data into a PC spreadsheet tool.
- ALERTDEF
- The name of a Performance Alert Definition for alert reporting.
- SEVERITY
- Determines the minimum severity level to be
reported and type of transactions reported.
- CRITICAL
- Only Critical transactions are reported.
- WARNING
- Only Critical and Warning transactions are reported.
- INFO
- All alerts are reported: Critical, Warning and Informational transactions.
- ELIGIBLE
- Only eligible transactions are processed and reported. Eligible
transactions are those that have resource values that match resource
values specified in the alert definition. The resulting report will
include eligible only transactions with and without alerts.
This option provides the means to filter out transactions that would never generate an alert because their resource values do not match resource values specified in the alert definition.
- ALL or blank
- All transactions are reported regardless of whether they are eligible or whether they generate an alert. This is the default.
- FIELDS
- Specifies which fields are included in the report or extract, their order, and format. See LIST(FIELDS for details.
- LINECOUNT
- Controls the number of lines per page in the List report. See LINECNT for further information.
- TITLE1, TITLE2
- Controls the report title (left and right half of the subheading line) for the List report or the Extract Recap. See TITLE1 and TITLE2 for further information.
- SELECT|SELECT2(PERFORMANCE(INCLUDE|EXCLUDE
- Specifies what data to include or exclude from the report or extract based on data field values. See Using SELECT statements for an explanation and examples.