Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-13
POOL_DEFINE_ Procedure
3 Bounds error. pool is in a read-only segment, or pool-size is larger than
the space available.
4 Invalid size.
pool-size is too small to allocate the minimum size pool
including the pool header.
5 Alignment error on
pool. pool is not in alignment with the selected
alignment.
6 Invalid alignment.
alignment is not 0, 4, 8, or 16.
pool input
INT .EXT:ref:*
specifies the address of the first word of the memory space to be used as the pool,
including the pool header. The address must be aligned according to
alignment; the default alignment is 8 bytes.
pool-size input
INT(32):value
specifies the 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
pool
plus the value of
pool-size. Pool space overhead and adjustments for
alignment do not cause the pool to extend past this boundary.
alignment input
INT:value
specifies the alignment of blocks allocated from the pool.
0 8 byte alignment
4 4 byte alignment
8 8 byte alignment
16 16 byte alignment (the default alignment)
On TNS processors, an 8-byte alignment is recommended.
On native processors, a smaller
alignment generates the most compact pool
with the least cache alignment, and a larger
alignment generates the least
compact pool with most cache alignment.
priv-only input
This parameter can only be used by a privileged caller.