Guardian Procedure Calls Reference Manual

INITIALIZEEDIT Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Nowait Considerations
Example
Related Programming Manual
Summary
The INITIALIZEEDIT procedure allocates the EDIT file segment (EFS) to be used by IOEdit and
initializes the data structures that it contains. If your program uses IOEdit, this procedure is called
automatically by the first IOEdit procedure that your program calls. It is necessary to call
INITIALIZEEDIT explicitly only when your program needs to specify a value for one or more of its
parameters.
Syntax for C Programmers
#include <cextdecs(INITIALIZEEDIT)>
short INITIALIZEEDIT ( [ short *swapvol ]
,[ short maxfiles ]
,[ short errorabend ]
,[ short nowait-option ] );
Syntax for TAL Programmers
error := INITIALIZEEDIT ( [ swapvol ] ! i
,[ maxfiles ] ) ! i
,[ errorabend ] ! i
,[ nowait-option ] ); ! i
Parameters
swapvol
input
INT .EXT:ref:4
is a four-word array containing the name of the disk volume in which the EFS is to be allocated.
If this parameter is omitted or if INITIALIZEEDIT is unable to allocate the EFS on the specified
device, the name of the caller's swap volume is used. (The swap volume of the calling program
is normally the same as its object file volume, unless the SWAP option of the TACL RUN
command was invoked.) If the EFS cannot be allocated on the caller's swap volume,
INTIALIZEEDIT then tries every disk volume in the system until it succeeds. For a description of
what occurs if INITIALIZEEDIT is unable to allocate the EFS on any disk volume in the system,
see the errorabend parameter.
INITIALIZEEDIT Procedure 723