You use the PowerScript functions and PocketBuilder objects listed in Table 26-10 to build a nested trace tree model of an application. You can use these functions only on the desktop.
Use this function |
With this object |
To do this |
|---|---|---|
SetTraceFileName |
TraceTree |
Set the name of the trace file to be analyzed. |
BuildModel |
TraceTree |
Build a trace tree model based on the trace file. You can pass optional parameters that let you track the progress of the build. |
EntryList |
TraceTree |
Get a list of the top-level entries in the trace tree model. |
GetChildrenList |
TraceTreeRoutine, TraceTreeObject, and TraceTreeGarbageCollect |
Get a list of the children of the routine or object—that is, all the routines called directly by the routine, or the destructor called as a result of the object's deletion. |
DestroyModel |
TraceTree |
Destroy the current trace tree model and all the objects associated with it. |
Each of these functions returns a value of type ErrorReturn.
Each TraceTreeNode object returned by the EntryList and GetChildrenList functions represents a single node in the trace tree model and contains information about the parent of the node and the type of activity it represents.
The following objects inherit from TraceTreeNode and contain additional information, including timer values:
TraceTreeError
TraceTreeESQL
TraceTreeGarbageCollect
TraceTreeLine
TraceTreeObject
TraceTreeRoutine
TraceTreeUser
