OSI/FTAM Programming Guide
Using FTM Procedure Calls
HP NonStop OSI/FTAM Programming Guide—528612-001
4-24
Opening Files
file if the access passwords for the requested actions do not match the responder’s
access passwords. If you do not supply the parameter, the initiator does not send
passwords to the remote responder.
4. The account (ZAPS-DDL-CHAR32) parameter identifies the account to charge for
any costs incurred in the regime being established. If you do not supply account,
no account name will be supplied to the remote responder.
Some responders require an account identifier. For information on the accounting
methods being used, refer to the responder documentation.
Opening Files
You can use two procedures to open files. Use the open procedure to open a
previously selected FTAM file. Opening a previously selected file makes the contents
of that file available for access. Use the file-open procedure to create, select, and open
an FTAM file as a grouped service.
The Open Procedure
This subsection describes the steps to follow to open a previously selected FTAM file
and gives details on how to set the parameters of the FTM_OPEN_REQ_ procedure.
Procedure-Call Sequence
Table 4-10 shows the sequence of procedures to call and describes the steps to open
an FTAM file. Sometimes you can omit a procedure call associated with a substep,
depending on the context. The sequence of procedures is explained after the table.
Table 4-10. Calls for Opening an FTAM File Using FTM_OPEN_REQ_
Step Action to Take Procedure(s) to Call
1 Open the previously selected file. FTM_OPEN_REQ_
a. If error returned by FTM_OPEN_REQ_, check status. APS_STATUS_
b. If nowait mode, await completion of
FTM_OPEN_REQ_.
MFM_AWAITIOX_
c. If error returned by MFM_AWAITIOX_, check status. APS_STATUS_
2 Get the next event. APS_EVENT_RECEIV
E_
a. If nowait mode, await completion of
APS_EVENT_RECEIVE_.
MFM_AWAITIOX_
3 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_
4 Retrieve service confirm information. FTM_OPEN_CNF_