GDSX (Extended General Device Support) Manual

Service Routines
Extended General Device Support (GDSX) Manual—529931-001
8-34
GET^ITC^FCB
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(32):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[X]
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.
GET^ITC^FCB
This procedure allows a task to send ITC messages to other tasks. A task can send
an ITC message to another task only after it has the FCB address of the receiving task.
To obtain the FCB address, the sending task calls GET^ITC^FCB once for each task it
will send an ITC message to.
1 Shared extended pool
2 Private extended pool
10 Extended buffer pool
11 Extended message pool