The LISTX operand requests the Performance List Extended
report or the Cross-System Work Extended report.
The command format for the Performance List Extended report is:
CICSPA LISTX(
[OUTPUT(ddname),]
[EXTERNAL(ddname),]
[BY(by1(ASCEND|DESCEND),
by2(ASCEND|DESCEND),
by3(ASCEND|DESCEND)),]
[LIMIT(fieldname(proclim)),]
[FIELDS(field1[(options)],...),]
[LINECount(nnn),]
[TITLE1('...up to 64 characters...'),]
[TITLE2('...up to 64 characters...'),]
[SELECT(PERFORMANCE(INCLUDE|EXCLUDE(field1(values1),...),...)),]
[SELECT2(PERFORMANCE(INCLUDE|EXCLUDE(field1(values1),...),...))])
The command format for the Cross-System
Work Extended report is:
CICSPA LISTX(
[OUTPUT(ddname),]
[EXTERNAL(ddname),]
[BY(UOWID),]
[PRINTMULTIPLE|NOPRINTMULTIPLE,]
[PRINTSINGLE|NOPRINTSINGLE,]
[FIELDS(field1[(options)],...),]
[LINECount(nnn),]
[TITLE1('...up to 64 characters...'),]
[TITLE2('...up to 64 characters...'),]
[SELECT(PERFORMANCE(INCLUDE|EXCLUDE(field1(values1),...),...)),]
[SELECT2(PERFORMANCE(INCLUDE|EXCLUDE(field1(values1),...),...)),]
[SELUOW(PERFORMANCE(INCLUDE|EXCLUDE(field1(values1),...),...))])
The options are:
- OUTPUT
- Controls the report output DDname. If not specified, CICS PA assigns
a DDname in the format LSTXnnnn where nnnn is the report sequence
number 0001-9999. See OUTPUT for
further information.
- EXTERNAL
- Specifies the DDname for the work data set used by the external
SORT facility. If not specified, CICS PA assigns
an External Work File from a pool of External Work Files with DDnames
in the format CPAXWnnn where nnn is the sequence number 001-999. See EXTERNAL for further information.
- BY
-
- For the Performance List Extended report:
- BY dictates the summarization order of the report. Up to three
fields can be specified, where by1 is the major sort field, by2 the
intermediate, and by3 the minor sort field. Not all fields
can be sort fields. See LISTX(BY(field1,field2,field3) for the
list of fields which are sort candidates.
The default sort order
is ASCEND (ascending). Specify DESCEND if you want a field sorted
in descending order.
If BY is not specified, the default is
BY(TRAN,TERM).
- For the Cross-System Work Extended report:
- BY(UOWID) identifies that the CMF records are grouped
by network unit-of-work. No other BY fields can be specified.
- PRINTMULTIPLE
- Print
only the transaction performance records consisting of units-of-work
that include multiple CMF records. This is the default for the report.
- NOPRINTMULTIPLE
- Do
not print the transaction performance records consisting of units-of-work
that include multiple CMF records.
- PRINTSINGLE
- Print
the transaction performance records consisting of units-of-work that
include only a single CMF record. To get a listing containing these
records only, you must suppress the default PRINTMULTIPLE option by
specifying NOPRINTMULTIPLE as well.
- LIMIT
- Optional. Limits the number of selected performance class records
which are processed. Only one field can be specified. The LIMIT fieldname must
be the same as one of the field names specified in the BY operand.
See LISTX(LIMIT for the list of eligible
fields.
proclim specifies the maximum number of records
to be processed at a level corresponding to the location of the field
parameter in the BY operand.
- FIELDS
- Specifies which fields are reported, the order of the columns,
and the format of any time stamp fields. The sort fields specified
in the BY operand must also be specified in the FIELDS operand. See LISTX(FIELDS for the complete list of fields
and their options by field type.
- LINECOUNT
- Controls the number of lines per page. See LINECount for further information.
- TITLE1, TITLE2
- Controls the report title (left and right half of subheading line).
See TITLE1 and TITLE2 for further information.
- SELECT|SELECT2(PERFORMANCE(INCLUDE|EXCLUDE
- Specifies
what data to include or exclude from the report based on data field
values. See Using SELECT statements for an explanation
and examples.
- SELUOW(PERFORMANCE(INCLUDE|EXCLUDE
- Specifies
what units-of-work to include or exclude from the Cross-System Work
Extended report based on data field values. If one task in a multi-task
UOW matches the selection criteria, then all tasks for that UOW are
selected.
It can be used in conjunction with SELECT to first filter
out those tasks that you know are of no interest and thereby optimize
the record sort process.