Guardian Procedure Calls Reference Manual

flags
input
INT:value
specifies the value that is passed to the flags parameter of the OPEN procedure if OPENEDIT
opens the file. These conditions apply:
• If OPENEDIT opens the file and if the flags parameter is omitted, the value %002001
(read-only, shared access, nowait mode) is used.
• If OPENEDIT opens the file and if the flags parameter specifies write-only access,
OPENEDIT opens the file with read-write access instead, because any write to an EDIT file
requires reading a directory within the file to determine where to write the line.
• If the file is already open with write-only access at the time of the call to OPENEDIT, the
procedure returns an error 2 (invalid operation), because it is unable to change the file's
access mode.
• If the file does not exist and if the value of flags specifies (or defaults to) read-only access,
OPENEDIT returns error 11 (file does not exist). If the file does not exist and if the flags
value specifies read-write access, OPENEDIT creates the file and opens it.
For a detailed description of this parameter, see the flags parameter under OPEN Procedure
(Superseded by FILE_OPEN_ Procedure) (page 897).
sync-depth
input
INT:value
specifies the sync depth value to be passed to the OPEN procedure if OPENEDIT opens the
file. If this parameter is omitted, 0 is used.
For a detailed description of this parameter, see the sync-or-receive-depth parameter
under OPEN Procedure (Superseded by FILE_OPEN_ Procedure) (page 897).
write-thru
input
INT:value
if present and not 0, specifies that each call to an IOEdit procedure that changes the content
of the file must fully update the disk copy of the file. This means that every file access results in
one or more physical I/O operations. Note that using this option can cause severe performance
degradation.
Returned Value
INT
A file-system error code that indicates the outcome of the call:
Page-count value is inconsistent.-1
Page-table tags are out of order.-2
Page-table tag is outside valid range.-3
Page-table block number is outside of file.-4
Page table has duplicate block numbers.-5
File does not exist; indicates that the file does not exist and that the flags parameter indicates read-only
access to the file.
11
Device does not exist; indicates that the device-name part of the file name designates a device that either
does not exist or is not a disk device.
14
OPENEDIT Procedure (Superseded by OPENEDIT_ Procedure) 915