Setting the trace for CICS

You set several parameters to set the trace in QMF for CICS®.


To specify tracing in QMF for CICS, follow these steps:

  1. Specify DSQSDBUG=ALL when starting QMF.
  2. Use the DSQSDBQT parameter to specify the type of storage to be used for the trace data.
    • Specify the value TS to use a CICS auxiliary temporary storage queue for tracing:
    • Use temporary storage for message-level tracing. Other types of tracing, such as ALL, capture more trace data and therefore require more storage. Use a transient data queue (a value of TD) if you think that the trace output could exceed the maximum size of a CICS temporary storage queue.
    • A transient data queue named DSQD is predefined for you during QMF installation. If you use the DSQSDBQN parameter to name the transient data queue something other than DSQD, you must predefine the queue in the CICS DCT before you use it for the first time.
  3. Use the DSQSDBQN parameter to specify the name of the CICS storage queue that will store the trace data.
    • DSQSDBQN specifies the name of the transient data or temporary storage queue that holds trace data.
    • Ensure that the queue name conforms to CICS specifications for the type of queue specified by DSQSDBQT. TD queues have names from 1 to 4 characters. TS queues have names from 1 to 8 characters.
    • You do not need to predefine temporary storage queues to CICS. For example, the following statement dynamically allocates a temporary storage queue named MYTRACE to hold trace data for the QMF session:
    • You must associate a transient data queue with a ddname. DSQDEBUG is the default name for the trace data set. QMF issues CICS ENQ and DEQ commands around single trace entries in the queue, so that a single queue can be used by more than one user.


After QMF starts, you can turn tracing off if necessary by using the command SET PROFILE (TRACE=NONE. You can also set more specific levels of trace detail using the SET PROFILE command.