Dynamically allocates shared memory.
call "CBL_ALLOC_SHMEM" using mem-pointer by value mem-size returning status-code
Using call prototype (see Library Routines - Key) | Picture (32-bit systems) | |
---|---|---|
mem-pointer | cblt-pointer | usage pointer. Must be level 01. |
mem-size | cblt-os-size | pic x(4) comp-5. |
status-code | See Library Routines - Key |
mem-size | The number of bytes of memory to allocate. |
mem-pointer | A pointer to the memory allocated. The allocated memory is not initialized. | ||||
status-code |
|
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.