IBM SC33-1686-02 Server User Manual


 
CETR—trace control
HELP panels for terminal and transaction
trace
If you press the help key (PF1) while viewing the terminal
and transaction trace screen, the following panels are
displayed:
CETR Help: CICS Terminal and Transaction Trace
FUNCTION OF THE TERMINAL AND TRANSACTION PANEL.
This panel has two main functions.
(1) To allow STANDARD/SPECIAL tracing to be set for tasks to be run from
particular terminals or with particular transaction ids. It is also
possible to suppress tracing for particular transaction ids.
STANDARD tracing tasks use the STANDARD component flags.
SPECIAL tracing tasks use the SPECIAL component flags.
See the help information for the component panel for more detail.
(2) To allow the setting of VTAM EXIT and ZCP tracing.
The current settings will be displayed if transaction id, terminal id
or netname are specified without other values.
Further help information follows:
1. VTAM EXIT trace.
2. ZCP trace.
3. Function key use on the terminal and transaction panel.
PF 3=End 8=Next ENTER=End
Figure 158. CETR transaction: Terminal and transaction HELP
panel (1)
CETR Help: CICS Terminal and Transaction Trace
(1) VTAM EXIT trace.
CICS VTAM EXIT tracing consists of entries on GTF made by the CICS
supplied VTAM exits that run asynchronously with the rest of CICS.
The exits that are related directly to a particular terminal have their
tracing activated by specifying the terminal id and/or netname and
setting ON in the Terminal VTAM Exit Trace field.
There are also non-terminal related exits for which tracing is enabled by
specifying SYSTEM in the VTAM Exit override field. A setting of ALL in
the exit override field will turn on exit tracing for all non-terminal
exits, and for all terminal exits for all terminals.
NOTES:
(a) Setting trace for any terminal related exit will also turn on trace of
all non-terminal related exits.
(b) CICS GTF tracing need not be STARTED (main panel) to use this facility.
(c) An unknown netname is assumed to be an autoinstall terminal.
(d) Pressing PF6 cancels all tracing from all exits.
(e) Connection name in the termid field causes setting of all sessions.
PF 3=End 7=Back 8=Next ENTER=End
Figure 159. CETR transaction: Terminal and transaction HELP
panel (2)
CETR Help: CICS Terminal and Transaction Trace
(2) ZCP TRACE
ZCP trace is the activate scan trace facility. Turning it on
for a particular terminal means that the activate scan routine
of the terminal control program (DFHZCP) will start to monitor
the activate scan queue for the Terminal Control Table Terminal
Entry (TCTTE) for that terminal.
When the TCTTE is found, indicating that there is activity on the
terminal, a trace entry is made for the activate scan ZCP routine.
PF 3=End 7=Back 8=Next ENTER=End
Figure 160. CETR transaction: Terminal and transaction HELP
panel (3)
CETR Help: CICS Terminal and Transaction Trace
(3) FUNCTION KEY USE ON THE TERMINAL AND TRANSACTION PANEL.
Key Name Function
ENTER Change Execute any Changes.
PF1 Help Display this help information.
PF3 Quit Return to main Trace Control panel.
PF6 Cancel Cancel all exit tracing. This turns off
VTAM EXIT tracing for all terminals and
for all the non-terminal EXITs.
PF9 Messages Display any messages created.
PF 3=End 7=Back ENTER=End
Figure 161. CETR transaction: Terminal and transaction HELP
panel (4)
Chapter 16. Trace control CETR 225