OSI/FTAM Programming Reference Manual

FTM Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
4-20
FTM_CANCEL_CNF_
diagnostic output
INT .EXT:ref:(ZFTM-DDL-DIAGNOSTIC)
provides information that qualifies the success or explains the failure of a
requested action. For a complete list of possible diagnostic values, see
Appendix C, ISO FTAM Diagnostic Messages.
diagnostic is an optional parameter.
Considerations
•
To complete this procedure call successfully, the association must be in the
data-transfer regime.
•
Before calling FTM_CANCEL_CNF_, you must call the following procedures:
FTM_CANCEL_REQ_
APS_EVENT_RECEIVE_
APS_STATUS_
You call APS_EVENT_RECEIVE_ to receive the confirm event and
APS_STATUS_ to determine, via the APS_STATUS_ event-code parameter, the
proper confirm procedure to use to retrieve the data. You must receive the
ZFTM-VAL-EVT-CANCEL- CNF event before calling FTM_CANCEL_CNF_.
•
Results of the data-transfer regime are not known.
•
Receipt of the ZFTM-VAL-EVT-CANCEL-CNF event returns the association to the
file-open regime. The application can either call the read or write operation in
progress at the time of the cancel, or close and deselect the file previously
selected and opened for the transfer and terminate the association.
Errors
For cause, effect, and recovery information on these errors, see Appendix B, NonStop
FTAM Initiator Error Messages.
Examples
Examples of the FTM_CANCEL_CNF_ call in a program begin on line 1239 of the C
version and line 1331 of the TAL version of Example 2 in Appendix G, NonStop FTAM
Programming Examples.
Table 4-5. Possible FTAM Initiator Errors for the FTM_CANCEL_CNF_ Procedure
Error Code FTAM Initiator Error
- 6000 ZFTM-ERR-INTERNAL
- 6017 ZFTM-ERR-INVALID-IF-VERSION
- 6018 ZFTM-ERR-INVALID-FIELD-VERSION
- 6036 ZFTM-ERR-SU-ABORTED