BLIOVLCLR        (Clipper Summer '87 )
------------------------------------------------------------------------------

  Function : Clear unused overlays from memory

  Syntax   : BLIOVLCLR()

  Return   : None

  This function is only effective with the BLINKER OVERLAY DYNAMIC method
  of overlay allocation (Clipper Summer '87 only).  It performs no
  function with the BLINKER OVERLAY FIXED method of overlay allocation.

  This function is used to force the Blinker overlay manager to clear out
  or discard all inactive overlay procedures from the overlay pool and
  return the memory used by them to Clipper.

  This may be used in the main module of an application to ensure that
  Clipper has the maximum amount of dynamic memory available before
  executing another overlay.

  Once all inactive overlays are flushed, the overlay pool operating size
  is reset to a maximum of the default size or the total size of the
  active overlays. The default size when the application starts is the
  most recent of the link time BLINKER OVERLAY OPSIZE <size> command or
  the /OOnn parameter in the BLINKER environment variable.

  Example  :
  *  Clear all inactive overlays
  *
  BLIOVLCLR()