OSI/FTAM Programming Guide

Using FTM Procedure Calls
HP NonStop OSI/FTAM Programming Guide—528612-001
4-53
Handling Errors
association and repeat the data transfer, or also continue it if the application was
reading an FTAM-2 file.
Handling Errors
This subsection outlines the steps to follow in diagnosing problems associated with
errors returned by FTM procedures.
Errors in Request and Response Procedures
To handle errors encountered by request and response procedures:
1. Check status. If status is ZAPS-VAL-STATUS-OK (0), there is no error.
In wait mode, status is returned from the FTM procedure call.
In nowait mode, status can be returned both from the FTM procedure call and
from the MFM_AWAITIOX_ call that follows it. First check the status value
returned from the FTM procedure call and follow these steps:
a. If status is not ZAPS-VAL-STATUS-OK (0), an API error has occurred. The
FTAM API discontinues processing the procedure call. To determine the error,
call APS_STATUS_ and follow these steps:
1. If the error return value from the APS_STATUS_ procedure 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.
2. If the error return value from the APS_STATUS_ procedure equals 0, the
APS_STATUS_ call was successful. You can now check the error-code
value returned by APS_STATUS_.
3. Look up the error-code value and error-subcode value in the various
error tables in the OSI/FTAM Programming Reference Manual.
In this case, because the FTM procedure does not successfully complete, the
application should not call a subsequent MFM_AWAITIOX_ procedure.
b. If the status value returned from the FTM procedure call is
ZAPS-VAL-STATUS-OK (0), next check the status value returned from the
MFM_AWAITIOX_ procedure.
2. If status is not ZAPS-VAL-STATUS-OK (0), an error has been detected in the
FTAM initiator or one of the underlying OSI services. To determine the error, call
APS_STATUS_ and proceed as follows:
a. If the error return value from the APS_STATUS_ procedure 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.