OSI/FTAM Programming Reference Manual

Running H/F 1
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
3-4
Running H/F 2
TSP, and NSP processes, see the OSI/AS Configuration and Management Manual.
For information about establishing an association and the FTAM programming
concepts that facilitate the flow of data between the FTAM application and the
responding system, see the OSI/FTAM Programming Guide.
The following subsections describe the FTAM API in greater detail, outline the FTAM
functions it supports, and explain how it enables you to transfer, access, and manage
files in an OSI environment.
Types of Procedures in the FTAM API
The initiator supports the FTAM API, which is a collection of system procedures your
program can call to perform FTAM services, such as accessing files on a remote
system that supports FTAM. The FTAM API consists of three types of procedures:
•
FTAM protocol procedures, which begin with the prefix “FTM” and enable the
application to make FTAM service requests of remote responders.
The FTM procedures are sensitive to context: to avoid protocol violations, the
application program must maintain the context in which each call is made. The
FTAM API does not keep track of the procedure-call sequence or the state
changes that occur within the FTAM initiator.
How FTM Procedures Are Categorized on page 3-5, describes these procedures in
greater detail.
•
Several general-support procedures, which begin with the prefix “APS.” These
procedures allocate and deallocate buffer space in the FTAM API and retrieve
event and error information.
•
Module file management procedures, which begin with the prefix “MFM.” If your
program operates in nowait mode, you use the module file management
procedures to receive completion information for I/O requests. For details on
operating in nowait mode, see the OSI/FTAM Programming Guide.
Appendix E, MFM Procedures and Appendix F, APS Procedures provide detailed
information on the MFM and APS procedures included in the FTAM API.
Note. If you are familiar with the OSI/AS API, you might recognize the APS procedures
contained in the FTAM API, which are a small subset of the APS procedures that make up the
OSI/AS API. You might also recognize the MFM procedures. The APS and MFM procedures
that are part of the FTAM API perform functions equivalent to procedures by the same name
that also are part of the OSI/AS API.