The Profiling object is used to analyze the performance of a PowerBuilder application. It provides a performance analysis model listing all the routines (both functions and events) logged in a given trace file. It includes the functions you call to name the trace file to be analyzed, build the model, and list the classes and routines included in the model. You use the Profiling object in conjunction with the ProfileCall, ProfileClass, ProfileLine, and ProfileRoutine objects.
The Profiling object has no events.
|
Profiling property |
Datatype |
Description |
|---|---|---|
|
ApplicationName |
String |
The name of the application used to generate the trace file. |
|
ClassDefinition |
PowerObject |
An object of type PowerObject containing information about the class definition of the object or control. |
|
CollectionTime |
Decimal |
The amount of time taken (in seconds) by the collection of trace data. This time has already been accounted for in the timestamps from the trace file (that is, the proper amount of time is subtracted from the timestamps before they are put in the trace file). If no model has been created, NULL is returned. |
|
NumberOfActivities |
Long |
The total number of activities that exist in the trace file. The value is 0 if this property is called before the trace file name is set. |
|
TraceFileName |
String |
The name of the trace file to use to build the model. The value is an empty string if the name has not been successfully set. |
|
Profiling function |
Datatype returned |
Description |
|---|---|---|
|
ErrorReturn (enumerated) |
Builds a performance analysis model based on the previously specified trace file |
|
|
ErrorReturn (enumerated) |
Provides a list of the classes (defined as ProfileClass objects) included in the model |
|
|
String |
Returns the name assigned to the object |
|
|
ErrorReturn (enumerated) |
Destroys the current performance analysis model |
|
|
Integer |
Creates a reference to a context-specific instance of the specified service |
|
|
PowerObject |
Returns a reference to the name of the parent object |
|
|
ErrorReturn (enumerated) |
Provides a list of the routines (defined as ProfileRoutine objects) included in the model |
|
|
ErrorReturn |
Indicates the name of the trace file to use for analysis and validates the header format |
|
|
ProfileRoutine |
Provides the routine node (defined as a ProfileRoutine object) representing the system root |
|
|
Object (enumerated) |
Returns the type of the object |
