Click above to get retro games delivered to your door ever month!

 BLIOVLCLR()
------------------------------------------------------------------------------
 Purpose:
 Clear unused CA-Clipper Summer '87 overlays from memory.

 Syntax:
 BLIOVLCLR()

 Parameters:
 None.

 Returns:
 None.

 Description:
 This function is only effective with the BLINKER OVERLAY DYNAMIC method
 of overlay allocation (CA-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 CA-Clipper.
 This may be used in the main module of an application to ensure that
 CA-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()