Guardian Procedure Calls Reference Manual

sync-depth
input
INT:value
specifies the sync depth value to be passed to the FILE_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 FILE_OPEN_ Procedure (page 457) .
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 access 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
File has not been opened, wrong file type; indicates that the file is not an EDIT file (that is, the file type is not
unstructured or the file code is not 101 or 102).
16
Unable to obtain buffer space; indicates that the file's directory does not fit into IOEdit's extended data
segment and OPENEDIT_ is unable to enlarge the segment.
31
Unable to obtain memory space for control block; indicates that the number of IOEdit files already open is
equal to the maximum number specified or assumed when INITIALIZEEDIT was called.
34
File is bad; indicates that the file exists and has the correct file type and file code for an EDIT file, but the
data in the file has an incorrect format and OPENEDIT_ is unable to repair it.
59
The negative values listed above indicate that OPENEDIT_ has found a format error in the file that
it can probably correct. At the time that one of these values is returned, the file has not yet been
altered. If you immediately call CLOSEEDIT_ or CLOSEEDIT, the file is closed without change. If
instead you call another IOEdit procedure, IOEdit tries to correct the format of the file. The format
corrections are written to disk when CLOSEEDIT_ or CLOSEEDIT is finally called. If IOEdit fails to
correct the format error, error 59 is returned for all subsequent IOEdit operations on the file.
OPENEDIT_ Procedure 919