CEMT INQUIRE AUXTRACE

Retrieve information about the status of auxiliary trace.

In the CICS Explorer, the Regions operations view provides a functional equivalent to this command.

Description

Auxiliary trace entries are made to a pair of CICS-controlled BSAM data sets, A and B.

You can use the INQUIRE AUXTRACE command to see the following information:

Whether the auxiliary trace data set is open or closed
Which auxiliary trace data set is active, Cur(A) or Cur(B)
Whether an auxiliary trace is in progress (started) or not (stopped).

You can start, stop, or pause tracing, and specify that automatic switching of the auxiliary data set occurs when needed. You can use the SWITCH option to change the data set.

Instead of using the SET command, you can overtype your changes on the INQUIRE screen after tabbing to the appropriate field (see Overtyping a display).

For information on using auxiliary tracing, see Trace destinations. See also the CETR transaction, CETR - trace control.

Input

Press the Clear key and type CEMT INQUIRE AUXTRACE (or suitable abbreviations for the keywords).

The resulting display is similar to the following example. To change any of the values shown, tab to the highlighted or blank fields and overtype them as required.

Sample screen

Figure 1. CEMT INQUIRE AUXTRACE screen

  I AUX
  STATUS:  RESULTS - OVERTYPE TO MODIFY
   Aux Cur(A) Sto

Note: When a value does not apply, or is negative (the value begins with No), the fields on the screen are blank. To modify these fields, locate them by tabbing (they appear in the same sequence as in the expanded format), and overtype with input valid for that field. You might find it more convenient to use the expanded format when setting one of these values.

If you place the cursor against the result and press ENTER, CICS® displays an expanded format as, shown in Figure 2.

Figure 2. The expanded display of an individual entry

 I AUX
 RESULT - OVERTYPE TO MODIFY
   Auxtrace
   Curauxds(A)
   Status( Stop )
   Switchstatus( Noswitch )
   Switchaction(              )

CEMT INQUIRE AUXTRACE

Displayed fields

AUXILIARY

Identifies this panel as relating to auxiliary trace.

CURAUXDS(value)

Displays a 1-character identifier of the current auxiliary data set, which can be A or B. This value is blank if there is no auxiliary trace data set.

STATUS(value)

Displays the status of auxiliary tracing in your CICS system. The values are as follows:

START: Auxiliary tracing is in progress (the auxiliary trace data set is open).
PAUSE: Auxiliary tracing has stopped, but the trace data set has been left open. A subsequent START request causes trace entries to be written immediately following those that were written before the PAUSE request.
STOP: Auxiliary tracing has stopped, and the trace data set is closed.

Note: You can reset this value by overtyping it with a different value.

SWITCHACTION(value) (input only field)

Specifies that the trace data set is to be switched. The value is:

SWITCH: Makes an immediate switch from the current auxiliary trace data set to the alternate trace data set.

SWITCHSTATUS(value)

Displays whether automatic data set switching occurs when the current auxiliary trace data set becomes full. The values are as follows:

NOSWITCH: Switching does not occur without operator intervention.
NEXT: Automatic switching occurs when the current trace data set is full, but not subsequently.
ALL: Automatic switching occurs as necessary until the end of this CICS session, without the need for operator intervention.

Note: You can reset this value by overtyping it with a different value.