MA_INQUIRE_HEAP


     NAME
	  MA_inquire_heap - find out how much free space is available
	  in the heap region

     C SYNOPSIS
	  #include "macdecls.h"

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

     FORTRAN SYNOPSIS
	  #include "mafdecls.h"

	  integer function MA_inquire_heap(datatype)
	      integer	  datatype

     DESCRIPTION
	  MA_inquire_heap() returns the	maximum	number of elements of
	  type datatype	that can currently be allocated	in the heap,
	  in a single allocation request, with respect to the
	  partition defined at initialization.

     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_avail(3), MA_inquire_stack(3)

     AUTHOR
	  Gregory S. Thomas, Pacific Northwest Laboratory