OutgoingCallList PowerScript function
Description
Provides a list of the calls to other routines included in
a performance analysis model.
Controls
ProfileLine and ProfileRoutine objects
Syntax
|
1 |
<span>instancename</span><span>.OutgoingCallList</span><span></span> ( <span>list</span>, <span>aggregate</span> ) |
|
Argument |
Description |
|---|---|
|
instancename |
Instance name of the ProfileLine or ProfileRoutine |
|
list |
An unbounded array variable of datatype |
|
aggregate (ProfileRoutine |
A boolean indicating whether duplicate |
Return Values
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 |
Long ll_cnt |
|
1 |
ProfileCall lproc_call[] |
|
1 |
|
1 |
lpro_model.BuildModel() |
|
1 |
lpro_model.RoutineList(iprort_list) |
|
1 |
|
1 |
FOR ll_cnt = 1 TO UpperBound(iprort_list) |
|
1 |
iprort_list[ll_cnt].<span>OutgoingCallList</span>(lproc_call, & <br> TRUE) |
|
1 |
... |
|
1 |
NEXT |