OSI/AS Programming Manual

Appendix B Status and Error Codes
056783 Tandem Computers Incorporated B–1
This appendix lists the status and error messages returned by the APS procedures.
Where possible, explanations and recommendations for action are also given.
Each status and error code is listed in a quick-reference table and then explained
further following the table. In the tables, the errors are listed in numeric order.
However, the explanations following each table are given in alphabetic order by the
DDL name of the error. This organization allows you to look up each status and error
code either by error number or by name.
For the structure of the error messages, see ZAPS-DDL-ERROR-CODE, ZAPS-DDL-
SERVICE-ID, and ZAPS-DDL-DIAG-BUF in Appendix A.
Using the Codes The main indication of recovery action for the API is the status code. This informs
you, for example, whether you should retry an operation or whether you should
discard the connection. You should treat the recovery actions listed in this appendix
as recommendations, not as strict rules.
The error code and subcode structure is provided mainly for problem resolution. The
details of error codes and subcodes are provided to enable you to take action for the
future rather than at the time of the error.
It would be very costly to test for each error code and subcode. We recommend that
you normally test the status code but save the error codes and subcodes in a log, a file,
or a terminal message.
Status Codes Status codes (except ZAPS-VAL-STATUS-EVENT) returned by the APS procedures
(and by MFM_AWAITIOX_ , described in Appendix C) indicate the success or failure
of a procedure call. If a procedure call fails, the status code indicates the
recommended recovery action.
The special status code ZAPS-VAL-STATUS-EVENT indicates that an event was
received. This code is returned only on the completion of a call to the
APS_EVENT_RECEIVE_ procedure.
Table B-1 summarizes the status values you may receive and explains what they mean.
The name of each value starts with ZAPS-VAL-STATUS-. A more detailed description
of each value follows the table.