Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (O)
Guardian Procedure Calls Reference Manual—522629-013
11-40
OPENEDIT Procedure (Superseded by OPENEDIT_
Procedure )
flags input
INT:value
specifies the value that is passed to the
flags parameter of the OPEN procedure
if OPENEDIT opens the file. The following 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.
Refer to the
flags parameter under the OPEN procedure for a detailed
description of this parameter.
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.
Refer to the
sync-or-receive-depth parameter under the OPEN procedure for
a detailed description of this parameter.
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 should 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.