Activating the CLIST trace facility

The CLIST trace facility writes a stream of messages to the terminal while DB2I executes. To use this facility, familiarity with TSO CLISTs is recommended.

Procedure

To activate the CLIST trace facility:

  1. Invoke the DB2I primary menu (DSNEPRI).
  2. Select OPTION 0, which is not shown on the menu.
  3. Press ENTER to pass by the panel that introduces the Db2 TSO MAINTENANCE SYSTEM. The next panel provides choices between several TSO attachment facility tracing mechanisms.
  4. Specify SYMLIST on the TRACE CLISTS option. This traces the most events.

    The options on the TRACE CLISTS line are the same as those that can be specified on the CLIST CONTROL statement.

    • Selecting LIST is equivalent to specifying CONTROL LIST; it traces TSO commands in the CLISTs.
    • Selecting CONLIST is equivalent to specifying CONTROL LIST CONLIST; it traces TSO commands in the CLISTs and each CLIST statement before variable substitution occurs.
    • Selecting SYMLIST is equivalent to specifying CONTROL LIST CONLIST SYMLIST; it traces TSO commands in the CLISTs, each CLIST statement before variable substitution occurs, and each CLIST statement after variable substitution occurs.
  5. Run the application, and the CLIST trace messages display.

Results

If the CLIST tracing indicates a call to the DSN command processor that seems to have caused an error, then run the job again with DSN tracing set to a value greater than 100. Receiving messages from both the DSN and CLIST trace streams help IBM® Support resolve the problem.

Trace messages must be viewed online; they cannot be sent to a data set.