Guardian Procedure Calls Reference Manual

REFRESH Procedure (Superseded by DISK_REFRESH_ Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameter
Returned Value
Considerations
Example
Summary
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.
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 must 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 must 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.
Syntax for TAL Programmers
error := REFRESH ( [ volname ] ); ! i
Parameter
volname
input
INT:ref:12
specifies a volume whose associated FCBs are to be written to disk. volname must be specified
as a full 12-word internal form file-name, blank filled.
1234 Guardian Procedure Calls (R)