MA_INQUIRE_AVAIL


     NAME
	  MA_inquire_avail - find out how much free space is available
	  between the heap and stack regions

     C SYNOPSIS
	  #include "macdecls.h"

	  Integer MA_inquire_avail(datatype)
	      Integer	  datatype;	  /* read-only */

     FORTRAN SYNOPSIS
	  #include "mafdecls.h"

	  integer function MA_inquire_avail(datatype)
	      integer	  datatype

     DESCRIPTION
	  MA_inquire_avail() returns the maximum number	of elements of
	  type datatype	that can currently be allocated	in the space
	  between the heap and stack, in a single allocation request,
	  ignoring the partition defined at initialization.

	  Note that this might not be the largest piece	of memory
	  available; the heap may contain deallocated blocks that are
	  larger.

     DIAGNOSTICS
	  MA not yet initialized
	       MA_init() must be called	before this routine is called.
	  invalid datatype: %d
	       datatype	must be	one of those listed in macdecls.h or
	       mafdecls.h.

     RETURN VALUE
	  C: The number	of elements, as	described above.
	  FORTRAN: The number of elements, as described	above.

     SEE ALSO
	  MA(3), MA_inquire_heap(3), MA_inquire_stack(3)

     AUTHOR
	  Gregory S. Thomas, Pacific Northwest Laboratory