.RADS - control disk caching for a file.

Usage:

B:
   %b/manif/rads
   status = .rads( unit, option );

C:
   #include <host_io.h>
   int _rads(FILE *unit, int option);

Where:

unit

is the I/O unit or stream associated with the file code for which you want to control RADS processing.

option

is a symbolic constant indicating the option you want to set. Possibilities are:

RADS_BYPASS

bypasses the system cache.

RADS_WINTO

writes immediately only into the system cache. The write to disk may occur later at when it is convenient for the system.

RADS_WTHRU

writes to both the cache and disk immediately. This is preferred for file integrity.

status

is zero if the call is successful. A return status of 1 indicates that RADS is not installed in the system, or that your program is running in TSS. A return status of 2 indicates that RADS is installed but is not enabled.

Description:

.RADS lets you control GCOS8's disk caching facilities for files (RADS). You should use .RADS when data integrity is critical, and you need the assurance that your data is actually recorded in the file system if GCOS8 goes down. The system default for RADS may already provide this assurance, but you should use the .RADS function anyway, since there is no way for your program to test this default.

.RADS is only effective in batch.

See Also:

expl b lib .drads

to set a default disk caching option during file open.

The Rapid Access Data System Manual, EA67

for information about using RADS.

Copyright © 1996, Thinkage Ltd.