CSRSAVE — Save changes made to a permanent object

To update specified blocks of a permanent object with changes, call CSRSAVE. The changes can be in blocks that are mapped to the scroll area, in blocks that are mapped to windows, or in a combination of these places.

Note: You cannot use CSRSAVE to save changes made to a temporary object. If you call CSRSAVE for a temporary object, CSRSAVE ignores the request and returns control to your program with a return code of 8. To save changes made to a temporary object, call CSRSCOT.

Code the CALL following the syntax of the high-level language you are using and specifying all parameters in the order shown below. For parameters that CSRSAVE uses to obtain input values, assign values that are acceptable to CSRSAVE. For parameters that CSRSAVE ignores, assign any value that is valid for the particular parameter’s data type.

Assign values, acceptable to CSRSAVE, to object_id, offset, and span. CSRSAVE ignores other parameter values. CSRSAVE returns values in new_hi_offset, return_code, and reason_code.

CALL statement

Parameters

CALL CSRSAVE

(object_id
,offset
,span
,new_hi_offset
,return_code
,reason_code)

object_id

Specifies the object identifier. Supply the same object identifier that CSRIDAC returned when you obtained access to the object.

Define object_id as character data of length 8.

,offset

Specifies the offset into the object in blocks of 4096 bytes. A value of 0 specifies the first block of 4096 bytes or bytes 0 to 4095 of the object; a value of 1 specifies the second block of 4096 bytes, or bytes 4096 to 8191 of the object, and so forth.

Define offset as integer data of length 4.

offset and span, together, determine which part of the object window services saves. To save the entire object, specify 0 for offset and 0 for span.

,span

Specifies how many 4096-byte blocks CSRSAVE is to save.

Define span as integer data of length 4.

,new_hi_offset

When CSRSAVE completes, new_hi_offset contains the new size of the object expressed in units of 4096 bytes.

Define new_hi_offset as integer data of length 4.

,return_code

When CSRSAVE completes, return_code contains the return code. Define return_code as integer data of length 4.

Return codes and reason codes are explained under Return codes and reason codes.

,reason_code

When CSRSAVE completes, reason_code contains the reason code. Define reason_code as integer data of length 4.

Return codes and reason codes are explained under Return codes and reason codes.