LineList

Description

Provides a list of the lines in a routine included in a performance analysis model.

Applies to

ProfileRoutine object

Syntax

iinstancename.LineList ( list )

Argument

Description

instancename

Instance name of the ProfileRoutine object.

list

An unbounded array variable of datatype ProfileLine in which LineList stores a ProfileLine object for each line in the routine. This argument is passed by reference.


Return value

ErrorReturn. Returns one of the following values:

  • Success! -- The function succeeded

  • ModelNotExistsError! -- The model does not exist

Usage

Use this function to extract a list of the lines in a routine included in the performance analysis model. You must have previously created the performance analysis model from a trace file using the BuildModel function. Each line is defined as a ProfileLine object and provides the number of times the line was hit, any calls made from the line, and the time spent on the line and in any called functions. The lines are listed in numeric order.

Lines are not returned for database statements and objects. If line information was not logged in the trace file, lines are not returned.

Examples

This example gets a list of the routines included in a performance analysis model and then gets a list of the lines in each routine:

Long ll_cnt
ProfileLine lproln_line[]
 
lpro_model.BuildModel()
lpro_model.RoutineList(iprort_list)
 
FOR ll_cnt = 1 TO UpperBound(iprort_list)
    iprort_list[ll_cnt].LineList(lproln_line)
    ...
NEXT

See also

BuildModel