OSI/FTAM Programming Guide

NonStop FTAM Programming
HP NonStop OSI/FTAM Programming Guide—528612-001
3-21
FTAM-1 Files
Figure 3-6 shows a typical FTAM-1 or FTAM-3 data-value parameter where the
string-significance parameter has the value
ZFTM-VAL-STRINGSIG-VARIABLE.
Reading FTAM-1 Files
To read an FTAM-1 file, you must first open the file (using FTM_OPEN_REQ_ or
FTM_FILE_OPEN_REQ_) with a process-mode (ZFTM-DDL-PROC-MODE)
parameter value of read. Use a fadu-id (ZFTM-DDL-FADU-ID) parameter value of
first on the FTM_READ_REQ_ call. The entire file is then returned on successive
F-DATA indication events. After receiving each data indication event (ZFTM-VAL-EVT-
DATA-IND), call FTM_DATA_IND_ one or more times to retrieve the data. Each
encoded string in the F-DATA indication is placed in a separate data element as raw
data. Figure 3-4 on page 3-20, Figure 3-5 on page 3-20, and Figure 3-6 show possible
structures for the data-value parameter.
If the universal-class parameter of the contents type, returned by the
FTM_FILE_OPEN_CNF_ or FTM_OPEN_CNF_ call, indicates a character set with
format effectors (characters that control the formatting of information on
character-imaging devices, included in universal-classes 21, 22, and 27), embedded
carriage return/line-feed pairs are interpreted as end-of-line indicators. If the
universal-class contains no format effectors, the file will be read with no indications of
line separation.
Document semantics, therefore, is not necessarily preserved.
Figure 3-6. FTAM-1 or FTAM-3 Data-Value Parameter With String-Significance =
ZFTM-VAL-STRINGSIG-VARIABLE
VST0306.vsd
ZAPS-DDL-DATA-ELEMENT-HDR
(length < max string length)
Data element
.
.
.
ZAPS-DDL-DATA-HDR
ZAPS-DDL-DATA-ELEMENT-HDR
(length < max string length)
Data element
ZAPS-DDL-DATA-ELEMENT-HDR
(length < max string length)
Data element
_
_
_