OSI/FTAM Programming Guide

NonStop FTAM Programming
HP NonStop OSI/FTAM Programming Guide—528612-001
3-30
NBS-9 Files
To find out how to perform local operations on unstructured and entry-sequenced files,
see the ENSCRIBE Programmer’s Guide.
NBS-9 Files
An NBS-9 file provides a way to retrieve file directory information from a remote
responder. You can only read NBS-9 files; all other operations are invalid.
To read an NBS-9 file, select a file named DIRLIS. Some responder implementations
allow path information to prefix this name.
You must open the file 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 directory file is returned in successive F-DATA
indications.
Figure 3-12 on page 3-31 shows the format of the data-value parameter for NBS-9
files. Each data element provides directory information for an individual file. To select
the amount of information returned by this read operation, set the ZFILEATTRS field of
the contents-type (ZFTM-DDL-CNTNTS-TYPE) parameter on the
FTM_OPEN_REQ_ or FTM_FILE_OPEN_REQ_ call to all or a subset of the FTAM file
attributes. Only the file attributes you choose are returned.
Note. Remember that the native character sets (ASCII, EBCDIC, and so on) might be
incompatible on the sending and receiving systems. For example, NonStop systems use the
7-bit ASCII character set, whereas some other vendors’ systems use 8-bit EBCDIC. If you
decide to send or receive text characters as FTAM-3 binary data, some conversion of the
native character set might be necessary.