To refresh changed data that is in a window, a scroll area, or
a temporary object, call CSRREFR. CSRREFR refreshes changed data
within specified blocks as follows:
- If the object is permanent, CSRREFR replaces specified changed
blocks in windows or the scroll area with corresponding blocks from
the object on DASD.
- For a temporary object, CSRREFR refreshes specified changed blocks
in windows and the object by setting the blocks to binary zeroes.
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 CSRREFR uses to obtain input values, assign values
that are acceptable to CSRREFR. For parameters that CSRREFR ignores,
assign any value that is valid for the particular parameter’s data
type.
Assign values, acceptable to CSRREFR, to object_id, offset,
and span. CSRREFR ignores other parameter values.
CSRREFR returns values in return_code and reason_code.
CALL statement |
Parameters |
---|
CALL CSRREFR
|
(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 window services refreshes.
To refresh the entire object, specify 0 for offset and
0 for span.
- ,span
- Specifies how many 4096-byte blocks CSRREFR is to refresh.
Define span as
integer data of length 4.
- ,return_code
- When CSRREFR 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 CSRREFR 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.