Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (R)
Guardian Procedure Calls Reference Manual—522629-013
13-49
REFRESH Procedure
(Superseded by DISK_REFRESH_ Procedure )
REFRESH Procedure
(Superseded by DISK_REFRESH_ Procedure
)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Considerations
Example
Summary
The REFRESH procedure is used to write control information to the associated disk
volume. REFRESH always writes out the control information contained in file control
blocks (FCBs), such as end-of-file (EOF) pointers. Only the data and control
information that is not already on disk is written.
REFRESH also writes all dirty (that is, modified) cache blocks to disk. The writing of
cache blocks takes priority over all other disk activity and can severely impact
response time on the disk volume. For this reason, the REFRESH procedure should
not be used when performance of other programs is critical.
On RVUs preceding G00,The REFRESH procedure can be used when a volume is
brought down (for example, immediately before a system load or PUP DOWN !
command) but should not be used at other times. On these RVUs,The REFRESH
procedure or the equivalent Peripheral Utility Program (PUP) REFRESH command
should be performed on all volumes before a total system shutdown. On G-series
RVUs, the REFRESH procedure is not needed because the system performs the
equivalent operation automatically for each disk volume when it is brought down and at
system shutdown.
Syntax for C Programmers
This procedure does not have a C syntax, because it is superseded and should not be
used for new development. This procedure is supported only for compatibility with
previous software.
Note. This procedure is supported for compatibility with previous software and should not be
used for new development. On G-series RVUs, the function provided by both the REFRESH
and DISK_REFRESH_ procedures is no longer needed.