OSI/FTAM Programming Guide

Using FTM Procedure Calls
HP NonStop OSI/FTAM Programming Guide—528612-001
4-41
Setting Procedure Parameters
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.
4. Call FTM_TRANSFER_END_REQ_ to signify that the application 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.
5. 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.
6. 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.
7. Call FTM_TRANSFER_END_CNF_ to retrieve the data sent by the confirm. Check
the action-result.
If the action-result value is ZFTM-VAL-ACTION-SUCCESS, your application
successfully wrote the file.
Setting Procedure Parameters
To provide your application with details about the file to which you wish to write, use
these parameters of the FTM_WRITE_REQ_ procedure:
1. The fadu-operation parameter allows you to identify what action the responder
should take with the data it receives. Valid values indicate what the responder will
do with the data being sent:
Note. Besides the expected event, you might also receive a cancel event. Both the local
application and the remote responder can issue a cancel request at any time.