OSI/FTAM Programming Reference Manual

HP NonStop OSI/FTAM Programming Reference Manual—528611-001
B-1
B
NonStop FTAM Initiator Error
Messages
This appendix describes the following types of error messages that you might
encounter in developing NonStop FTAM applications:
•
APS error messages and subcodes
•
Error messages and subcodes generated by the NonStop FTAM initiator or FTAM
API
This appendix covers the following topics:
The NonStop FTAM initiator also generates FTAM diagnostic messages, which are
described in Appendix D, NonStop FTAM Initiator Diagnostic Messages.
The quick reference tables, Table B-1 on page B-2, Table B-2 on page B-4, and
Table B-5 on page B-19 outline the error codes used in the NonStop FTAM
implementation. The tables list the errors in numeric order. Error explanations that
follow the tables are also listed in numeric order by error value.
NonStop FTAM initiator error messages are locally generated. The FTAM API and
initiator provide error checking on FTAM requests and responses, eliminating the need
to test across the network for procedure call errors. A nonzero return value for status
or error on an FTM, APS, or MFM procedure call indicates that an error has
occurred.
The status value is returned by the procedures that perform I/O operations, including
all request procedures and the FTM_CANCEL_RSP_ procedure; it is also returned by
the MFM_AWAITIOX_ procedure call when an FTM procedure is called in nowait
mode. If the returned status value does not equal ZAPS-VAL-STATUS-OK, the
procedure call did not run successfully. In this case, the status value gives you initial
guidelines on error recovery. For further error information, you can call APS_STATUS_
to obtain the error code and error subcode.
The error value is returned by procedures that do not perform I/O operations, including
all indications and confirms.
The following subsections describe the status, error, and error-subcode values that can
be returned by the FTM, APS, and MFM procedure calls used in the NonStop FTAM
applications that you develop.
For an overview of error handling, refer to the OSI/FTAM Programming Guide. For
FTM procedure-specific information on some of the errors described in this appendix,
Topic Page
Status Codes
B-2
Error Codes B-4