Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (R)
Guardian Procedure Calls Reference Manual—522629-013
13-50
REFRESH Procedure
(Superseded by DISK_REFRESH_ Procedure )
Syntax for TAL Programmers
Parameters
error returned value
INT
returns a file-system error number indicating the outcome of the call. (Refer to the
Guardian Procedure Errors and Messages Manual for a list of all file-system
errors.)
volname input
INT:ref:12
specifies a volume whose associated FCBs should be written to disk. $
volname
must be specified as a full 12-word internal form
file-name, blank filled.
volname can be either:
$volname
or
\sysnumvolname
If omitted, all FCBs for all volumes are written to their respective disks.
Considerations
•
When REFRESH is called without a volname, the error return is always 0.
•
Because calling the 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 := REFRESH; ! refresh FCBs for all volumes.
error := REFRESH ( [volname] ); ! i