Tracing individual QMF modules

You can turn on a trace for certain modules using the SET PROFILE command and the module DSQUTRAC.

Important: Run a trace at the module level only under the guidance of IBM® Software Support.
For example, you can trace the formatter buffer manager without tracing the line manager or the summary manager. The values for module-level tracing are:
  • A value of 3 provides a detailed trace for specific programs in a component, and traces entry and exit for all other programs in the component.
  • A value of 4 traces a module only.

To create a module-level trace, use the DSQUTRAC module to list the modules that you want to trace. Then assemble and link-edit the module. After the module is created, you must make it available. You can then run the following command: SET PROFILE (TRACE=F4

To trace only a specific module or set of modules, you must set the DSQEC_TRACE_MODULE global variable. In this variable, specify the name of the modules that you want to trace (you can specify up to six names separated by commas). Then, run the following command: SET PROFILE (TRACE=ALL. This will initiate tracing for only the modules specified in DSQEC_TRACE_MODULE. If you specify modules via the SET GLOBAL command from the command line, then module names must be enclosed in single quotes.

The value of the TRACE option in the QMF profile is ignored when you start QMF as a Db2® for z/OS® stored procedure. However, you can include a SET PROFILE (TRACE command in the initial procedure specified by the object-name parameter to change the level of trace detail for the duration of the stored procedure session as long as the L2-destination parameter is set to DSQDEBUG. When you issue a SET PROFILE command to change the trace settings, ensure that L2 is among the options specified on the SET PROFILE (TRACE command in the initial procedure if you want to continue tracing messages and commands.