OSI/FTAM Programming Guide

Using FTM Procedure Calls
HP NonStop OSI/FTAM Programming Guide—528612-001
4-48
Handling Cancel Indications
Handling Cancel Indications
Table 4-18 shows the sequence of procedures to call and describes the steps to
handle a cancel indication. Sometimes you can omit a procedure call associated with a
substep, depending on the context. The sequence of procedures is explained after the
table.
These steps explain the sequence of procedure calls given in Table 4-18.
1. Call APS_EVENT_RECEIVE_ to determine whether an event has been returned. If
the association is in wait mode, this procedure returns a status code of
ZAPS-VAL-STATUS-EVENT when you receive an event. If
APS_EVENT_RECEIVE_ returns a different status code, to obtain the details of an
error at this stage, call APS_STATUS_, specifying as input the CEPI returned by
the FTM_INITIALIZE_REQ_ procedure for this association.
a. If the association is in nowait mode, call MFM_AWAITIOX_ to wait for
completion of the APS_EVENT_RECEIVE_ call and to obtain the status code.
A status code of ZAPS-VAL-STATUS-EVENT means you received an event.
2. If you have received an event, call APS_STATUS_ to determine which event. If the
event code is ZFTM-VAL-EVT-CANCEL-IND, you received a cancel indication.
3. Call FTM_CANCEL_IND_ to retrieve information on the remote responder’s cancel
request.
4. Call FTM_CANCEL_RSP_ to send a response to the system cancelling the
service.
a. If the procedure succeeds, it returns a status code of ZAPS-VAL-STATUS-OK.
If the procedure fails, it returns a different status code. To obtain the details of
Table 4-18. Calls for Handling Cancel Indications
Step Action to Take Procedure(s) to Call
1 Get the next event. APS_EVENT_RECEIVE_
a. If nowait mode, await completion of
APS_EVENT_RECEIVE_.
MFM_AWAITIOX_
2 Check status: is the event an F-CANCEL indication?
Or, if APS_EVENT_RECEIVE_ returns a status other
than ZAPS-VAL-STATUS-EVENT, is there an error?
APS_STATUS_
3 Get the indication data. FTM_CANCEL_IND_
4 Issue a cancel response. FTM_CANCEL_RSP_
a. If error returned by FTM_CANCEL_RSP_, check
status.
APS_STATUS_
b. If nowait mode, await completion of
FTM_CANCEL_RSP_.
MFM_AWAITIOX_
c. If error returned by MFM_AWAITIOX_, check status. APS_STATUS_