Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)

Guardian Procedure Calls Reference Manual—522629-013

12-19

POOL_GETSPACE_ Procedure

Summary

Syntax for C Programmers

Syntax for TAL Programmers

Parameters

Considerations

Example

Related Programming Manual

Summary

The POOL_GETSPACE_ procedure obtains a block of memory from a buffer pool.

Syntax for C Programmers

•

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

Parameters

block returned value

INT(32)

returns the extended address of the first byte in the memory block obtained if the

operation is successful, and returns %37777000000D if an error occurs.

pool input

INT .EXT:ref:*

is the address of the pool as specified in the call to the POOL_DEFINE_

procedure. When POOL_GETSPACE_ is called, the pool header is updated.

#include <cextdecs(POOL_GETSPACE_)>

__int32_t POOL_GETSPACE_ ( short *pool

,__int32_t block-size

,short *error );

block := POOL_GETSPACE_ ( pool ! i

,block-size ! i

,[ error ] ); ! o