Updating a temporary data object

After making changes in a window to a temporary object, you can update the object with those changes. You must identify the object and must specify the range of blocks that you want to update. To be updated, a block must be mapped to a window and must contain changes in the window. Window services replaces each block within the specified range with the corresponding changed block from a window.

To update a temporary object, call CSRSCOT. For a description of the CSRSCOT parameters and return codes, see CSRSCOT — Save object changes in a scroll area.

To identify the object, you must supply an object identifier for object_id. The value you supply for object_id must be the same value CSRIDAC returned in object_id when you requested access to the object.

To identify the blocks in the object that you want to update, use offset and span. The values assigned to offset and span, together, define a contiguous string of blocks in the object:

The value assigned to offset specifies the relative block at which to start. An offset of 0 means the first block; an offset of 1 means the second block; an offset of 2 means the third block, and so forth.
The value assigned to span specifies the number of blocks to save. A span of 1 means one block; a span of 2 means two blocks, and so forth. A span of 0 has special meaning: it requests that window services update all changed blocks to which a window is mapped.

Window services replaces each block within the range specified by offset and span providing the block has changed and a window is mapped to the block.