Using Transaction and terminal-related trace options

The "Transaction and Terminal Trace" display is produced by pressing PF5 on the main CETR display. It can be used to set STANDARD, SPECIAL, or SUPPRESSED tracing for particular CICS tasks. This is done by setting the appropriate value for the transaction ID used to start the task, or for the terminal from which the task is to be run. Note that SUPPRESSED cannot be set for terminals, only for transaction IDs. The required terminal can also be specified by using its netname.

Setting SPECIAL tracing for a particular transaction means that the SPECIAL flags for each component (as defined on the "Component Trace Options" display) is used to decide whether a particular trace entry is to be made at any given point in the process of the task.

The display layout is as follows:

Figure 193. CETR transaction: transaction and terminal trace screen
 CETR                    Transaction and Terminal Trace            CI41 IYAHZCCV

 Type in your choices.

 Item                              Choice       Possible choices

 Transaction ID              ===>               Any valid 4 character ID
 Transaction Status          ===>               STandard, SPecial, SUppressed

 Terminal ID                 ===>               Any valid Terminal ID
 Netname                     ===>               Any valid Netname
 Terminal Status             ===>               STandard, SPecial
 Terminal VTAM Exit Trace    ===>               ON, OFf
 Terminal ZCP Trace          ===>               ON, OFf

 VTAM Exit override          ===>  NONE         All, System, None


 When finished, press ENTER.




 PF1=Help      3=Quit      6=Cancel Exits      9=Error List

A common way of using this display is to set the terminal trace status for a particular terminal to SPECIAL, to have all of the STANDARD component trace flags as level-1 only, and the SPECIAL component trace flags as level-1 and level-2. In this way, all tasks run from the SPECIAL terminal have level-1 and level-2 tracing. All other tasks have level-1 tracing only.

For example, you can use SPECIAL tracing to trace a single transaction. You can do this by setting the "master system trace flag" OFF on the main CETR display. This turns STANDARD tracing OFF. (STANDARD tracing can also be turned off by coding SYSTR=OFF at system initialization.) You can then press PF4 for the "components trace options" screen, shown in Figure 192, where you select the levels of tracing for the required components under the heading "Special". Finally, on the "transaction and terminal trace" screen, shown in Figure 193, specify the transaction ID and a transaction status of SPECIAL.

This display can also be used to enable VTAM exit tracing and ZCP trace for specified terminal IDs or netnames. To set VTAM exit tracing in an AOR, enter the applid of the TOR as Netname and enter ON for the Terminal VTAM Exit Trace.

If dynamic LU alias is in operation for the CICS region, and you want to use VTAM exit tracing to trace the bind flows for an autoinstalled terminal, the NETNAME you specify should be the real network name. However, if you want to trace when the LU alias is known, specify the LUALIAS name. If the real network name is used, and there is more than one network using that name, the VTAM exit tracing is activated for each occurrence of the network name.

There are also fields that allow enabling of all nonterminal VTAM exits, and PF6 can be used to cancel all exit tracing.

Related tasks
Using CICS supplied transactions
CETR--trace control
Using component trace options
Using JVM trace options
Using CETR HELP panels
[[ Contents Previous Page | Next Page Index ]]