Guardian Procedure Calls Reference Manual

POOL_GETSPACE_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Related Programming Manual
Summary
The POOL_GETSPACE_ procedure obtains a block of memory from a buffer pool.
Syntax for C Programmers
#include <cextdecs(POOL_GETSPACE_)>
__int32_t POOL_GETSPACE_ ( 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_ ( 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_ is called, the pool header is updated.
block-size
input
INT(32):value
is the size in bytes of the memory to be obtained from the pool. This value can range from 1
byte through the available space in the pool. The block size of the allocated block can be
rounded up to retain the alignment of the pool.
POOL_GETSPACE_ Procedure 945