OSI/FTAM Programming Guide

HP NonStop OSI/FTAM Programming Guide—528612-001
4-1
4 Using FTM Procedure Calls
This section provides instructions on how to use the FTAM procedures to perform
operations common to many FTAM applications.
This section covers these topics:
Programming Tasks
To perform high-level application tasks, such as copying a file from one system to
another or updating a remote file, your application has to perform a sequence of
operations. For instance, it has to establish an association, select and open a file, and
possibly perform several other operations before initiating a data transfer. Table 4-1 on
page 4-2 lists common operations that are building blocks for accomplishing higher
level tasks in a NonStop FTAM application. It also lists the APS and FTM procedure
calls used to perform the operations. The table’s third column indicates whether a
procedure causes I/O operations or runs locally.
In nowait mode, you must call the MFM_AWAITIOX_ procedure to complete
procedures that cause an I/O operation. There is no need to call the MFM_AWAITIOX_
procedure to complete nowait procedure calls that do not cause I/O operations.
Topic Page
Programming Tasks
4-1
Initializing the API 4-4
Receiving an Event 4-4
Establishing an Association 4-5
Terminating an Association 4-10
Creating Files 4-11
Grouping Control 4-15
Selecting Files 4-21
Opening Files 4-24
Closing Files 4-31
Deselecting Files 4-35
Deleting Files 4-36
Writing Files 4-38
Reading Files 4-43
Handling Cancel Indications 4-48
Generating Cancels 4-49
Handling P-Aborts and U-Aborts 4-51
Generating U-Aborts 4-52
Handling Errors 4-53