BLIMEMAVL()                   Get CA-Clipper total free dynamic memory
------------------------------------------------------------------------------

 Function : Get CA-Clipper total free dynamic memory

 Syntax   : nlValue = BLIMEMAVL()

 Return   : Total available memory in bytes.

 This function returns the total dynamic memory available in bytes in the
 CA-Clipper free pool. Dynamic memory is the memory used by CA-Clipper to
 store all temporary values of variables and buffers while an application is
 running.

 Note that the CA-Clipper Summer '87 free pool is allocated from DOS on an
 'as-needed' basis, and unless MEMORY(0), BLIMEMPAK(-1) or BLIMEMBLK() are
 executed (which cause CA-Clipper to allocate all available memory to the
 free pool from DOS), the value returned by this function will reflect only
 the currently allocated free pool.

 Example:

    * Get the total available memory
    *
    ? "There are", BLIMEMAVL()
    ?? " bytes available in CA-Clipper's free pool"