OSI/FTAM Programming Guide

Using FTM Procedure Calls
HP NonStop OSI/FTAM Programming Guide—528612-001
4-19
Sample Procedure-Call Sequence
2. To select an FTAM file, call FTM_SELECT_REQ_, giving details about the file you
wish to select. The parameters involved in selecting a file are discussed in
Selecting Files on page 4-21.
a. If the select 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 an error at this stage, 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_SELECT_REQ_ call. MFM_AWAITIOX_ gives you the
status code for the completed procedure 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.
3. To open a file, call FTM_OPEN_REQ_, giving details about the file you wish to
open. The parameters involved in opening an FTAM file are discussed in Opening
Files on page 4-24.
a. If the open 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 an error at this stage, 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_OPEN_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.
4. Call FTM_END_GROUP_REQ_ to signify the end of a group of FTM requests.
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
an error at this stage, call APS_STATUS_, specifying as input the CEPI
returned by the FTM_INITIALIZE_REQ_ procedure for this association.
b. b. If the association is in nowait mode, call MFM_AWAITIOX_ to wait for
completion of the FTM_END_GROUP_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 begin-group confirm event, call APS_EVENT_RECEIVE_. In
wait mode, this procedure returns a status code of ZAPS-VAL-STATUS-EVENT
when you have received an event. If APS_EVENT_RECEIVE_ returns a different
status code, to obtain the details of an error at this stage, call APS_STATUS_,