BLIMEMUSE()                   Get amount of used memory in CA-Clipper Summer '87 memory area
------------------------------------------------------------------------------

 Function : Get the amount of used memory in the CA-Clipper Summer '87 memory
            area

 Syntax   : nlValue = BLIMEMUSE()

 Return   : Sum of the sizes of all the memory blocks marked as used.

 This function returns the size in bytes of all the dynamic memory currently
 in use. 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 amount of dynamic memory in use
    *
    ? BLIMEMUSE(), "bytes of dynamic memory are "
    ?? "currently in use"