OSI/FTAM Programming Reference Manual

FTM Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
4-45
FTM_DATA_END_REQ_
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 complete this procedure call successfully, the association must be in the
data-transfer regime.
•
You must have previously called the FTM_WRITE_REQ_ procedure and optionally
made zero or more calls to FTM_DATA_REQ_.
•
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.
The following table lists common errors that can occur on the FTM_DATA_END_REQ_
procedure call.
Table 4-14. Possible FTAM Initiator Errors for the FTM_DATA_END_REQ_
Procedure
Error Code FTAM Initiator Error
- 6000 ZFTM-ERR-INTERNAL
- 6001 ZFTM-ERR-OUT-OF-SEQUENCE
- 6017 ZFTM-ERR-INVALID-IF-VERSION
- 6018 ZFTM-ERR-INVALID-FIELD-VERSION
- 6019 ZFTM-ERR-BAD-APS-STATUS
- 6022 ZFTM-ERR-CONNECTION-ABORTED
- 6030 ZFTM-ERR-DATA-XFER-CANCELLED
- 6036 ZFTM-ERR-SU-ABORTED
These error
values... are returned if....
Error Code:
Error Subcode:
ZFTM-ERR-OUT-OF-SEQUENCE (-6001)
ZFTM-ERR-OOS-STATE-MACHINE (1)
The association is not in the
data-transfer regime.