Guardian Procedure Calls Reference Manual

error
output
INT .EXT:ref:1
indicates the outcome of the call:
No error.0
Required parameter missing.2
Invalid size. block-size is not within the valid range.4
Corrupt pool header.9
Unable to allocate space.10
Returned Value
INT(32)
The extended address of the first byte in the memory block obtained if the operation is successful,
and %37777000000D if an error occurs.
Considerations
NOTE: There are additional considerations for privileged callers.
POOL_GETSPACE_ and POOL_PUTSPACE_ do not check pool data structures on each call. A
process that destroys data structures or uses an incorrect address for a parameter can fail on a
call to POOL_GETSPACE_ or POOL_PUTSPACE_: a TNS process can get an instruction failure trap
(trap 1) or invalid address trap (trap 0); a native process can receive a SIGILL or SIGSEGV
signal.
Example
@pblock := POOL_GETSPACE_( pool, $UDBL( $LEN( pblock ) ) );
! get a pool block of PBLOCK size.
Related Programming Manual
For programming information about the POOL_GETSPACE_ memory-management procedure, see
the Guardian Programmer's Guide.
946 Guardian Procedure Calls (P)