Most of the services described in this information provide return
codes and reason codes. Return and reason codes indicate the outcome
of the service in one of the following ways:
- Successful completion: you do not need to take any action.
- Successful or partially successful completion, with additional
information supplied: you should evaluate the additional information
in light of your particular program and determine if you need to take
any action.
- Unsuccessful completion: some type of error has occurred, and
you must take some action to correct the error.
The errors that cause unsuccessful completion fall into three broad
categories:
- Program errors
- Errors that your program causes: you can correct these.
- Environmental errors
- Errors not caused directly by your program; rather, your program's
request caused a limit to be exceeded, such as a storage limit, or
the limit on the size of a particular data set. You might or might
not be able to correct these.
- System errors
- Errors caused by the system: your program did nothing to cause
the error, and you probably cannot correct these.
In some cases, a return or reason code can result from some combination
of these errors.
The return and reason code descriptions for the services in this
information indicate whether the error is a program error, an environmental
error, a system error, or some combination. Whenever possible, the
return and reason code descriptions give you a specific action that
you can take to fix the error.
IBM® recommends that you read
all the return and reason codes for each service that your program
issues. You can then design your program to handle as many errors
as possible. When designing your program, you should allow for the
possibility that future releases of MVS™ might
add new return and reason codes to a service that your program issues.