Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (D-E)
Guardian Procedure Calls Reference Manual—522629-013
4-80
DISK_REFRESH_ Procedure
Syntax for TAL Programmers
Parameters
error returned value
INT
is a file-system error number indicating the outcome of the operation.
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.
Considerations
•
Because calling the DISK_REFRESH_ procedure can severely impact response
time on the specified disk volume, the following 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 );
error := DISK_REFRESH_ ( name:length ); ! i:i