FLUSH ... a utility to flush pages of closed files out of memory.       
                                                                        
This allows for repeatable timing tests involving files.                
                                                                        
Allegro Consultants believes this to be safe to run, but makes no       
warranty or guarantee of any kind.                                      
                                                                        
Uses: sm_get_oldest_gufd, vsm_deallocate_gu_fd                          
      reset_critical, and set_critical                                  
                                                                        
INFO options:                                                           
                                                                        
   ALL            (off by default)                                      
      Sets COUNTS and VERBOSE.                                          
                                                                        
   [no]COUNTS     (off by default)                                      
      Reports number of pages inuse (and unused) before and             
      after flushing.                                                   
                                                                        
   [no]DOTS       (on by default for interactive users)                 
      Print a dot (.) for each file flushed.                            
                                                                        
   HELP                                                                 
      Prints this help information, and terminates.                     
                                                                        
   Quiet          (off by default)                                      
      Turns off DOTS and VERBOSE.                                       
                                                                        
   Verbose        (off by default, when on overrides DOTS)              
      Print name and GUFD for each file flushed.                        
                                                                        
Example of VERBOSE output:                                              
                                                                        
   GUFD addr  File Label Addr  Filename                                 
   ---------  ---------------  ------------------------                 
   $ca0525c0  $0011.$00581420  (nameless)                               
   $ca05c82c  $00d4.$000d1a20  /ALLEGRO/PUB                             
   $ca0186cc  $00d0.$0033e420  /ROBELLE/PUBNEW                          
   $ca01d0a0  $00d0.$00012020  /ROBELLE/PUB                             
   $ca030858  $0011.$00157220  /ROBELLE//$GROUP_NODE                    
   $ca02e92c  $0011.$002f1c20  /SYS/PUB/PASCNTL                         
                                                                        
Note: checks MPE/iX version, and will not run on a version that         
is unknown.                                                             
                                                                        
Example with COUNTS:                                                    
                                                                        
   :run flush.pub;info="counts"                                         
                                                                        
   FLUSH [20021102]  Copyright (c) 1993 Allegro Consultants, Inc.       
   Author: Stan Sieler                         sieler@gmail.com         
                                                                        
   Memory usage before flushing:                                        
     Memory:  22,527 4K inuse pages (88.0 MB out of 88 MB)              
                   1 unused pages   ( .0 MB)                            
                                                                        
   ..............................................................       
   ..............................................................       
   ..............                                                       
   Flushed 160 files.                                                   
                                                                        
   Memory usage after flushing:                                         
     Memory:  20,770 4K inuse pages (81.1 MB out of 88 MB)              
               1,758 unused pages   (6.9 MB)                            

FLUSH   20150128      Copyright (c) 1993 Allegro Consultants, Inc.