LISTX - Performance List Extended report
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),]
[LIMIT(fieldname(proclim)),]
[FIELDS(field1[(options[,ASCEND|DESCEND])],...),]
[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),]
[PRINTMULTIPLE|NOPRINTMULTIPLE,]
[PRINTSINGLE|NOPRINTSINGLE,]
[CROSSSYSTEM,]
TASKORDER(START|STOP)
[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.
CROSSSYSTEM
Identifies that the Cross System Work Extended report will be generated with the CMF records grouped by network unit-of-work.
- 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.
NOPRINTSINGLE
Do not print transactions that do not belong to a group.
- 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 as a sort field. 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 specified as a sort field.
TASKORDER
Sorts tasks within each UOW in either descending order of stop time (the default option) or ascending order of start time.
- FIELDS
- Specifies which fields are reported, the order of the columns,
the sort order,
and the format of any time stamp fields. See LISTX(FIELDS for the complete list of fields and their options by field type.
- LINECOUNT
- Controls the number of lines per page. See LINECNT 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.