Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-21
POOL_GETSPACE_PAGE_ Procedure (H-Series
RVUs Only)
Summary
The POOL_GETSPACE_ 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.
Syntax for C Programmers
•
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
Parameters
block returned value
INT(32)
returns the extended address of the first byte in the memory block obtained if the
operation is successful, and returns %37777000000D if an error occurs.
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:
0 No error.
2 Required parameter missing.
#include <cextdecs(POOL_GETSPACE_)>
__int32_t POOL_GETSPACE_ ( short *pool
,__int32_t block-size
,short *error );
block := POOL_GETSPACE_ ( pool ! i
,block-size ! i
,[ error ] ); ! o