Provides a list of the top-level entries included in a trace tree model.
TraceTree objects
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. |
ErrorReturn. Returns the following values:
Success! – The function succeeded
ModelNotExistsError! – The function failed because no model exists
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.
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 ...