OSI/FTAM Programming Guide

Using FTM Procedure Calls
HP NonStop OSI/FTAM Programming Guide—528612-001
4-18
Sample Procedure-Call Sequence
These steps explain the sequence of procedure calls given in Table 4-8 on page 4-17.
1. The FTM_BEGIN_GROUP_REQ_ procedure signifies the start of a group of FTM
procedure requests. The responder processes and responds to these requests as
a group.
To use this procedure, you must set the threshold parameter. For details on setting
the threshold parameter, see the following subsection.
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. If the association is in nowait mode, call MFM_AWAITIOX_ to wait for
completion of the FTM_BEGIN_GROUP_REQ_ call. MFM_AWAITIOX_ gives
you the status code for the completed procedure call. For more information on
the MFM_AWAITIOX_ procedure, refer to the OSI/FTAM Programming
Reference Manual.
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.
8 Check status: Is the event a select confirm? Or,
if APS_EVENT_RECEIVE_ returns a status
other than ZAPS-VAL-STATUS-EVENT, what is
the error?
APS_STATUS_
9 Retrieve service confirm information. FTM_SELECT_CNF_
10 Get the next event. APS_EVENT_RECEIVE_
a. If nowait mode, await completion. MFM_AWAITIOX_
11 Check status: Is the event an open confirm?
Or, if APS_EVENT_RECEIVE_ returns a status
other than ZAPS-VAL-STATUS-EVENT, is
there an error?
APS_STATUS_
12 Retrieve service confirm information. FTM_OPEN_CNF_
13 Get the next event. APS_EVENT_RECEIVE_
a. If nowait mode, await completion. MFM_AWAITIOX_
14 Check status: Is the event an end-group
confirm? Or, if APS_EVENT_RECEIVE_
returns a status other than
ZAPS-VAL-STATUS-EVENT, is there an error?
APS_STATUS_
Table 4-8. Calls for Selecting and Opening FTAM Files Using Two Grouped
Services (page 2 of 2)
Step Action to Take Procedure(s) to Call