OSI/FTAM Programming Reference Manual

FTM Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
4-107
FTM_LOCATE_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
•
Before calling this procedure, you must have negotiated the file-access service
class and the file-access functional unit on the FTM_INITIALIZE_REQ_ call.
•
To successfully complete this procedure call, you must be in the file-open 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.
•
This procedure cannot be used on a document type whose constraint set is “FTAM
unstructured constraint set.” FTAM-1 and FTAM-3 document types fall into this
category.
Errors
For cause, effect, and recovery information on these errors, see Appendix B, NonStop
FTAM Initiator Error Messages.
Table 4-31. Possible FTAM Initiator Errors for the FTM_LOCATE_REQ_
Procedure
Error Code FTAM Initiator Error
- 6000 ZFTM-ERR-INTERNAL
- 6001 ZFTM-ERR-OUT-OF-SEQUENCE
- 6002 ZFTM-ERR-FU-NOT-NEGOTIATED
- 6006 ZFTM-ERR-FADU-ID-INVALID
- 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
- 6026 ZFTM-ERR-LOCATE-DOCTYPE
- 6036 ZFTM-ERR-SU-ABORTED