OSI/FTAM Programming Guide

NonStop FTAM Programming
HP NonStop OSI/FTAM Programming Guide—528612-001
3-42
ISO-Defined FTAM Diagnostic Messages
messages are defined in ISO 8571 and apply generically to any FTAM implementation.
Circumstances for each error can vary from implementation to implementation, so you
might need to refer to the documentation for the responding implementation to
determine the exact nature of the problem.
Most indication and confirm procedures can return diagnostic messages. If a
procedure call returns an error value equal to ZAPS-VAL-STATUS-OK or ZAPS-ERR-
OK, no local error has occurred. This means that a locally generated primitive was sent
to the designated remote system, or an indication or confirm primitive was successfully
received. It is not a guarantee that the requested service was successfully performed,
however. To determine whether the service was successful, check the action-
result parameter returned by the FTM indication or confirm procedure.
If the value of the action-result parameter is ZFTM-VAL-ACTION-SUCCESS, the
responder performed the service successfully. Although no error condition is indicated,
you should check the diagnostic parameter next; it might provide further
information.
If an FTM procedure is not successful, the action-result parameter returns the
value ZFTM-VAL-ACTION-FAILURE. You should check the diagnostic parameter
that the procedure returns to determine what error occurred. The action-result
parameter is, in effect, a summary of the diagnostic messages.
Diagnostic messages convey detailed information about the failure of a requested
action. The diagnostic parameter provides additional details on the information
contained in the action-result parameter. The tables below describe the
diagnostic parameter in greater detail. Table 3-5 on page 3-43 outlines the
information contained in FTAM diagnostic messages. Table 3-6 on page 3-43 presents
the various diagnostic message groups, and Table 3-7 on page 3-44 further explains
the values for the error sources and observers of FTAM diagnostic messages listed in
Table 3-6 on page 3-43.
For details on the structure of the diagnostic parameter, ZFTM-DDL-DIAGNOSTIC,
see the OSI/FTAM Programming Reference Manual. Also refer to that manual for a
complete listing of ISO-defined diagnostic messages that a remote responder might
generate.