BLIMEMSIZ                   (Clipper Summer '87)
------------------------------------------------------------------------------

  Function : Get the size of the Clipper S'87 dynamic memory area

  Syntax   : nlValue = BLIMEMSIZ()

  Return   : Total size of the free pool in bytes

  This function returns the total size in bytes of the dynamic memory
  area. 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 total free pool size
  *
  ? "The total size of Clipper's free pool is"
  ?? BLIMEMSIZ(), " bytes"