OSI/FTAM Programming Guide

Using FTM Procedure Calls
HP NonStop OSI/FTAM Programming Guide—528612-001
4-3
Programming Tasks
The subsections that follow explain in detail how you can perform most of the
programming tasks listed in Table 4-1 on page 4-2. Each subsection lists the sequence
of procedures that you must call to complete the task in either wait mode or nowait
mode and provides step-by-step instructions, including important information about
input and output parameters. Some of the procedures in the tables showing call
sequence are optional. In the case of an error condition or when operating in nowait
mode, you call them in the sequence shown.
The OSI/FTAM Programming Reference Manual contains important reference
information to supplement the information contained in this section. See that manual
for information on the following:
•
Data structures used in procedure-call parameters. The identifiers of the
corresponding data structures appear parenthetically after the parameter name
when it is first mentioned in describing a task in this manual. The source code for
the FTM data structures resides in the files ZFTMDDL, ZFTMC, and ZFTMTAL in
the ZOSIFTAM distribution subvolume.
•
Status and error codes that can be returned by the FTM procedures.
•
Example programs illustrating how to perform all the tasks listed in Table 4-1 on
page 4-2. Note that Section 5, NonStop FTAM Programming Examples also
Reading Attributes FTM_READ_ATTRIB_REQ_ I/O
FTM_READ_ATTRIB_CNF_ Local
Changing Attributes FTM_CHANGE_ATTRIB_REQ_ I/O
FTM_CHANGE_ATTRIB_CNF_ Local
Locating Nodes FTM_LOCATE_REQ_ I/O
FTM_LOCATE_CNF_ Local
Erasing Files FTM_ERASE_REQ_ I/O
FTM_ERASE_CNF_ Local
Handling Cancel
Indications
FTM_CANCEL_IND_ Local
FTM_CANCEL_RSP_ I/O
Generating Cancels FTM_CANCEL_REQ_ I/O
FTM_CANCEL_CNF_ Local
Handling P-Aborts FTM_P_ABORT_IND_ Local
Handling U-Aborts FTM_U_ABORT_IND_ Local
Generating U-Aborts FTM_U_ABORT_REQ_ I/O
Discarding the Association
Context
APS_DISCARD_ Local
Checking Status APS_STATUS_ Local
Table 4-1. FTAM Programming Tasks and Procedure Calls (page 2 of 2)
FTAM Programming Task Associated FTAM Procedure Calls Procedure Call Type