OutgoingCallList
PowerScript function
Description
Provides a list of the calls to other routines included in a
performance analysis model.
Applies to
ProfileLine and ProfileRoutine objects
Syntax
|
1 |
instancename.OutgoingCallList ( list, aggregate ) |
|
Argument |
Description |
|---|---|
|
instancename |
Instance name of the ProfileLine or ProfileRoutine |
|
list |
An unbounded array variable of datatype ProfileCall in |
|
aggregate (ProfileRoutine only) |
A boolean indicating whether duplicate routine calls will |
Return value
ErrorReturn. Returns one of the following values:
-
Success! — The function succeeded
-
ModelNotExistsError! — The model does not exist
Usage
You use the OutgoingCallList function to extract a list of the calls
from a line and/or routine to other routines in a performance analysis
model. You must have previously created the performance analysis model
from a trace file using the BuildModel function. Each caller is defined as
a ProfileCall object and provides the called routine and the calling
routine, the number of times the call was made, and the elapsed time. The
routines are listed in no particular order.
The aggregate argument indicates whether duplicate routine calls
result in the creation of a single or of multiple ProfileCall objects.
This argument has no effect unless line tracing is enabled and a calling
routine calls the current routine from more than one line. If aggregate is
true, a new ProfileCall object is created that aggregates all calls from
the calling routine to the current routine. If aggregate is false,
multiple ProfileCall objects are returned, one for each line from which
the calling routine called the called routine.
Examples
This example gets a list of the routines included in a performance
analysis model and then gets a list of the routines called by each
routine:
|
1 2 3 4 5 6 7 8 9 10 11 |
Long ll_cnt ProfileCall lproc_call[] lpro_model.BuildModel() lpro_model.RoutineList(iprort_list) FOR ll_cnt = 1 TO UpperBound(iprort_list) iprort_list[ll_cnt].OutgoingCallList(lproc_call, & TRUE) ... NEXT |
See also