Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (O)
Guardian Procedure Calls Reference Manual—522629-013
11-18
OPEN Procedure (Superseded by FILE_OPEN_
Procedure )
Condition Code Settings
< (CCL) indicates that the open failed (call FILEINFO or FILE_GETINFO_). If
OPEN fails, a -1 is returned in
filenum.= (CCE)indicates that the file was
opened successfully.
> (CCG) indicates the file was opened successfully but an exceptional condition was
detected (call FILEINFO or FILE_GETINFO_).
Table 11-2. OPEN flags Parameter (page1of2)
Flag Flag in Octal Meaning
<0> %100000 For disk files, if this bit is 1, the “last open time”
attribute of the file being opened is not updated by this
open. For other files, this bit should be zero.
<1> %40000 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 80.
0 = no, 1 = yes (must be 0 for all files other than
$RECEIVE)
<2> %20000 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, 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
<3> %10000 (Reserved) must be 0 for nonprivileged users.
<4:5> %6000
(If both bits set)
Access mode
0 = Read/write
1 = Read-only
2 = Write-only
3 = reserved
<6> %1000 Must be 0 (reserved)
<7> %400 Must be 0 (reserved)
<8> %200 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.
0 = no, 1 = yes (must be 0 for all other files)