BLIMEMMAX()                   Get largest free CA-Clipper memory block
------------------------------------------------------------------------------

 Function : Get largest free CA-Clipper memory block

 Syntax   : nlValue = BLIMEMMAX()

 Return   : Size of largest free memory block in bytes.

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

 This can be used to prevent the failure of memory intensive operations such
 as MEMOEDIT() which require large blocks of contiguous memory for successful
 operation.

 Example:

    * Get the size of the largest available block
    *
    ? "The largest available block of memory is"
    ?? BLIMEMMAX(), "bytes"