OSI/FTAM Programming Reference Manual

FTM Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
4-24
FTM_CANCEL_RSP_
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 complete this procedure call successfully, you must have negotiated, via the
FTM_INITIALIZE_REQ_ call, any service class other than the file-management
service class, as well as the read or write functional unit. The association must also
be in the data-transfer regime.
•
Before calling FTM_CANCEL_RSP_, you must call the following procedures:
APS_EVENT_RECEIVE_
APS_STATUS_
FTM_CANCEL_IND_
You 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_.
FTM_CANCEL_IND_ retrieves the indication information on the responder request
to cancel 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.
•
Results of the data-transfer regime are not known.
•
Once the FTM_CANCEL_RSP_ call is successfully completed, the association
returns to the file-open regime.
Errors
Table 4-7. Possible FTAM Initiator Errors for the FTM_CANCEL_RSP_
Procedure (page 1 of 2)
Error Code FTAM Initiator Error
- 6000 ZFTM-ERR-INTERNAL
- 6001 ZFTM-ERR-OUT-OF-SEQUENCE
- 6002 ZFTM-ERR-FU-NOT-NEGOTIATED