shpdeallc(3F)

NAME
     SHPDEALLC - Returns a memory block to the symmetric heap

SYNOPSIS
     POINTER (addr, A(1))
     INTEGER errcode, abort
     CALL SHPDEALLC(addr, errcode, abort)

DESCRIPTION
     SHPDEALLC returns a block of memory (allocated using SHPALLOC) to the
     list of available space in the symmetric heap.  To maintain symmetric
     heap consistency, all processing elements (PEs) in a program must call
     SHPDEALLC with the same value of addr; if any PEs are missing, the
     program hangs.

     The SHPDEALLC function accepts the following arguments:

     Argument       Description
     addr           First word address of the block to deallocate (input).
     errcode        Error code is 0 if no error was detected; otherwise, it
                    is a negative integer code for the type of error
                    (output).
     abort          Abort code.  Nonzero requests abort on error; 0
                    requests an error code (input).

     Error conditions are as follows:

     Code           Condition
     -3             Address is outside the bounds of the symmetric heap.
     -4             Block is already free.
     -5             Address is not at the beginning of the block.

SEE ALSO
     intro_shmem(3), shmalloc(3F), shpalloc(3F), shpclmove(3F)