CETR--trace control

Use CETR to control CICS tracing activity.

Start the transaction by typing CETR on the command line of your display, as follows:

CETR

Press the ENTER key.

You get the following display, with the values of your own system in each of the fields.

Figure 191. CETR transaction: initial screen
 CETR                    CICS Trace Control Facility           

 Type in your choices.

 Item                              Choice       Possible choices

 Internal Trace Status       ===>  STARTED      STArted, STOpped
 Internal Trace Table Size   ===>  16      K    16K - 1048576K

 Auxiliary Trace Status      ===>  STOPPED      STArted, STOpped, Paused
 Auxiliary Trace Dataset     ===>  B            A, B
 Auxiliary Switch Status     ===>  NO           NO, NExt, All

 GTF Trace Status            ===>  STOPPED      STArted, STOpped

 Master System Trace Flag    ===>  ON           ON, OFf
 Master User Trace Flag      ===>  ON           ON, OFf

 When finished, press ENTER.




 PF1=Help    3=Quit    4=Components    5=Ter/Trn    6=JVM    9=Error List

Any of the input fields can be overtyped with the new values that you require. When you press ENTER, CETR issues the necessary commands to set the new values. If there are any errors, PF9 can be pressed to display the error messages. If there is only one short error message, it appears near the bottom of this display.

The following table shows the relationships between the auxiliary trace status, trace flag, and trace data set.

Table 10. The meanings of auxiliary trace status values
Auxiliary tracing status Auxiliary trace flag Auxiliary trace data set
Started On Open
Paused Off Open
Stopped Off Closed

Three other main functions of CETR are:

  1. Setting the component trace options (press PF4)
  2. Setting the transaction and terminal trace options (press PF5).
  3. Setting the JVM trace options (press PF6).

Start of changeUse caution when setting TRTABSZ to a very high value because there must be enough MVS page storage to satisfy both the request and DSA sizes. The system command DISPLAY ASM MVS can be used to display current information about status and utilization of all MVS page data sets.End of change

For information about the use of the various CETR options as an aid to problem determination, see the CICS® Problem Determination Guide.

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