GDSX Manual

Service Routines
Extended General Device Support (GDSX) Manual–134303
8-30
GETEXTPOOL
When control is returned to P2, the data is checkpointed and the semaphore is
released, because p2^got^cp^sem is nonzero.
When P1 is called elsewhere, and the caller does not own the checkpoint semaphore,
P1 acquires the semaphore, checkpoints the data, and releases the semaphore.
GETEXTPOOL
This procedure allocates extended memory pool space for the calling task from one of
four extended memory pools:
•
Pool 1, the shared extended pool
•
Pool 2, the private extended pool
•
Pool 10, the extended buffer pool
•
Pool 11, the extended message pool
Before issuing a call to GETEXTPOOL for one of the four memory pools, you allocate
the maximum pool space to be used by setting the POOLSIZE configuration parameter.
The maximum size of the shared extended pool, pool 1, is established by setting
POOLSIZE with a TACL PARAM command or by setting the poolsize variable within
the USER^INIT^CONFIG^PARAMS user exit. POOLSIZE specifies the maximum
pool size in words that all user tasks may share. TSCODE allocates an extended
memory area of size POOLSIZE multiplied by 2 bytes for the shared extended pool.
The default for POOLSIZE is 16,392 words.
The maximum size of the private extended pool, pool 2, is established by setting the
TASKPOOLSIZE configuration parameter with a TACL PARAM command or by
setting the taskpoolsize variable within the USER^INIT^CONFIG^PARAMS user exit.
TASKPOOLSIZE specifies the maximum pool size in words that each user task is
allowed to acquire privately. TSCODE allocates an extended memory area of total size
(TASKPOOLSIZE * 2) multiplied by MAXTASKS bytes for all the private extended
pools. The default for TASKPOOLSIZE is 128 words.
The maximum size of the extended buffer pool, pool 10, is established by setting the
MAXBUFPOOL configuration parameter with a TACL PARAM command or by setting
the maxbufpoolsize variable within the USER^INIT^CONFIG^PARAMS user exit. The
default for MAXBUFPOOL is 32,000 bytes.
The size of the extended message pool, pool 11, is established by setting the
MAXMSGPOOL configuration parameter with a TACL PARAM command or by setting
the maxmsgpoolsize variable within the USER^INIT^CONFIG^PARAMS user exit.
The default for MAXMSGPOOL is 32,000 bytes.
Pool sizes can be viewed by an SCF INFO command. For example:
-> INFO $GDSX-process-name, DETAIL