Tracing a Module

To trace a module do the following:

• Define the tracepoints and data to be traced in the TSF.

• Invoke the Trace Customizer using the TSF as input.

  This produces two files, a TDF and a TFF.

• Put the TDF file in the same directory the module to trace resides, put the TFF file in a directory accessible by TRACEFMT. It is suggested that all TFF files reside in the same subdirectory, an example directory could be \OS2\SYSTEM\TRACE.

• Invoke the OS/2 TRACE command using the name of the TDF instead of the major code value.

  This activates the tracepoints, causing the trace data to be saved in the system trace buffer.

• The OS/2 TRACE command can be used to turn tracing off at any time.

• To display the contents of the trace buffer, invoke the OS/2 TRACEFMT command.

  TRACEFMT uses the major code to determine the TFF file and uses the formatting string corresponding to the minor code value to format the data in the RAS trace buffer and output it to the screen, file or printer.