Guardian Procedure Calls Reference Manual

Parameter
name:length
input:input
STRING .EXT:ref:*, INT:value
specifies the name of the disk volume (or a file on the disk volume) that is to have control
information written out. If a disk file is specified, the operation is performed for the entire volume
on which the file resides.
The value of name must be exactly length bytes long and must be a valid file (or volume)
name or DEFINE name. If the name is partially qualified, it is resolved using the contents of
the VOLUME attribute of the =_DEFAULTS DEFINE.
Returned Value
INT
A file-system error code that indicates the outcome of the call.
Considerations
• Because calling the DISK_REFRESH_ procedure can severely impact response time on the
specified disk volume, these actions might be considered as alternatives:
◦ When creating a file using FILE_CREATE_, FILE_CREATELIST_, or CREATE, select the
option that causes the file label to be written immediately to disk whenever the EOF value
changes.
◦ Use SETMODE function 95 to cause the dirty cache buffers of a specified file to be written
to disk.
Example
error := DISK_REFRESH_ ( volume^name:length );
DISK_REFRESH_ Procedure 319