Specifies a comma-separated list of procedure names for which the profiler records detailed timing information. 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 expression patterns are interpreted in the same way as does the ABL built-in MATCHES() function. If a procedure name matches one of the patterns on the list, then the profiler records detailed timing information for every executable line in that procedure. The pattern matching is not case sensitive.
In addition to recording summary timing data for each executable line, TRACE-FILTER records timing information each time a statement is executed. With this detailed information, a complete execution trace for the application can be established.
If the value of TRACE-FILTER is " ", then the pattern does not match any procedure names. When no procedure names are matched, the only tracing information the profiler records is what is specified by the PROFILER:TRACING attribute. If the value is "*", then the pattern matches all procedure names.
Examples:To get tracing information for all enable_UI procedures, set TRACE-FILTER to "enable_UI *". To get tracing information for all enable_UI procedures and also all executable lines in the procedure hello.p, set TRACE-FILTER to "enable_UI*,*hello.p".
The TRACE-FILTER patterns are examined by the profiler only as it analyzes the data in the raw data temporary file, in preparation for writing data to the output file. This usually occurs during PROFILER:WRITE-DATA() calls or at the end of the session. In theory, the TRACE-FILTER 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 TRACE-FILTER pattern before any procedure intended to match the pattern is run. Redundant entries in the PROFILER:TRACE-FILTER list are automatically removed.