Guardian Procedure Calls Reference Manual

PUTPOOL Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Considerations
Example
Related Programming Manual
Summary
The PUTPOOL procedure returns a block of memory to a buffer pool initialized by the DEFINEPOOL
procedure.
Syntax for C Programmers
#include <cextdecs(PUTPOOL)>
_cc_status PUTPOOL ( short *pool-head
,char *pool-block );
The function value returned by PUTPOOL, which indicates the condition code, can be interpreted
by the _status_lt(), _status_eq(), or _status_gt() function (defined in the file tal.h).
Syntax for TAL Programmers
CALL PUTPOOL ( pool-head ! i,o
,pool-block ); ! i
Parameters
pool-head
input, output
INT .EXT:ref:19
is the address of the pool head of the pool from which the block of memory was obtained
using GETPOOL.
pool-block
input
STRING .EXT:ref:*
is the address of the block to be returned to the pool.
Condition Code Settings
indicates that the data structures are invalid or that pool-block is not a block in the buffer pool.< (CCL)
indicates that the operation is successful.= (CCE)
is not returned from PUTPOOL.> (CCG)
1188 Guardian Procedure Calls (P)