[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
BLIDISTRC
------------------------------------------------------------------------------
Function : Display overlaid procedure call trace
Syntax : BLIDISTRC([nuHandle])
Return : None
This function is used to display a trace of the overlays called to reach
the active overlay. This is to the exclusion of any code in the root. It
takes as an optional parameter the output destination file handle.
Since the names of overlays are not available at runtime, the call trace
will display overlay numbers for each overlay in the trace. These
overlay numbers are listed in the MAP file alongside the appropriate
overlay segments, so the MAP file may be used to identify the overlays
from their overlay numbers.
In the special case of Clipper, names of Clipper code overlays can be
made available at runtime using the BLINKER CLIPPER PROFILE ON command.
If this command is used then the trace displayed will contain the actual
procedure name rather than the overlay number, and the overlay number
will be displayed as before for non-Clipper overlays.
Example :
* Display a call trace (generic)
*
BLIDISTRC() && Send it to the default
An example of the output would be:
Called by : 00005
Called by : 00091
Called by : 00127
Example 2:
* Display a call trace (Clipper)
* with BLINKER CLIPPER PROFILE ON
*
BLIDISTRC() && Send it to the default
An example of the output would be:
Called by: REPGENDET
Called by: REPGENPAG
See Also:
BLINKER CLIPPER PROFILE
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson