OSI/FTAM Programming Guide

Using FTM Procedure Calls
HP NonStop OSI/FTAM Programming Guide—528612-001
4-52
Generating U-Aborts
3. If you received a P-abort indication, call FTM_P_ABORT_IND_; if you received a
U-abort indication, call FTM_U_ABORT_IND_.
4. Call APS_DISCARD_ to discard the association context and release the CEPI. If a
data transfer was in progress at the time of the abort, files are left in an unknown
state. Depending on the cause of the abort, it might be possible to establish a new
association and repeat the data transfer, or also continue it if the application was
reading an FTAM-2 file.
Generating U-Aborts
Table 4-21 shows the sequence of procedures to call and describes the steps to
generate a U-abort. Sometimes you can omit a procedure call associated with a
substep, depending on the context. The sequence of procedures is explained after the
table.
1. Call FTM_U_ABORT_REQ_ to abort the association to the remote responder.
a. If the procedure succeeds, it returns a status code of ZAPS-VAL-STATUS-OK.
If the procedure fails, it returns a different status code. To obtain the details of
an error at this stage, call APS_STATUS_, specifying as input the CEPI
returned by the FTM_INITIALIZE_REQ_ procedure for this association.
b. If the association is in nowait mode, call MFM_AWAITIOX_ to wait for
completion of the FTM_U_ABORT_REQ_ call. MFM_AWAITIOX_ gives you
the status code for the completed procedure call. For more information on the
MFM_AWAITIOX_ procedure, refer to the OSI/FTAM Programming Reference
Manual.
c. If you call MFM_AWAITIOX_ and the status code returned is not
ZAPS-VAL-STATUS-OK, call APS_STATUS_, specifying as input the CEPI
returned by the FTM_INITIALIZE_REQ_ procedure for this association.
2. Call APS_DISCARD_ to discard the association context and release the CEPI. If a
data transfer was in progress at the time of the abort, files are left in an unknown
state. Depending on the cause of the abort, it might be possible to establish a new
Table 4-21. Calls for Generating U-Aborts
Step Action to Take Procedure(s) to Call
1 Abort the association to the remote responder. FTM_U_ABORT_REQ_
a. If error returned by FTM_U_ABORT_REQ_, check
status.
APS_STATUS_
b. If nowait mode, await completion of
FTM_U_ABORT_REQ_.
MFM_AWAITIOX_
c. If error returned by MFM_AWAITIOX_, check status. APS_STATUS_
2 Discard the association context. APS_DISCARD_