OSI/FTAM Programming Reference Manual

FTM Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
4-22
FTM_CANCEL_IND_
diagnostic is an optional parameter.
Considerations
•
To complete this procedure call successfully, the association must be in the
data-transfer regime.
•
You must call APS_EVENT_RECEIVE_ to receive the indication event and
APS_STATUS_ to determine, via the APS_STATUS_ event-code parameter, the
proper indication procedure to use to retrieve the data. You must receive the
ZFTM-VAL-EVT-CANCEL-IND event before calling FTM_CANCEL_IND_.
•
You should call the FTM_CANCEL_RSP_ call after the FTM_CANCEL_IND_
procedure. Once you successfully call FTM_CANCEL_RSP_, the results of any
interrupted read or write operations will be unknown, and the data-transfer regime
will be terminated.
Errors
For cause, effect, and recovery information on these errors, see Appendix B,
NonStop FTAM Initiator Error Messages.
Examples
Examples of the FTM_CANCEL_IND_ call in a program begin on line 824 of the C
version and line 1324 of the TAL version of Example 1 and on line 1221 of the C
version and line 1314 of the TAL version of Example 2 in Appendix G, NonStop
FTAM Programming Examples.
Table 4-6. Possible FTAM Initiator Errors for the FTM_CANCEL_IND_ 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