Open System Services Programmer's Guide

Guardian File-System Procedures
Table 9 displays information about each Guardian procedure that you can use to manage files.
Procedures that have been superseded by other procedures are not shown. The columns of the
table contain the following:
Guardian Procedure
The name of the procedure and a brief description.
OSS Notes
Additional considerations or restrictions when the Guardian procedure is used on OSS files.
For details about a procedure, refer to the Guardian Procedure Calls Reference Manual.
Table 9 Guardian File-System Procedures
OSS NotesGuardian Procedure
AWAITIO[X]
Checks for completion of read operations pending on the
$RECEIVE file.
Fails with file-system error 1163 when the file is an OSS
file.
FILE_ALTERLIST_
Changes certain attributes of a Guardian disk file that are
normally set when the file is created.
FILE_AWAITIO64_
Beginning with the H06.24 and J06.13 RVUs, checks for
completion of read operations pending on the $RECEIVE
file. The FILE_AWAITIO64_ procedure is intended for use
with 64-bit extended addresses, but it can be used with
32-bit addresses as well. Extends the capabilities of the
AWAITIOXL procedure.
For an OSS file descriptor: The Z^Count^Tranferred
field is overlaid by Z^Completion^Type and the Z^Tag
field contains 0D.
FILE_COMPLETE_
Completes one previously initiated I/O operation for a
Guardian file or returns ready information for one OSS
file.
Completion on an OSS file descriptor means checking for
readiness. The operation of checking for readiness is
equivalent to calling the OSS select() function.
Can be interrupted by an OSS signal, which returns an
error 4004.
FILE_COMPLETE_GETINFO_
Provides information about the set of files that are enabled
for completion by FILE_COMPLETE_.
For OSS, the type of operation (read, write, or exception)
can be specified.
FILE_COMPLETE_SET_
Enables a set of Guardian and OSS files for completion
by subsequent calls to FILE_COMPLETE_.
Disabling a file descriptor of -1 means no OSS descriptors
will be completed in consecutive FILE_COMPLETE_ calls;
all OSS descriptors will be removed from the set of enabled
files.
FILE_CONTROL64_
Beginning with the H06.24 and J06.13 RVUs, performs
device-dependent I/O operations. The FILE_CONTROL64_
procedure is intended for use with 64-bit extended
addresses, but it can be used with 32-bit addresses as well.
Extends the capabilities of the CONTROL procedure.
FILE_CONTROLBUF64_
Beginning with the H06.24 and J06.13 RVUs, performs
device-dependent I/O operations requiring a data buffer.
The FILE_CONTROLBUF64_ procedure is intended for use
with 64-bit extended addresses, but it can be used with
100 Managing Files