Updating a permanent object on DASD

You can update a permanent object on DASD with changes that appear in a window or in the object’s scroll area. You must identify the object and specify the range of blocks that you want to update.

To update an object, call CSRSAVE. For a description of theCSRSAVE parameters and return codes, see CSRSAVE — Save changes made to a permanent object.

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

To identify the blocks of 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, or have been saved in the scroll area.