BLIMEMUSE        (Clipper Summer '87)
------------------------------------------------------------------------------

  Function : Get amount of used memory in 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 Clipper to store
  all temporary values of variables and buffers while an application is
  running.

  Note that the 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 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"