OSI/FTAM Programming Guide

Using FTM Procedure Calls
HP NonStop OSI/FTAM Programming Guide—528612-001
4-46
Procedure-Call Sequence
more-data, see the description of FTM_DATA_IND_ in the OSI/FTAM
Programming Reference Manual.
5. To receive the next event, call APS_EVENT_RECEIVE_. 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.
6. If you have received an event, call APS_STATUS_ to determine which event. If the
event code is ZFTM-VAL-EVT-DATA-IND, you received a data indication. If the
event code is ZFTM-VAL-EVT-DATAEND-IND, you received a data-end indication;
go to Step 7.
7. Call FTM_DATA_END_IND_ to retrieve the user data received by
APS_EVENT_RECEIVE_. If action-result is ZFTM-VAL-ACTION-SUCCESS,
the transfer was successful.
8. Call FTM_TRANSFER_END_REQ_ to indicate that the responder does not need
to transfer any more data.
a. If the transfer-end procedure fails, it returns a status code other than
ZAPS-VAL-STATUS-OK. To obtain the details of an error, call APS_STATUS_,
specifying as input the CEPI returned by the FTM_INITIALIZE_REQ_
procedure for this association.
b. If the association is in nowait mode, call MFM_AWAITIOX_ to wait for
completion of the FTM_TRANSFER_END_REQ_ call.
c. If you call MFM_AWAITIOX_ and the status code returned is not
ZAPS-VAL-STATUS-OK, call APS_STATUS_, specifying as input the CEPI
returned by the FTM_INITIALIZE_REQ_ procedure for this association.
9. Next, to receive a transfer-end confirm event, call APS_EVENT_RECEIVE_. 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.
10. If you received an event, call APS_STATUS_ to determine which event. If the event
code is ZFTM-VAL-EVT-TRANSEND-CNF, you received a transfer-end confirm.