Transaction Tracking Summary report

The Transaction Tracking Summary report provides an overview of the flow of related transactions through the various CICS® systems. This report allows you to analyze transaction performance from the perspective of transaction flow. For each originating transaction there is a block showing a summary line for all transactions that were associated directly or indirectly with the originating transaction. Grouping of transactions is based on a tracking key, which includes fields that identify the originating transaction, fields that identify the previous related transaction, and 1-4 user-specified key fields, which are used to display the actual summary data.

To request the report, enter line action S against the Transaction Tracking Summary Performance Report on the Report Set panel. If reports of this type have been previously specified, the list of Transaction Tracking Summary reports is displayed. Otherwise, the Transaction Tracking Summary panel is displayed for you to define your first report of this type.
Figure 1. Transaction Tracking Summary Reports
   File  Filter  Edit  Systems  Options  Help
 ------------------------------------------------------------------------------
                 SAMPLE - Transaction Tracking Summary             Row 1 from 2
 Command ===> ________________________________________________ Scroll ===> ____
 
                                                           Criteria   
         ---- System Selection ----                      Record  Group
 /  Exc  APPLID + Image +  Group +   Output     Form +   ------ ------
 _       CICSP001 MVS1____ ________  TTSU0001   TSFM2___  YES    YES  
 _       CICST001 ________ ________  TTSU0002   TSFM5___  NO     NO   
 ******************************* Bottom of data *******************************
 

This panel displays the list of Transaction Tracking Summary reports in this Report Set. You can select (edit), delete, or include/exclude any report, insert new ones, or rearrange them (move/copy).

The line actions are the same as those for the Performance List Reports panel. See Performance List report. The options are also similar except that there is no option to specify an Alert definition. The report must use a Report Form of a compatible type (that is, SUMMARY).

To display the Transaction Tracking Summary Report panel, enter line action S against the Transaction Tracking Summary Performance Report on the Report Set panel, then if the list of previously specified reports is displayed, enter line action S against a particular report in the list.

Figure 2. Transaction Tracking Summary Report
                 SAMPLE - Transaction Tracking Summary Report
 Command ===>                                                                  

 System Selection:                       Report Output:
  APPLID . . CICSP001  +                  DDname . . . . . . . . . TTSU0001 
  Image  . . MVS1      +                  Print Lines per Page . .      (1-255)
  Group  . .           +

  Tracking Key:
   PR Task 1   APPLID    +  2   TRAN      +
      Task 1             +  2             +  3             +  4             +

 Report Focus:
  Form  . . . . . .           +

 Report Format:
  Title  . .                                                                  
                                                                              

 Selection Criteria:
     Performance (Record pre-processing)  
     Performance (Groups post-processing)  

Use this panel to specify report options and record selection criteria for the Transaction Tracking Summary report. The mandatory option is the Report Output DDname. You can leave the other options unchanged.

The report options are similar to those for the Performance List Report (see Performance List report), except for the following additional options:
Tracking Key
Grouping of transactions in the report is based on a tracking key, which comprises three parts:
  1. Fields that identify the originating transaction.

    In the PR Task 1 and 2 fields, specify the originating transaction ID fields. You can select APPLID, which specifies the originating CICS APPLID (OAPPLID), or TRAN, which specifies the originating transaction (OTRAN), or both. The default key is APPLID + TRAN.

  2. Fields that identify each previous transaction related to the originating transaction.

    The previous transaction identification fields are automatically paired in the report with the corresponding originating transaction fields. That is, if TRAN is selected then PRTRAN will be included and if APPLID is selected then PHAPPLID will be included.

  3. 1-4 user-specified key fields.

    In the Task 1 to 4 fields, select up to four CMF fields, which are used to display the actual summary data for each originating transaction and each related transaction. Use Prompt (F4) to select from a list of available fields.

Selection Criteria
Selection criteria can also be 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 associated origin record be excluded from the report.
When a report form is specified for this report, the following rules apply.
  1. The key fields in the form are replaced by the tracking key.
    Note: This can result in the report page width different to that calculated for the form.
  2. An error will be generated if PHCOUNT or PTCOUNT is a field in the form as it is part of the tracking key.
  3. Fields with function Severity (SEV) are ignored and are not included in the report.

CICS PA provides a default Report Output DDname in the format TTSUnnnn where nnnn is 0001-9999.