OSI/FTAM Programming Reference Manual

MFM Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
E-4
MFM_CANCELREQ_
positive number and filenum is a CEPI, the call is rejected with a status
value of ZAPS-VAL-STATUS-NO-RETRY.
segment-id output
INT .EXT:ref:1
displays the segment ID of the extended segment containing the buffer when the
operation was initiated. For NonStop FTAM operations, this parameter is not
relevant and has the value -1.
Considerations
•
Perform error checking as follows:
1. Immediately after the call to MFM_AWAITIOX_, check the filenum returned.
2. If filenum is a CEPI (a value in the range -10 through -32767), then check
the status value returned by MFM_AWAITIOX_.
If filenum is not a CEPI, check the condition code and/or call FILEINFO with
the filenum value returned by MFM_AWAITIOX_.
•
For a file-system completion, the condition code is identical to that set by
AWAITIOX. For an FTM or APS completion, the condition code has no meaning.
•
To get APS_STATUS_ information from an FTM or APS procedure call in nowait
mode, you must call APS_STATUS_ immediately after the call to
MFM_AWAITIOX_. Between the procedure call and the call to APS_STATUS_, you
can perform error checking, but you cannot call any other FTM or APS procedure
to invoke a primitive or receive an event. APS_STATUS_ provides information only
on the most recently completed primitive or the most recently received event;
information on earlier primitives and events is not queued.
MFM_CANCELREQ_
This procedure allows you to cancel a nowait operation started by a previous FTM or
APS procedure. To cancel a file-system operation, call CANCELREQ instead.
error return value
INT
indicates the outcome of the call. For the possible values of error, see Appendix B,
NonStop FTAM Initiator Error Messages, Table B-2 on page B-4.
error := MFM_CANCELREQ_ ( pseudofn ! I
,[ tag ] ); ! I