Dynamically allocates shared memory.
Syntax:
call "CBL_ALLOC_SHMEM" using mem-pointer
by value mem-size
returning status-code
Parameters:
| |
Using call prototype (see
Key)
|
Picture
|
|
mem-pointer
|
cblt-pointer
|
usage pointer. Must be level 01.
|
|
mem-size
|
cblt-os-size
|
pic x(4) comp-5
or
pic x(8) comp-5 (64-bit native programs only)
|
|
status-code
|
See
Library Routines - Key
|
|
On Entry:
-
mem-size
- The number of bytes of memory to allocate.
On Exit:
-
mem-pointer
- A pointer to the memory allocated. The allocated memory is not initialized.
-
status-code
-
| 0
|
Successful allocation
|
| 157
|
Unable to allocate memory
|
Comments:
The memory allocated is not initialized to any value.
Updates to any shared memory allocated to this function are not serialized or protected by the run-time system; you should use semaphores to maintain the integrity of the data.
The maximum size of shared memory is restricted by the operating system and the run-time system. The run-time tunable, shared_memory_segment_size, can be used to set the maximum size. The default is 65536, and the minimum is 8192 bytes.