TRACKINGLIST - Transaction Tracking List report
The TRACKINGLIST operand requests the Transaction Tracking List report. This report combines CMF records for each originating transaction and its subordinate (group) transactions. Group transactions are identified by sharing the same transaction group ID with other transactions or by having a PHCOUNT > 0.
The command format is:
CICSPA TRACKINGLIST(
[OUTPUT(ddname),]
[EXTERNAL(ddname),]
[OFIELDS(field1[(options)],...),]
[GFIELDS(field1[(options)],...),]
[PRINTMULTIPLE|NOPRINTMULTIPLE,]
[PRINTSINGLE|NOPRINTSINGLE,]
[LINECount(nnn),]
[SELECT(PERFORMANCE(INCLUDE|EXCLUDE(field1(values1),...),...)),]
[SELGRP(PERFORMANCE(INCLUDE|EXCLUDE(field1(values1),...),...)),]
[TITLE1('...up to 64 characters...'),]
[TITLE2('...up to 64 characters...'),])
The options are:
- OUTPUT
- Controls the report output DDname. If not specified, CICSĀ® PA assigns a DDname in the format TTLSnnnn 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.
- PRINTMULTIPLE
- Print only group transactions. This is the default condition when creating the report.
- NOPRINTMULTIPLE
- Do not print group transactions.
- PRINTSINGLE
- Print only transactions that do not belong to a group.
- NOPRINTSINGLE
- Do not print transactions that do not belong to a group.
- LINECOUNT
- Controls the number of lines per page. See LINECNT for further information.
- OFIELDS
- Specifies which fields are included in the origin section of the
report and their format.If the OFIELDS operand is not specified, the default is:
CICSPA TRACKINGLIST(OFIELDS(OTRAN, Originating Transaction ID OUSERID, Originating User ID OAPPLID, Originating CICS Application ID OTASKNO, Originating Transaction number OSTART(TIMET), Originating Task Start time OORIGIN, Originating Transaction Origin type OFCTY, Originating Transaction Facility name OTCPSRVC, Originating TCP/IP Service name OCLI6ADR, Originating Client or Telnet IP address OCLIPORT)) Originating Client IP port number
- GFIELDS
- Specifies which fields are included in the group section of the
report and their format.If the GFIELDS operand is not specified, the default is:
CICSPA TRACKINGLIST(GFIELDS(TRAN, Transaction ID USERID, User ID APPLID, CICS Application ID TASKNO, Transaction number START(TIMET), Task Start time RTYPE, Record type ORIGIN, Transaction origin RESPONSE, Response time CPU, User CPU PHTRAN, Previous Hop transaction ID PHTASKNO, Previous Hop task number PHAPPLID, Previous Hop application ID PHSTART, Previous Hop start time PHCOUNT)) Previous Hop count
- TITLE1, TITLE2
- Controls the report title (left and right half of subheading line). See TITLE1 and TITLE2 for further information.
- SELECT(PERFORMANCE(INCLUDE|EXCLUDE
- Specifies what records to include or exclude from report processing based on data field values. See Using SELECT statements for a detailed explanation and examples.
- SELGRP(PERFORMANCE(INCLUDE|EXCLUDE
- Specifies
what records and groups to include or exclude after report processing
based on data field values. See Using SELECT statements for
a detailed explanation and examples.
This set of selection criteria is applied as a post-processing step. This is a second level of filtering that determines which Groups are to be included in the report. Only when all of the records in the Group fail this set of selection criteria will the whole group and its associated Origin record be excluded from the report.
Note: The combination of PRINTMULTIPLE and PRINTSINGLE
results in a report containing all transactions. Conversely, specifying
NOPRINTMULTIPLE and NOPRINTSINGLE results in an empty report.