Guardian Procedure Calls Reference Manual

DISK_REFRESH_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameter
Returned Value
Considerations
Example
Summary
NOTE: On G-series RVUs, this procedure is supported for compatibility with previous software
and should not be used for new development; the function that it provides is no longer needed.
The DISK_REFRESH_ procedure causes control information to be written to the specified disk volume.
DISK_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.
The DISK_REFRESH_ procedure 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 affect response
time on the disk volume. For this reason, the DISK_REFRESH_ procedure should not be used when
performance of other programs is critical.
On RVUs preceding G00, the DISK_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 DISK_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 DISK_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
#include <cextdecs(DISK_REFRESH_)>
short DISK_REFRESH_ ( char *name
,short length );
Syntax for TAL Programmers
error := DISK_REFRESH_ ( name:length ); ! i:i
318 Guardian Procedure Calls (D-E)