File Management - IBM

28 File Management V4R5
Table 7. Major Return Code Definitions (continued)
Code Definition
82 A device or session error occurred during an open or
acquire operation. Recovery may be possible.
83 A device or session error occurred during an I/O
operation. Recovery may be possible.
Recovering from file system errors
The following topics describe the actions you should take to recover from errors
that you receive. “Major and minor return codes in files by the system” on page 26
describes return codes.
Normal completion of errors by the system
A major and minor return code of 0000 indicates that the operation requested by
your program completed successfully. Most of the time, the system issues no
message. In some cases, the system might use a diagnostic message to inform the
user of some unusual condition that it could not handle, but which might be
considered an error under some conditions. For example, it might ignore a
parameter that is not valid, or it might take some default action.
For communications devices, a major return code of 00, indicating successful
completion with data received, is accompanied by a minor return code that
indicates what operation the application program is expected to perform next. The
nonzero minor does not indicate an error. No message is issued.
Completion with exceptions of errors by the system
The system assigns several rather specific major return codes to conditions for
which a specific response from the application program is appropriate.
A major return code of 02 indicates that the requested input operation completed
successfully, but the system is ending the job in a controlled. The application
program should complete its processing as quickly as possible. The controlled
cancel is intended to allow programs time to end in an orderly manner. If your
program does not end within the time specified on the ENDJOB command, the
system will end the job without further notice.
A major return code of 03 indicates that an input operation completed successfully
without transferring any data. For some applications, this might be an error
condition, or it might be expected when the user presses a function key instead of
entering data. It might also indicate that all the data has been processed, and the
application program should proceed with its completion processing. In any case,
the contents of the input buffer in the program should be ignored.
A major and minor code of 0309 indicates that the system received no data and is
ending the job in a controlled manner. A major and minor code of 0310 indicates
that there is no data because the specified wait time has ended. Other minor return
codes accompanying the 02 or 03 major code are the same as for a 00 major code,
indicating communications status and the operation to be performed next.
A major return code of 04 indicates that an output exception occurred. Specifically,
your program attempted to send data when data should have been received. This
is probably the result of not handling the minor return code properly on the