[<<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