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),]
           [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.


Information Information

Feedback


Timestamp icon Last updated: Friday, 8 February 2013


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic//tlstxp.htm