Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (O)
Guardian Procedure Calls Reference Manual—522629-013
11-39
OPENEDIT Procedure (Superseded by OPENEDIT_
Procedure )
11 File does not exist; indicates that the file does not exist and that the flags
parameter indicates read-only access to the file.
14 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.
16 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).
31 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.
34 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.
59 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.
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.
file-name input
INT .EXT:ref:12
is an array containing the internal-format file name that identifies the file to be
opened. If the file must be created, this name is assigned to it.
filenum input, output
INT:value
on input, if the specified value is greater than or equal to 0 and if the file
designated by
file-name exists, indicates that the caller has already opened the
file through the file system and that
filenum is the number returned by the file
system to identify the open file. In this case, OPENEDIT only verifies that the file is
an EDIT file and creates the internal data structures necessary for subsequent
IOEdit operations on the file. If
filenum is a negative value or if the file does not
exist, OPENEDIT opens the file by calling OPEN (after calling CREATE, if
necessary) and then creates the internal IOEdit data structures.
On return, if OPENEDIT called OPEN, the returned value is the number returned
by OPEN to identify the open file. If OPENEDIT did not call OPEN, the input value
of
filenum is returned unchanged.