Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (D-E)
Guardian Procedure Calls Reference Manual—522629-013
4-79
DISK_REFRESH_ Procedure
DISK_REFRESH_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Considerations
Example
Summary
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 releases 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 releases, 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 releases, 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
Note. On G-series releases, 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.
#include <cextdecs(DISK_REFRESH_)>
short DISK_REFRESH_ ( char *name
,short length );