Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-26
POOL_RESIZE_ Procedure
11 Corrupt allocated blocks. Data is probably written beyond the allocated block.
12 Corrupt free list blocks. Data is probably written into a returned block.
13 Unable to shrink pool.
pool input
INT .EXT:ref:*
is the address of the pool as specified in the call to the POOL_DEFINE_
procedure. When POOL_RESIZE_ is called, the pool header is updated.
new-pool-size input
INT(32):value
specifies the new size of the pool, including the pool header, in bytes. The
maximum size is limited only by the amount of space available to the application.
The address of the end of the pool is always equal to the address specified for the
pool parameter plus the value of the new-pool-size parameter. Pool space
overhead and adjustments for alignment do not cause the pool to extend past this
boundary.
Considerations
See “Considerations” for the POOL_DEFINE_ procedure.
Example
error := POOL_RESIZE_ ( pool, 4096D );
Related Programming Manual
For programming information about the POOL_RESIZE_ memory-management
procedure, see the
Guardian Programmer’s Guide.