Chapter 26: Tracing and Profiling Applications

Analyzing structure and flow using a trace tree model

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.

**Table 26-10: Functions for analyzing program structure and flow**
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.

Inherited objects

The following objects inherit from TraceTreeNode and contain additional information, including timer values:

TraceTreeError
TraceTreeESQL
TraceTreeGarbageCollect
TraceTreeLine
TraceTreeObject
TraceTreeRoutine
TraceTreeUser

Using BuildModel to build a trace tree model

View this book as PDF