Guardian Procedure Calls Reference Manual

GETPOOL_PAGE_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Returned Value
Summary
The GETPOOL_PAGE_ procedure obtains a block of memory from a buffer pool. The memory is
aligned on a page boundary and the space allocated is a multiple of a page size.
The GETPOOL_PAGE_ procedure is supported only in J-series and H-series RVUs.
Syntax for C Programmers
You cannot call GETPOOL_PAGE_ directly from a C program, because it returns a value and also
sets the condition-code register. To access this procedure, you must write a "jacket" procedure in
TAL that your C program can call directly. For information on how to do this, see the discussion
of procedures that return a value and a condition code in the C/C++ Programmer's Guide. Note
that the POOL... procedures, which should be used in new development can be called directly
from C.
Syntax for TAL Programmers
address := GETPOOL ( pool-head ! i,o
,block-size ); ! i
Parameters
pool-head
input, output
INT .EXT:ref:19
is the pool head previously defined by a call to DEFINEPOOL.
block-size
input
INT(32):value
is the size, in bytes, of the memory obtained from the pool. The maximum value is %377770D.
To check data structures without getting any memory from the pool, set block-size to zero.
Condition Code Settings
indicates that block-size is out of range, or that the data structures are invalid; -1D is returned.< (CCL)
indicates that the operation is successful; extended address of block is returned if block-size is
greater than zero, or -1D is returned if block-size is equal to 0.
= (CCE)
indicates that insufficient memory is available; -1D is returned.> (CCG)
GETPOOL_PAGE_ Procedure 663