Guardian Procedure Calls Reference Manual

OPENEDIT_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Related Programming Manual
Summary
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
#include <cextdecs(OPENEDIT_)>
short OPENEDIT_ ( const char *file-name
,short length
,short *filenum
,[ short access ]
,[ short exclusion ]
,[ short nowait ]
,[ short sync-depth ]
,[ short write-thru ] );
Syntax for TAL Programmers
error := OPENEDIT_ ( file-name:length ! i:i
,filenum ! i,o
,[ access ] ! i
,[ exclusion ] ! i
,[ nowait ] ! i
,[ sync-depth ] ! i
,[ write-thru ] ); ! i
Parameters
file-name:length
input:input
STRING .EXT:ref:*, INT:value
specifies the name of the file to be opened. If the file must be created, this name is assigned
to it. The value of file-name must be exactly length bytes long and must be a valid file
name or DEFINE name. If the name is partially qualified, it is resolved using the contents of
the =_DEFAULTS DEFINE.
filenum
input, output
INT:ref:1
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
OPENEDIT_ Procedure 917