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

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