TRACING attribute

Formats the output for TRACE-FILTER. Requires access to source code; not intended for use in production systems.

Data type: CHARACTER

Access: Readable/Writable

Applies to: PROFILER system handle

The initial value is an empty string (""). The value is a comma-separated list of procedure names and listing line numbers corresponding to specific ABL statements for which the profiler records detailed timing information. Each element in the list is procedure-name | line-number where procedure-name is the name of a main.p procedure (not an internal procedure) and line-number is the debug listing line number of the statement to be traced. The list elements are separated by commas.

If TRACING is set to an empty string (""), then the only tracing information that is recorded is what is specified by the PROFILER:TRACE-FILTER attribute. The TRACING list is examined by the profiler only as it is analyzing the data in the raw data temporary file in preparation for writing data to the output file. This examination usually occurs during PROFILER:WRITE-DATA() calls or at the end of the session. In theory, then the TRACING value can be set any time before the profiler writes the data for the session to its output file. However, when the raw data temporary file becomes too large, the profiler does a partial analysis on the fly. To avoid this, set the TRACING list before any statements to be traced are executed. Redundant entries in the PROFILER:TRACING are automatically removed.

See also

TRACE-FILTER attribute