Enabling a Trace

Note: We recommend that you enable trace options only when directed to do so by Attachmate Technical Support. Specifically, avoid full tracing, SQL tracing, protocol tracing, or API tracing. The volume of logging data is so large it can dramatically slow performance of dbutility and fill up your hard disk. Compress files using a compression utility before you send them to Attachmate Technical Support for analysis. Very large trace files should be broken into manageable pieces with the splitter utility. For help on running the splitter utility, type splitter with no parameters.

The trace option controls the volume and type of information written to the trace file.

To enable a trace using dbutility

  1. Determine the type of trace you want. Then, add the value for each tracing option (see the table below), and use the result for nnnn.
  2. Specify the -t nnnn option using the following syntax:

    dbutility -t nnnn command

    where nnnn is a bit mask that specifies the tracing option.

    If you are not sure which tracing masks to use, use the -d option. This is the equivalent of -t 8191, which traces everything.

    You can enter other command-line options, such as -U, -P, and -D with the trace option. The order is not important as long as all dash (-) options precede each command line argument. (See dbutility Command-Line Options.)

  3. (Optional) To analyze performance, you can use an additional command line option, -m. This option includes a five-digit millisecond timer in all output messages. The timer is appended to the timestamp as (mmmmm).
  4. (Optional) To change the trace option when the DATABridge Client is running, use the commands explained in Controlling and Monitoring dbutility.

To enable a trace from the Client Console

  1. Do one of the following:
    • If the client isn't running, in the Explorer view, right-click the data source, select Advanced > Trace and Log Options, and select the trace options you want. When you start the client, the service will supply the appropriate trace options.
    • If the client is running, right-click the run and select Trace and Log Options. Select the tracing options you want and click OK.
  2. To stop tracing, clear your selections in the Trace and Log Options dialog box.