Help panels for terminal and transaction trace, Cetr—trace control – IBM CICS Transaction Server for OS/390 SC33-1686-02 User Manual

Page 243

Advertising
background image

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

Advertising