OSI/FTAM Programming Guide

NonStop FTAM Programming
HP NonStop OSI/FTAM Programming Guide—528612-001
3-41
ISO-Defined FTAM Diagnostic Messages
immediately call the APS_STATUS_ procedure in your program. The error-code
and error-subcode parameters of this call provide additional details on the error
condition, and the original-error-info (ZAPS-DDL-ORIGINAL-ERROR)
parameter provides details on the first error detected in the OSI/AS layers. The
ZERROR field (ZAPS-DDL-CURRENT-ERROR) of original-error-info identifies
the code of the first error detected in the OSI/AS layers and the underlying service that
detected the error, among other data. This information can help with error recovery.
The OSI/FTAM Programming Reference Manual describes the cause, effect, and
recommended recovery action for each error code and definitions of each error
subcode. Table 3-4 provides the ranges of values for the error-code and
original-error-info output parameters of the APS_STATUS_ procedure.
On the basis of the service identified, you decide which manual to see for further
assistance in recovering from the error indicated in original-error-info. For
example, if the service ID in the ZERROR field of original-error-info is
ZAPS-VAL-SERVICE-FTAM, refer to the OSI/FTAM Programming Reference Manual
for information on the original error. If the service identified is ZAPS-VAL-SERVICE-
APS, refer to either the OSI/FTAM Programming Reference Manual or the OSI/AS
Programming Manual, depending on whether the source of the problem is the FTAM or
OSI/AS API. If the service ID is any other value than ZAPS-VAL-SERVICE-FTAM or
ZAPS-VAL-SERVICE-APS, refer to the OSI/AS Programming Manual.
Error Return Values
The procedures that perform no I/O operations (see Table 4-1 on page 4-2), including
all indication and confirm procedures, return error values that indicate whether a call
has succeeded or failed to run successfully. If the returned error value does not
equal ZAPS-ERR-OK (0), an error has occurred. In this case, the value of error
indicates the error condition. To determine whether an error subcode is available, call
APS_STATUS_. For details on error, error-code, or error-subcode values, see
the OSI/FTAM Programming Reference Manual.
ISO-Defined FTAM Diagnostic Messages
ISO-defined FTAM diagnostic messages make up the third class of NonStop FTAM
errors. The remote responder typically returns ISO FTAM diagnostic messages,
although in certain cases the initiator can return these messages. ISO diagnostic
Table 3-4. NonStop FTAM Error Message Groups
Error Identifier Meaning
-6000 to -6040 FTAM API and initiator errors
-1000 to -1012 TAPS process error values
-0 to -144 General APS error values*
0 to 179 Guardian file-system errors returned by the Transport service
* Session, Presentation, and ACSE errors appear as subcodes to the general APS errors.