Guardian Procedure Calls Reference Manual

maxfiles
input
INT:value
specifies the maximum number of files that IOEdit will be able to have open at one time. If this
parameter is omitted or if a value less than 30 is specified, 30 is used. If a value greater than
255 is specified, 255 is used.
errorabend
input
INT:value
specifies the action that INITIALIZEEDIT is to take if it is unable to allocate the EFS on any disk
volume. If errorabend is omitted or if 0 is specified, failure to allocate the EFS causes
INITIALIZEEDIT to return an error 33 (unable to obtain I/O segment space); otherwise, it writes
a message to the caller's home terminal and terminates abnormally. When INITIALIZEEDIT is
called by another IOEdit procedure, -1 is specified for this parameter.
nowait-option
input
INT:value
specifies whether to use double buffering for files opened for nowait I/O, as follows:
Don't use double buffering on any file.0
Use double buffering on all files that the user opens for nowait I/O before calling OPENEDIT_ (or
OPENEDIT).
1
Use double buffering on all files opened for nowait I/O, whether by the user or by OPENEDIT_ (or
OPENEDIT).
2
Has the same effect as a value of 2.3
If this parameter is omitted or if its value is none of the above, 0 is used.
For additional information, see Nowait Considerations.
Returned Value
INT
A file-system error code that indicates the outcome of the call.
Nowait Considerations
IOEdit always returns to the caller with the operation finished. In this sense, it does not perform
nowait I/O. Note that for write operations, the operation is considered finished when the data is
in the IOEdit buffer and might not yet have been passed to the file system. The nowait-option
parameter controls how this buffering is done.
• If nowait-option is set to 0 or is left unspecified, and nowait I/O was specified when the
file was opened, IOEdit calls AWAITIOX after every operation. You do not need to call the
COMPLETEIOEDIT procedure.
• If nowait-option is set to 1 and IOEdit determines that the file is being accessed sequentially,
IOEdit reads ahead or writes behind when it performs nowait I/O on the buffers for files that
are opened for nowait access.
724 Guardian Procedure Calls (H-K)