OSI/FTAM Programming Guide

Using FTM Procedure Calls
HP NonStop OSI/FTAM Programming Guide—528612-001
4-5
Establishing an Association
Establishing an Association
Only the initiator can initiate associations between the NonStop FTAM initiator and a
remote responder in the OSI environment. This subsection explains the sequence of
procedure calls for requesting and establishing an association with a remote
responder.
To request an association, you call FTM_INITIALIZE_REQ_. When you make this call,
the FTAM API communicates with the local initiator, which in turn sends the initialize
request information across the network to the remote responder. The FTAM API
returns the information about the association attempt in two stages:
•
First, the FTAM initiator completes the initialize request. You receive the status of
the completion directly or, in nowait mode, through MFM_AWAITIOX_. A status of
ZAPS-VAL-STATUS-OK means that the initialize request PDU was successfully
sent.
•
Second, if the initialize request PDU was successfully sent, you should receive an
initialize confirm primitive. This primitive confirms that the responder acted upon
the initialize service. A state-result value of ZFTM-VAL-STATE-SUCCESS and
action-result value of ZFTM-VAL-ACTION-SUCCESS mean that the
association was successfully established.
Your application program can have a number of associations active simultaneously
with the same or different remote responders. When you establish an association, the
FTAM API allocates a CEPI that the application uses to identify the association.
Procedure-Call Sequence
Table 4-3 on page 4-6 shows the sequence of procedures to call and describes the
steps to establish an FTAM association. Sometimes you can omit a procedure call
associated with a substep, depending on the context.
Table 4-2. Procedure Sequence for Receiving an Event
Step Action to Take Procedure(s) to Call
1 Get the event. APS_EVENT_RECEIVE_
2 Check status: What is the event? Or, if
APS_EVENT_RECEIVE_ returns a status other than
ZAPS-VAL-STATUS-EVENT, is there an error?
APS_STATUS_
3 Retrieve indication or confirm information. FTM indication or confirm
procedure