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:
- Invoke the DB2I primary menu (DSNEPRI).
- Select OPTION 0, which is not shown on the menu.
- 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.
- 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.
- 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.