Selecting parts of the CICS internal trace table

You can select which parts of the CICS® internal trace table to format for a system dump by using the CICS dump exit parameter, TRS, for the IPCS SDUMP formatting program.

About this task

You can use the TRS to select trace entries by:
  • A specified number of blocks at the end of the internal trace table
  • Kernel task
  • Task identifier
  • Terminal
  • Transaction identifier
  • Time period
  • Trace identifier

For more information about the statements that you can use to select parts of the CICS internal trace table, see The trace selection parameters for DFHTU710.

For abbreviated and full trace formatting, a trace summary table provides summary information about the trace entries that relate to each task in the system during the time period. The trace summary table appears at the end of the formatted trace output. Use the table to see the tasks that were traced, and the location and number of their trace entries in the trace output. The table also highlights any long time gaps between the trace entries for a task, which can indicate a performance problem, and any exception trace entries for a task. The trace summary table is not produced for short-format trace.

Note: The trace summary report will format transaction identifiers only if the trace entry point ID XS 0701, XS level-1 for the transaction is included in the trace data set.

Procedure

  1. To select the parts of the internal trace to be formatted by IPCS, specify the TRS parameter on the IPCS VERBEXIT command.
    For example:
      VERBEXIT CICS710 'DEF=1,DLI=1,KE=3,TR=2,TRS=<TRANID=CSSC,KE_NUM=12,LAST_BLOCKS=500>'
    The VERBEXIT statement specifies the verb name CICS710 to process CICS Transaction Server for z/OS®, Version 5 Release 4 system dump data. This corresponds to the IPCS dump exit routine DFHPD710, as specified in the DFHIPCSP member in the CICSTS54.CICS.SDFHPARM library.
  2. Specify the TR parameter, with a value other than 0, on the IPCS VERBEXIT command.
    This setting ensures that output from the trace domain is formatted and the TRS keyword is effective.