IBM 2 Computer Hardware User Manual


 
CCA Release 2.54
Appendix A. Return Codes and Reason Codes
This appendix describes the return codes and the reason codes that a verb uses to
report the results of processing.
Each return code is associated with a reason code that supplies details about the
result of verb processing. A successful result can include return code 0 and reason
code 0 or another combination of a return code and a reason code. Generally, you
should be able to base your application program design on the return codes; the
reason codes amplify the meaning supplied by the return codes.
A verb supplies a return code and a reason code in the return_code parameter and
in the reason_code parameter.
Return Codes
A return code provides a summary of the results of verb processing. A return code
can have the values shown in Figure A-1.
Figure A-1. Return Code Values
Hex
Value
Decimal
Value
Meaning
00 00 This return code indicates a normal completion of verb processing. To provide additional
information, a few nonzero reason codes are associated with this return code.
04 04 This return code is a warning that indicates that the verb completed processing; however, an
unusual event occurred. The event is most likely related to a problem created by the user, or
it is a normal occurrence based on the data supplied to the verb.
08 08 This return code indicates that the verb stopped processing. Either an error occurred in the
application program or a possible recoverable error occurred in the Coprocessor support
code.
0C 12 This return code indicates that the verb stopped processing. Either a Coprocessor is not
available or a processing error occurred in the Coprocessor support code. The reason is
most likely related to a problem in the setup of the hardware or in the configuration of the
software.
10 16 This return code indicates that the verb stopped processing. A processing error occurred in
the Coprocessor support code. If these errors persist, a repair of the Coprocessor hardware
or a correction to the Coprocessor support code may be required.
Reason Codes
A reason code details the results of verb processing. Every reason code is
associated with a single return code. A nonzero reason code can be associated
with a zero return code.
It is expected that User Defined Extensions (UDX) will return reason codes in the
range of 20480 (X'5000') through 24575 (X'5FFF'). See the documentation for
your UDXs, if any, for these reason code meanings.
Copyright IBM Corp. 1997, 2005 A-1