Guardian Procedure Calls Reference Manual

OPENEDIT Procedure (Superseded by OPENEDIT_ Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Related Programming Manual
Summary
NOTE: The OPENEDIT procedure is supported for compatibility with previous software. For new
development, the OPENEDIT_ procedure should be used instead.
The OPENEDIT procedure allocates and initializes data blocks in the EDIT file segment (EFS) so
that the specified file can be accessed later by the IOEdit procedures. It optionally creates and
opens the specified file through the file system.
Syntax for C Programmers
This procedure does not have a C syntax, because it is superseded and should not be used for
new development. This procedure is supported only for compatibility with previous software.
Syntax for TAL Programmers
error := OPENEDIT ( file-name ! i
,filenum ! i,o
,[ flags ] ! i
,[ sync-depth ] ! i
,[ write-thru ] ); ! i
Parameters
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.
914 Guardian Procedure Calls (O)