Guardian Procedure Errors and Messages Manual

16 IOEdit Errors
IOEdit allows the run-time libraries of the compilers supported on the operating system to read and
write EDIT format files. An application process can use the following IOEdit procedures to access
files IOEdit Errors.
INITIALIZEEDITBACKSPACEEDIT
NUMBEREDITCLOSEALLEDIT
OPENEDITCLOSEEDIT
OPENEDIT_CLOSEEDIT_
PACKEDITCOMPLETEIOEDIT
POSITIONEDITCOMPRESSEDIT
READEDITDELETEEDIT
READEDITPEXTENDEDIT
UNPACKEDITGETINCREMENTEDIT
WRITEEDITGETPOSITIONEDIT
WRITEEDITPINCREMENTEDIT
Like the sequential I/O (SIO) procedures, IOEdit is capable of reading and writing EDIT files. EDIT
files have a file code of 101.
Most error messages returned by IOEdit are the same as the file-system error codes described in
“File-System Errors” (page 19). Some have special meaning to IOEdit. The messages with special
meanings are further explained here.
A status or code of 0 indicates that no error occurred.
Error Message Forms
IOEdit returns errors in three different forms:
• Errors returned as positive integers, using the same codes as the file-system errors described
in “File-System Errors” (page 19). These errors can assume a somewhat different meaning
when returned by IOEdit, as described below.
• Errors returned as negative integers. These errors are unique to IOEdit and can occur only
from operations on EDIT files.
• Errors that result in the immediate abnormal termination of the calling process. No recovery
is possible. IOEdit does not return to the caller but instead writes a message to the home
terminal and calls ABEND.
The classes of IOEdit errors are discussed in the following subsections.
File-System Error Codes
Errors reported using positive integers are generally the same as those returned by the file system.
The positive IOEdit error codes that do not have the same meaning as the file-system errors described
in “File-System Errors” (page 19) are presented here.
2 (%2) OPERATION NOT ALLOWED ON THIS TYPE OF FILE
Cause IOEdit returns this error when a file is specified that is not an EDIT file (unstructured, file
code 101) or is not on a disk device.
Effect IOEdit cannot operate on this file.
224 IOEdit Errors