OSI/FTAM Programming Guide

Using FTM Procedure Calls
HP NonStop OSI/FTAM Programming Guide—528612-001
4-56
Errors in Indication and Confirm Procedures
APS_EVENT_RECEIVE_ procedure reveals that an indication or confirm event has
been received. The indication or confirm procedure then retrieves the associated event
information.
To handle errors encountered by indication and confirm procedures:
1. Check status.
In wait mode, status is returned from a call to APS_EVENT_RECEIVE_. In
nowait mode, this is the value of the status parameter from the
MFM_AWAITIOX_ procedure called after the call to APS_EVENT_RECEIVE_.
2. If status does not equal ZAPS-VAL-STATUS-EVENT (1), look up the status
value in the OSI/FTAM Programming Reference Manual.
3. If status equals ZAPS-VAL-STATUS-EVENT (1), call APS_STATUS_.
a. If the error return value from APS_STATUS_ does not equal
ZAPS-ERR-OK(0), the APS_STATUS_ call has failed. For the cause of the
failure, check the error value in the OSI/FTAM Programming Reference
Manual.
b. If the error return value from APS_STATUS_ equals ZAPS-ERR_OK (0), the
APS_STATUS_ call was successful. You can now retrieve the indication or
confirm information.
4. Call the FTM indication or confirm procedure indicated by the APS_STATUS_
event-code parameter. For ZFTM-VAL-EVT-xxx event-code values, see the
OSI/FTAM Programming Reference Manual.
a. If the error return value from the indication or confirm procedure call does not
equal ZAPS-ERR_OK (0), the indication or confirm procedure call failed. For
the cause of the failure, check the error value in the OSI/FTAM Programming
Reference Manual.
b. If the error return value from the indication or confirm procedure call equals
ZAPS-ERR_OK (0), the indication or confirm procedure call was successful.
You can now check the action-result output parameter from the indication
or confirm procedure and proceed as follows:
1. If action-result equals ZFTM-VAL-ACTION-SUCCESS (0), the service
has successfully completed. Check the diagnostic parameter of the
indication or confirm procedure for any informative message providing
additional details on the operation.
2. If action-result equals ZFTM-VAL-ACTION-FAILURE (2), check the
diagnostic parameter of the indication or confirm procedure call for any
error information.
diagnostic contains up to 10 elements, and each element in turn
consists of several fields. For details on the structure of diagnostic,
ZFTM-DDL-DIAGNOSTIC, see the OSI/FTAM Programming Reference