Guardian Procedure Calls Reference Manual

RESIZEPOOL Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Related Programming Manual
Summary
The RESIZEPOOL procedure changes the size of a pool that was initialized by the DEFINEPOOL
procedure.
Syntax for C Programmers
#include <cectdecs(RESIZEPOOL)>
short RESIZEPOOL ( short *pool-head
,__int32_t new-pool-size );
• 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
error := RESIZEPOOL ( pool-head ! i,o
,new-pool-size ); ! i
Parameters
pool-head
input, output
INT .EXT:ref:19
is a 19-word pool header previously initialized through a call to the DEFINEPOOL procedure.
RESIZEPOOL updates this header to reflect the new pool size.
new-pool-size
input
INT(32):value
is the new size for the pool, in bytes. This number must be a multiple of 4 bytes and cannot
be less than 32 bytes or greater than 127.5 megabytes (133,693,440 bytes). The address of
the end of the pool is equal to the address of the beginning of the pool plus new-pool-size.
Pool space overhead and adjustments for alignment do not cause the pool to extend past this
boundary.
1250 Guardian Procedure Calls (R)