z/OS MVS Programming: Callable Services for High-Level Languages
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


CSRSCOT — Save object changes in a scroll area

z/OS MVS Programming: Callable Services for High-Level Languages
SA23-1377-02

Call CSRSCOT to:
  • Update specified blocks of a permanent object’s scroll area with changes that appear in a window you have defined for the object. CSRSCOT requires that the permanent object have a scroll area. CSRSCOT changes only the content of the scroll area and not the content of the permanent data object.
  • Update specified blocks of a temporary data object with the changes that appear in a window you have defined for the data object.

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 CSRSCOT uses to obtain input values, assign values that are acceptable to CSRSCOT. For parameters that CSRSCOT ignores, assign any value that is valid for the particular parameter’s data type.

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

CALL statement Parameters

 
CALL CSRSCOT

 
(object_id
,offset
,span
,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 CSRSCOT updates. To update the entire object, specify 0 for offset and 0 for span.

,span
Specifies how many 4096-byte blocks CSRSCOT is to update.

Define span as integer data of length 4.

,return_code
When CSRSCOT 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 CSRSCOT 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.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014