Stores data in an allocated memory block.
Usage
CALL "M$PUT"
USING MEM-ADDRESS, DATA-ITEM,
DATA-SIZE, DATA-OFFSET
Parameters
MEM-ADDRESS USAGE POINTER
Must point to a memory area previously allocated by M$ALLOC.
DATA-ITEM Any data item
This is the data that will be stored in the memory block.
DATA-SIZE (optional) Numeric parameter
The number of bytes to move to the memory block. If omitted, then the number of bytes is set to the size of the memory block (excluding overhead bytes).
DATA-OFFSET (optional) PIC 9(n), USAGE DISPLAY or COMP-4
The location within the memory block from which to start the move. The first location is position "1". If omitted, this value defaults to "1".
Description
This routine copies DATA-ITEM into the memory pointed to by MEM-ADDRESS for DATA-SIZE bytes. Regardless of the value of DATA-SIZE, no bytes are copied that exceed the size of the memory block at MEM-ADDRESS.