CBL_ALLOC

Syntax:

call "CBL_ALLOC_SHMEM" using     mem-pointer
                       by value  mem-size
                       by value  flags
                       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)
`flags`	cblt-os-flags	pic x(4) comp-5
`status-code`	See Library Routines - Key

On Entry:

mem-size: The number of bytes of memory to allocate.
flags: Must be set to zero.

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 (applies to Windows environments only). The size for shared memory allocated using this routine is limited to a maximum of around 64000 bytes (applies to UNIX environments only).