Guardian Procedure Calls Reference Manual

filenum
output
INT:ref:1
returns a number used to identify the file in subsequent system calls. A -1 is returned if OPEN
fails.
flags
input
INT:value
specifies certain attributes of the file. If omitted, all fields are set to 0. The bit fields in the flags
parameter are defined in Table 30.
Table 30 OPEN flags Parameter
MeaningFlag in OctalFlag
For disk files, if this bit is 1, specifies the “last open time” attribute of the file being
opened is not updated by this open. For other files, this bit is zero.
%100000<0>
For the $RECEIVE file only, specifies whether the opener wants to receive open, close,
CONTROL, SETMODE, SETPARAM, RESETSYNC, and CONTROLBUF system messages.
Note that some messages are received only with SETMODE function 80.
%40000<1>
0 = No, 1 = Yes (must be 0 for all files other than $RECEIVE)
Specifies that access to an Enscribe file is to occur as if the file were unstructured, that
is, without regard to record structures and partitioning, (Note that for unstructured files,
%20000<2>
setting this bit to 1 makes secondary partitions inaccessible.) Setting this bit to 0
provides normal structured access to the file.
0 = Normal access, 1 = Unstructured access
(Reserved) must be 0 for nonprivileged users%10000<3>
Access mode%6000<4:5>
0 = Read/write
1 = Read-only
2 = Write-only
3 = Reserved
Must be 0 (reserved)%1000<6>
Must be 0 (reserved)%400<7>
For process files, indicates that the open message is sent nowait and must be completed
with a call to AWAITIO[X]. OPEN returns a valid file number.
%200<8>
0 = No, 1 = Yes (must be 0 for all other files)
Must be 0 (reserved)%100<9>
Exclusion mode%60
(If both bits set)
<10:11>
0 = Shared
1 = Exclusive
2 = Process exclusive (supported for Optical Storage Facility only)
3 = Protected
> 0 implies nowait I/O and the maximum number of concurrent nowait I/O operations
that can be in progress on this file at any given time.
%17
(If all four bits
set)
<12:15>
0 implies waited I/O.
898 Guardian Procedure Calls (O)