EntryList

Description

Provides a list of the top-level entries included in a trace tree model.

Applies to

TraceTree objects

Syntax

instancename.EntryList ( list )

Argument

Description

instancename

Instance name of the TraceTree object.

list

An unbounded array variable of datatype TraceTreeNode in which EntryList stores a TraceTreeNode object for each top-level entry in the trace tree model. This argument is passed by reference.


Return value

ErrorReturn. Returns the following values:

  • Success! -- The function succeeded

  • ModelNotExistsError! -- The function failed because no model exists

Usage

You use the EntryList function to extract a list of the top-level entries or nodes included in a trace tree model. Each top-level entry listed is defined as a TraceTreeNode object and provides the type of activity represented by that node.

You must have previously created the trace tree model from a trace file using the BuildModel function.

Examples

This example gets the top-level entries or nodes in a trace tree model and then loops through the list extracting information about each node. The of_dumpnode function takes a TraceTreeNode object and a level as arguments and returns a string containing information about the node:

TraceTree ltct_model
TraceTreeNode ltctn_list[], ltctn_node
Long ll_index,ll_limit
String ls_line

ltct_model = CREATE TraceTree
ltct_model.BuildModel()
ltct_model.EntryList(ltctn_list)
ll_limit = UpperBound(ltctn_list)
FOR ll_index = 1 TO ll_limit
   ltctn_node = ltctn_list[ll_index]
   ls_line += of_dumpnode(ltctn_node,0)
NEXT
...

See also

BuildModel