Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (G)
Guardian Procedure Calls Reference Manual—522629-013
6-13
GETPOOL Procedure
(Superseded by POOL_* Procedures)
GETPOOL Procedure
(Superseded by POOL_* Procedures)
Summary
Considerations for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Considerations
Example
Related Programming Manual
Summary
The GETPOOL procedure obtains a block of memory from a buffer pool.
Considerations for C Programmers
•
You cannot call GETPOOL 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
Parameters
address returned value
EXTADDR
returns the extended address of the memory block obtained if the operation is
successful or returns -1D if an error occurred or
block-size is 0. (Values less
than -1D may be returned to privileged callers.)
Note. This procedure is supported for compatibility with previous software and should not be
used for new development. *POOL procedures are replaced by POOL_* procedures. There is
no one-for-one replacement.
address := GETPOOL ( pool-head ! i,o
,block-size ); ! i
Caution. address should be a simple INT(32) or EXTADDR variable; otherwise, the
assignment can alter the condition code.