GDSX Manual

Service Routines
Extended General Device Support (GDSX) Manual–134303
8-31
GETEXTPOOL
For more information, see “Memory Pools” in Section 2.
address returned value
INT .EXT:value
is the relative extended address of area allocated, unless space was not available, in
which case a zero is returned.
pool input
INT:value
is the pool to allocate space for. The values of pool are as follows:
size input
INT:value
indicates the number of words to allocate.
Considerations
•
No mechanism for queuing of allocation requests or timeout is provided. For private
storage such a facility has no purpose because each task has its own individual pool.
•
A call to ^CHECKPOINT(2) checkpoints all local and extended memory pools
acquired by the calling task.
•
If poolcheck^flag of the DEBUGFLAGS configuration parameter is set, each time a
task is dispatched, TSCODE checks the buffer pool, message pool, extended buffer
pool, and extended message pool for corruption. If corruption is detected, GDSX
stops with abend error 230 or abend error 231. This pool checking is in addition to
that always done when the GETLOCALPOOL and GETEXTPOOL procedures are
called.
The poolcheck^flag can be set when debugging a program and turned off during
production to allow GDSX to run more efficiently.
address := GETEXTPOOL ( pool !
i
,size ); !
i
1 Shared extended pool
2 Private extended pool
10 Extended buffer pool
11 Extended message pool