PROFILER
9.4B
The PROFILER instruction allows the collection of profiler data to be started/stopped under program control. The instruction uses the following format:
|
|
|
|
|
Where:
label
Optional. A Program Execution Label.
action
Required. A numeric variable or literal indicating an action value from the table below.
Flags Affected: none
Note the following:
The supported action values are:
|
Value |
Action |
|
0 |
Turn profiling off. |
|
1 |
Turn on profiling using normal profiler data format. |
|
2 |
Reset the profiling file. |
|
3 |
Turn on profiling using extended profiler data format. This mode can only be enabled when a program executing using a PLBSERVE runtime. If this command type is executed for any other runtime, the normal profiler data mode is actually used. |
The PROFILER instruction is ignored for any value other than 0, 1, 2 or 3.
When the {action} command type (1) is executed, the profiling data generated contains basic program information.
When the {action} command type (3) is executed, the profiling data generated contains the basic program information plus additional information that applies to an Application Server. If this command type is executed using a runtime other than an Application Server, only the basic program information is generated.
After the {action} command type of (1) or (3) has been executed the first time, the profiler data format remains the same until a program is terminated.
See Also: System Interface Instructions
|
|