The IDEDBG emitter is provided to allow trace records to be output by a debugger, such as Net Express or Visual Studio, at the point which they occur in the application being debugged.
To enable the IDEDBG emitter, specify the following statement in the Consolidated Tracing Facility configuration file:
mftrace.dest = IDEDBG
To use this emitter with the Net Express IDE, you must set the MFTRACE_CONFIG environment variable on the Environment Variables tab of the Configure IDE Environment dialog box. Trace events appear in the Debug messages tab when the application is debugged.
To use this emitter with a third-party debugger such as Visual Studio, you must set the MFTRACE_CONFIG environment variable in the environment before the debugger process is started. Trace events appear in the debugger‘s window where other system debug events would normally be displayed. For example, under Visual Studio 6, debug messages are displayed in the Debug tab.
The following table lists the properties you can set to control the behavior of the IDEDBG emitter:
Property | Description | Default | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
DELIMCHAR | The character used in the output file to delimit trace data parts for a trace event. | Space | ||||||||||||||||||||||||
FORMAT | The format to be used for each trace data record written
to the file. You can use the following pseudo-variables in the format
specification:
|
$(TIME) $(COMPONENT) $(EVENT) $(LEVEL)$(DATA) | ||||||||||||||||||||||||
LEVEL | The trace level below which this emitter
will not output trace records:
|
3 | ||||||||||||||||||||||||
HEXBLOCKSIZE | The number of hexadecimal bytes to be output in each
block when outputting binary trace data. Each block of hexadecimal characters
will be separated by a '-' character. For example, if HEXBLOCKSIZE is set to 4,
and some binary trace data with the value 3132333435363738393A3B3C3D3E3F is
specified for output, it would be formatted as follows:
31323334-35363738-393A3B3C-3D3E3F |
8 | ||||||||||||||||||||||||
QUOTESTRING | Whether or not string trace data is to be output enclosed in double-quote characters. | TRUE |
Related Topics: