Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (O)
Guardian Procedure Calls Reference Manual—522629-013
11-45
OPENEDIT_ Procedure
Refer to the nowait-depth parameter under the FILE_OPEN_ procedure for a
detailed description of this parameter.
Refer to “Nowait Considerations” under the INITIALIZEEDIT procedure for a
description of how opening a file for nowait access affects an edit file.
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.
Refer to the
sync-or-receive-depth parameter under the FILE_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.
Considerations
•
The caller must set the filenum parameter to an appropriate value before each
call to OPENEDIT_, because its value might be changed upon return.
•
If the file is already open at the time of the call to OPENEDIT_, the access,
exclusion, nowait, sync-depth, and write-thru parameters to
OPENEDIT_ are ignored.
•
OPENEDIT_ sets the file’s current record number to -1 and resets the line number
increment to 1 (that is, it resets the record number increment to 1000).
•
If OPENEDIT_ calls the FILE_CREATE_ procedure, it sets the primary and
secondary extent sizes to two pages each and sets the maximum number of
extents to 900.
•
If OPENEDIT_ opens a file that is already open by the same process, it writes to
disk all the buffers for that file, including directory information. This assures that
the file is in an up-to-date state at the completion of the open. For a general
discussion of coordinating concurrent file access, refer to the
Guardian
Programmer’s Guide.
Also refer to “Considerations” for the FILE_OPEN_ procedure.