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

Page 240

Advertising
background image

CETR—trace control


The equal sign “=” can be used, when changing several
fields, to indicate that a particular field should be changed to
the same value as the one above.

The complete list of components is:

Components marked * are subcomponents of the AP
domain, and the trace entries for these components are
produced with a trace point ID of AP nnnn.

For information about the use of trace for problem
determination, and for information about the format of trace
entries, see the

CICS Problem Determination Guide.

Note: The SZ component can be used only if the Front End

Programming Interface feature (FEPI) is installed. For
information, see the

CICS Front End Programming

Interface User's Guide.

Note: If you use CETR to turn on tracing for a particular

component, CICS does not save modifications to the
component trace flags across any kind of CICS
restart.

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:

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

Figure 147. CETR transaction: transaction and terminal trace screen

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

Component

Title

AP

Application domain

|

BA

|

CICS business application manager for BTS

BF*

Built-in function support

BM*

BMS

BR

3270 Bridge

CP*

Common Programming Interface

DC*

Dump macro-compatibility

DD

Directory manager domain

|

DH

|

Document handling domain

DI*

Data interchange

DM

Domain manager domain

DS

Dispatcher domain

DU

Dump domain

EI*

Exec interface

|

EM

|

Event manager domain for BTS

FC*

File control

GC

Global catalog domain

IC*

Interval control

IS*

Intersystems communication and MRO

KC*

Task control macro-compatibility

KE

Kernel

LC

Local catalog domain

LD

Loader domain

LG

Log manager domain

LM

Lock manager domain

ME

Message domain

MN

Monitoring domain

NQ

Enqueue manager domain

PA

Parameter manager domain

PC*

Program control

PG

Program manager domain

RI

Resource manager interface (RMI)

RM

Recovery manager domain

|

RX

|

Recoverable EXCI domain

SC*

Storage control macro-compatibility

|

SH

|

Scheduler services domain for BTS

|

SO

|

Sockets domain

SM

Storage manager domain

SP*

Syncpoint

ST

Statistics domain

SZ

Front End Programming Interface

TC*

Terminal control

TD*

Transient data

TI

Timer domain

TR

Trace domain

TS

Temporary storage domain

UE*

User exit control

US

User domain

|

WB

|

Web interface

XM

Transaction manager

XS

Security manager domain

222

CICS Supplied Transactions

Advertising