Guardian Procedure Calls Reference Manual

POOL64_DEFINE_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Example
Summary
The POOL64_DEFINE_ procedure designates an allocated 64-bit memory address range to use
as the primary segment of a pool. The caller must allocate the memory space for the pool prior to
the call.
For availability of the POOL64_... procedures, see POOL32_... and POOL64_... Procedures
(page 953).
Syntax for C Programmers
#include <kpool64.h>
uint32 POOL64_DEFINE_ ( void _ptr64 *pool_address
,uint64 pool_size
,uint32 pool_options );
Syntax for TAL Programmers
?SOURCE $SYSTEM.SYSTEM.KPOOL64
result := POOL64_DEFINE_ ( pool_address ! i
,pool_size ! i
,pool_options ); ! i
NOTE: The header file KPOOL64 is available on systems running H06.24 and later H-series
RVUs and J06.13 and later J-series RVUs.
Parameters
pool_address
input
EXT64ADDR
specifies the address of the first byte of the memory to be used as a pool, including the pool
header. This address must be 16 byte aligned.
pool_size
input
INT(64)
specifies the initial size of the pool, including the pool header, in bytes, and must be a multiple
of 16. The maximum is limited only by the amount of space available for the application.
POOL64_DEFINE_ Procedure 959