Using component trace options

The "Component Trace Options" display is produced by pressing PF4 on the main CETR display. You get the following display, with the values of your own system in each of the fields.

Figure 192. CETR transaction: component trace options screen
 CETR                    Component Trace Options                   CI41 IYAHZCCV

 Over-type where required and press ENTER.                         PAGE 1 OF 4
 Component Standard                           Special
 --------  -------------------------------    -------------------------------
   AP      1                                  1-2
   BA      1                                  1-2
   BM      1                                  1
   BR      1                                  1-2
   CP      1                                  1-2
   DC      1                                  1
   DD      1                                  1
   DH      1                                  1-2
   DM      1                                  1-2
   DS      1                                  1-2
   DU      1                                  1-2
   EI      1                                  1
   EJ      1                                  1-2
   EM      1                                  1-2
   FC      1                                  1-2
   GC      1                                  1-2
   IC      1                                  1

 PF:  1=Help   3=Quit   7=Back  8=Forward  9=Messages   ENTER=Change

PF7 and PF8 can be used to scroll backward and forward through the list of components. PF9 gives the error message list.

The trace levels for a particular component are represented by two values. One gives the active level of tracing for standard tracing; the other gives the level for special tracing. From the list of components, you can set the active level of tracing for standard and/or special tracing for each individual component. See the CICS® Problem Determination Guide for an explanation of standard and special tracing, and of tracing levels.

The values are in the range 1 through 32 for most components. In practice, you will normally want to use an active level of ‘1’ for any component, and you do this by overtyping (if necessary) the displayed value under the relevant heading for the required component.

In certain circumstances, if you have referred a problem to the IBM System Support Center staff, they may ask you to get a level ‘2’ trace. You will need to specify both level 1 and 2 to get all of the trace points that are needed.

You can specify a range of tracing levels--normally levels ‘1’ and ‘2’. You do this by overtyping the displayed value with ‘1-2’ or ‘1,2’.

Alternatively, you can type ‘ALL’ in upper or lower case under the relevant heading. Similarly, you can type ‘OFF’ to turn off the tracing for a particular component under either the ‘special’ or ‘standard’ heading.

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:

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
DP Debugging Profiles domain
DS Dispatcher domain
DU Dump domain
EI* Exec interface
EJ Enterprise Java domain
EM Event manager domain for BTS
FC* File control
GC Global catalog domain
IC* Interval control
IE ECI over TCP/IP domain
II IIOP domain
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
OT Object transaction services domain
PA Parameter manager domain
PC* Program control
PG Program manager domain
Start of changePIEnd of change Start of changePipeline manager domainEnd of change
PT Partner Management
RI* Resource manager interface (RMI)
RM Recovery manager domain
RX Recoverable EXCI domain
RZ Request streams domain
SC* Storage control macro-compatibility
SH Scheduler services domain for BTS
SJ JVM domain (but use JVM trace options screens to set JVM trace levels: see note below)
SM Storage manager domain
SO Sockets domain
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
Notes:
  1. 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.
  2. 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.
  3. The SJ domain, which controls JVM tracing, is a special case. As well as using the normal trace levels, the SJ domain uses trace levels 29-32. Trace levels 29-32 for the SJ component correspond to JVM Level 0 trace, JVM Level 1 trace, JVM Level 2 trace and JVM User trace respectively. You cannot use the component trace options screen to control JVM tracing; use the JVM trace options screens instead, as described in Using JVM trace options.
  4. 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.
  5. Start of changeFor the DS domain function CHANGE_MODE, a trace entry is generated if DS level 2 or 3 tracing is active.End of change

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.

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