Guardian Procedure Calls Reference Manual

POOL64_DIMINISH_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Summary
The POOL64_DIMINISH_ procedure releases an empty secondary segment (if one exists) from an
existing pool. If more than one secondary segment is empty, the one released is
implementation-dependent.
If a segment is released, a pointer to the start of the segment is returned along with the size of the
released segment. If no empty segment exists, a pointer to 0xFFFFFFFFFFFC0000 and a size of 0
is returned. If successful, the indicated segment is removed from the pool; the caller is responsible
for disposing of the memory area.
Syntax for C Programmers
#include <kpool64.h>
uint32 POOL64_DIMINISH_ ( NSK_POOL64_PTR pool_ptr
,void _ptr64 * _ptr64 *released_segment_ptr
,uint64 _ptr64 *released_segment_size );
Syntax for TAL Programmers
?SOURCE $SYSTEM.SYSTEM.KPOOL64
result := POOL64_DIMINISH_ ( pool_ptr ! i
,released_segment_ptr ! o
,released_segment_size ); ! o
Parameters
pool_ptr
input
INT .EXT64
pointer to a pool established by a call to the POOL64_DEFINE_ Procedure (page 959).
released_segment_ptr
output
EXT64ADDR .EXT64
points to a pointer that reports the start of the segment released from the pool.
released_segment_size
output
INT(64) .EXT64
points to an integer that reports the size of the released segment.
962 Guardian Procedure Calls (P)