Guardian Procedure Calls Reference Manual

POOL_GETSPACE_PAGE_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Summary
The POOL_GETSPACE_PAGE_ procedure obtains a block of memory from a buffer pool. The
memory is aligned on a page boundary and the space allocated is a multiple of a page size.
The POOL_GETSPACE_PAGE_ procedure is supported only in J-series and H-series RVUs.
Syntax for C Programmers
#include <cextdecs(POOL_GETSPACE_PAGE_)>
__int32_t POOL_GETSPACE_PAGE_ ( short *pool
,__int32_t block-size
,[ short *error ] );
• CEXTDECS (through the included file TNSINTH) defines 32-bit values as the typedef
__int32_t, which for TNS and TNS/R compiles is defined as long and for TNS/E compiles
is defined as int.
Syntax for TAL Programmers
block := POOL_GETSPACE_PAGE_ ( pool ! i
,block-size ! i
,[ error ] ); ! o
Parameters
pool
input
INT .EXT:ref:*
is the address of the pool as specified in the call to the POOL_DEFINE_ procedure. When
POOL_GETSPACE_PAGE_ is called, the pool header is updated.
error
output
INT .EXT:ref:1
indicates the outcome of the call:
No error.0
Required parameter missing.2
Invalid size. size is not within the valid range.4
Corrupt pool header.9
Unable to allocate space.10
POOL_GETSPACE_PAGE_ Procedure 947