OSI/FTAM Programming Guide

Using FTM Procedure Calls
HP NonStop OSI/FTAM Programming Guide—528612-001
4-31
Closing Files
8. The contents-type (ZFTM-DDL-CNTNTS-TYPE) parameter allows you to
specify the FTAM document type. The document type must either match the
document type of the file being opened or be an allowed simplification of the
contents type.
If you do not specify contents-type, the default value is
ZFTM-VAL-CNTNTSTYPE-UNKNOWN, and the remote responder returns the
valid contents-type information for the file, which you retrieve via the
FTM_FILE_OPEN_CNF_ procedure call.
If you do specify contents-type, the information includes a document type with
associated parameters (universal-class, string-significance, and
maximum-string-length are optional parameters). For a full description of
contents-type and its usage, see Section 2, ISO FTAM Concepts.
Supported document types and their corresponding object identifiers include:
Closing Files
You can use two procedures to close files. The close procedure allows you to close a
file but leave it selected. Closing a previously opened file makes the contents of that
file unavailable for access. The file-close procedure allows you to group the close,
deselect, and, optionally, delete services into one procedure.
The Close Procedure
Table 4-12 on page 4-32 shows the sequence of procedures to call and describes the
steps to close an FTAM file using FTM_CLOSE_REQ_. Sometimes you can omit a
procedure call associated with a substep, depending on the context. The sequence of
procedures is explained after the table.
Field Name Associated Action Default Value
ZREAD Read a FADU in the file. TRUE
ZINSERT Insert data into the file. FALSE
ZREPLACE Replace information in
the file.
FALSE
ZEXTEND Extend the file. FALSE
ZERASE Erase some or all the
contents of the file.
FALSE
Document Type Object Identifier
FTAM-1 { 1 0 8571 5 1 }
FTAM-2 { 1 0 8571 5 2 }
FTAM-3 { 1 0 8571 5 3 }
NBS-9 { 1 3 14 5 5 9 }