Guardian Procedure Calls Reference Manual

POOL64_RESIZE_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Summary
The POOL64_RESIZE_ procedure shrinks or expands the size of a single-segment pool within the
same address space. The memory allocation for expanding the pool is the responsibility of the
caller before calling this procedure. If the pool has a secondary segment, this procedure fails. If
shrinking the pool and a chunk is in use above the address of the new size, the resize fails.
Syntax for C Programmers
#include <kpool64.h>
uint32 POOL64_RESIZE_ ( NSK_POOL64_PTR pool_ptr
,uint64 new_pool_size );
Syntax for TAL Programmers
?SOURCE $SYSTEM.SYSTEM.KPOOL64
result := POOL64_RESIZE_ ( pool_ptr ! i
,new_pool_size ); ! i
Parameters
pool_ptr
input
INT .EXT64
pointer to a pool established by a call to the POOL64_DEFINE_ Procedure (page 959).
new_pool_size
input
INT(64)
new size of the pool.
Returned Value
INT(32)
Outcome of the call:
POOL64_OK0
Successful completion.
POOL64_BOUNDS3
The memory being defined as a pool is not within this user's address bounds.
POOL64_INVALIDSIZE4
The capacity is too small to contain the header and one element.
POOL64_RESIZE_ Procedure 973