Guardian Procedure Calls Reference Manual

DEFINEPOOL Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Related Programming Manual
Summary
The DEFINEPOOL procedure designates a portion of a user's stack, global data or a data segment
for use as a pool. It initializes the pool for use with the GETPOOL, PUTPOOL and RESIZEPOOL
procedures.
NOTE: These procedures are supported for compatibility with previous software and should not
be used for new development. The ...POOL procedures were superseded by POOL_... procedures,
which are now superseded for TNS/E native callers; see POOL32_... and POOL64_... Procedures
(page 953). There is no one-for-one replacement.
Syntax for C Programmers
#include <cextdecs(DEFINEPOOL)>
short DEFINEPOOL ( short *pool-head
,short *pool
,__int32_t pool-size );
• CEXTDECS (through the included file TNSINTH) defines 32-bit values as the typedef
__int32_t, which for TNS and TNS/R compiles is defined as long and for TNS/E compiles
is defined as int.
Syntax for TAL Programmers
status := DEFINEPOOL ( pool-head ! o
,pool ! i
,pool-size ); ! i
Parameters
pool-head
output
INT .EXT:ref:19
is a 19-word array to be used as the pool header; GETPOOL and PUTPOOL use this array to
manage the pool. An even-byte address must be specified.
274 Guardian Procedure Calls (D-E)