OSI/FTAM Programming Reference Manual

FTM Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
4-50
FTM_DATA_REQ_
Considerations
•
To complete this procedure call successfully, the association must be in the
data-transfer regime.
•
You must issue an MFM_AWAITIOX_ call to complete the nowait I/O operation if
you set the nowait operating mode in the FTM_INITIALIZE_REQ_ call.
•
The encoded PDU is limited to 16 KB. For more information on calculating the size
of the encoded PDU, see the OSI/FTAM Programming Guide.
•
The data-value parameter is identical for both the FTM_DATA_REQ_ and the
FTM_DATA_IND_ procedure calls. This parameter consists of a data header
followed by a series of one or more data elements. Each data element consists of
a data element header and the actual data.
ZAPS-DDL-DATA-HDR and ZAPS-DDL-DATA-ELEMENT-HDR are defined in the
file ZAPSDDL. The TAL and C equivalents are located in the files ZAPSTAL and
ZAPSC, respectively. For descriptions of both structures, see Appendix A, DDL
Definitions.
All structures begin on word boundaries. If the length of one of the data elements is
an odd number, you must end the data with a pad byte. For sample code
illustrating how to accommodate this requirement, see the OSI/FTAM
Programming Guide.
The structure of individual data elements specified in the data-value parameter
varies, depending on the contents type of the file being transferred. The valid
Figure 4-2. Structure of the Data-Value Parameter
VST0402.vsd
ZAPS-DDL-DATA-ELEMENT-HDR
Data
.
.
.
Data
Element
ZAPS-DDL-DATA-HDR
ZAPS-DDL-DATA-ELEMENT-HDR
Data
ZAPS-DDL-DATA-ELEMENT-HDR
Data