OSI/FTAM Programming Reference Manual

FTM Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
4-17
FTM_CANCEL_REQ_
FTAM Diagnostic Messages. For more information on application-generated
diagnostic messages, see the OSI/FTAM Programming Guide.
diagnostic is an optional parameter.
tag input
INT(32):value
is for use in nowait mode only. Specify a unique value to identify this instance of
the procedure call. When the operation is complete, the MFM_AWAITIOX_
procedure returns the tag value, allowing your application to match the completion
with the correct instance of the procedure call. For details on the use of the tag
parameter, see the OSI/FTAM Programming Guide.
tag is an optional parameter.
Considerations
•
To successfully complete this procedure call, you must have negotiated any
service class other than the file-management service class, as well as the read or
write functional unit, on the FTM_INITIALIZE_REQ_ call.
•
To complete this procedure call successfully, the association must be in the
data-transfer regime.
•
You must issue an MFM_AWAITIOX_ call to complete the nowait I/O operation if
you set the nowait operating mode in the FTM_INITIALIZE_REQ_ call.
Errors
For cause, effect, and recovery information on these errors, see Appendix B, NonStop
FTAM Initiator Error Messages.
Table 4-4. Possible FTAM Initiator Errors for the FTM_CANCEL_REQ_ Procedure
Error Code FTAM Initiator Error
- 6000 ZFTM-ERR-INTERNAL
- 6001 ZFTM-ERR-OUT-OF-SEQUENCE
- 6002 ZFTM-ERR-FU-NOT-NEGOTIATED
- 6012 ZFTM-ERR-SERV-NOT-NEGOTIATED
- 6017 ZFTM-ERR-INVALID-IF-VERSION
- 6018 ZFTM-ERR-INVALID-FIELD-VERSION
- 6019 ZFTM-ERR-BAD-APS-STATUS
- 6022 ZFTM-ERR-CONNECTION-ABORTED
- 6036 ZFTM-ERR-SU-ABORTED