PROFILER system handle

A handle to initialize and control the profiler. The output from the profiler provides processing time and call-tree information to locate bottlenecks. Developers can quickly identify where an application is spending the most processing time and navigate through the call tree to the potential bottlenecks.

Syntax

PROFILER [ :attribute | :method]

attribute

Specifies an attribute of the PROFILER handle.

method

Specifies a method of the PROFILER handle.

Attributes

Methods

Notes

The best practice for profiling applications during development is to use the Run > Run Configurations in Progress Developer Studio to enable and set the profiler properties on the Profiler tab. This automatically sets the profiler attributes and writes the output to a file which automatically opens in the Profiler view. For more information, see Profiler View.

Developers who want to instrument the profiler using the PROFILER system handle must set mandatory attributes, optional attributes, enable profiling, and write the profiler data to the designated output file. The order that attributes are set matters.

1. Set the ENABLED attribute.
2. Set the FILE-NAME attribute.
3. Set the DESCRIPTION attribute
4. Set the optional attributes: COVERAGE attribute, DIRECTORY attribute, LISTINGS attribute, STATISTICS attribute TRACE-FILTER attribute and TRACING attribute
5. Turn on profiling with the PROFILING attribute.
6. Write details with the WRITE-DATA( ) method
7. Turn off profiling when no longer needed with the PROFILING attribute.

The output file can be opened in the Profiler view in Progress Developer Studio.

See also

Profiler View, Profiler (-profile), Server-side profiling