NAME

cxDataAllocErrorGet - return data memory allocation error

C SPECIFICATION

#include <cx/DataAccess.h>

int cxDataAllocErrorGet ()

FORTRAN SPECIFICATION

integer function cxDataAllocErrorGet

FUNCTION RETURN VALUE

cxDataAllocErrorGet returns data allocation error flag, zero denoting no error, non-zero for error.

DESCRIPTION

cxDataAllocErrorGet returns non-zero if some other routine call has attempted to allocate data memory and failed. IRIS Explorer data structures are allocated from a shared memory arena on Silicon Graphics workstations running IRIX. This shared memory is a limited resource, so it is possible for the memory to be exhausted, causing allocation routines to fail. The data allocation routines that may fail for this reason are listed below:

cxConnDup		cxLatNew
cxConnEleSet		cxLatRootNew
cxConnNew		cxParamDoubleNew
cxCoordDefaultNew	cxParamLongNew
cxCoordDup		cxParamNew
cxCoordNew		cxParamStrNew
cxDataDup		cxParamStrSet
cxDataNew		cxPyrDup
cxGeoNew		cxPyrLayerSet
cxLatCoordNew		cxPyrNew
cxLatDataNew		cxUnkDup
cxLatDescSet		cxUnkNew
cxLatDup		cxVecDup

In addition, all geometry creation and modification may allocate data memory.

cxDataAllocErrorGet should be called after each routine that attempts to allocate data memory. A more detailed description of how modules should be written to cope with a limited amount of data memory can be found in Appendix B of the IRIS Explorer Module Writer's Guide.

NAME

C SPECIFICATION

FORTRAN SPECIFICATION

FUNCTION RETURN VALUE

DESCRIPTION

SEE ALSO