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 or PTCOUNT greater than 0. This report tracks asynchronous API transactions, which run on the same CICSĀ® system, and 'previous hop' transactions, which run on different CICS systems.
The command format is:
CICSPA TRACKINGLIST(
[OUTPUT(ddname),]
[EXTERNAL(ddname),]
[TIMESEQ|CALLSEQ,]
[OFIELDS(field1[(options)],...),]
[GFIELDS(field1[(options)],...),]
[LINECount(nnn),]
[SELECT(PERFORMANCE(INCLUDE|EXCLUDE(field1(values1),...),...)),]
[SELGRP(PERFORMANCE(INCLUDE|EXCLUDE(field1(values1),...),...)),]
[TITLE1('...up to 64 characters...'),]
[TITLE2('...up to 64 characters...'),])
- 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.
- TIMESEQ|CALLSEQ
- Time sequence requests the Transaction Tracking Time Sequence List report, which lists
transactions in each group ordered by START.
Call sequence requests the Transaction Tracking Call Sequence List report, which is ordered to show the 'parent-child' relationships between the transactions. Each group shows the originating transaction at the top, followed by subgroups. The first transaction in each subgroup is a direct descendant of the originating transaction. The direct descendant is followed by its descendants.
- 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 origin section shows the following columns:
OTran Originating Transaction ID OUserid Originating User ID OAPPLID Originating CICS Application ID OTaskNo Originating Transaction number OStart Time Originating Task Start time OOrigin Originating Transaction Origin type OFcty Originating Transaction Facility name OTCPIPSr 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 group section shows the following columns:
TRAN Transaction ID PTTran Previous same-system transaction ID PHTran Previous hop transaction ID TaskNo Task number PRTaskNo Previous hop or transaction task number PRCount Previous hop or transaction count Origin Transaction origin APPLID CICS Application ID PHAPPLID Previous Hop application ID Start Time Task Start time Response Time Response time User CPU Time CPU time Suspend Time Suspend time OSLatncy Time Task start latency since origin task start PRLatncy Time Latency time in previous system - 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.