The LIST operand requests the Performance List report or
an extract file (see Performance Data extract).
The command format for the Performance List report is:
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),...),...))])
The command format for the List
Extract is:
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),...),...))])
The options are:
- 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, whether or not they generate an
alert and whether or not they are eligible. 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 LINECount 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.