OSI/FTAM Programming Reference Manual

FTM Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
4-91
FTM_FILE_OPEN_CNF_
A value of ZFTM-VAL-ACTION-SUCCESS indicates that the operation was
successful. Even for a successful operation, the diagnostic parameter might
include one or more informative messages. A value of ZFTM-VAL-ACTION-
FAILURE indicates that the operation was not successful, and diagnostic is
likely to contain one or more diagnostic messages.
action-result is an optional parameter.
filename output
INT .EXT:ref:(ZAPS-DDL-CHAR128)
is the name of the opened file as returned from the remote responder. The name
can have a maximum of 128 characters. If the responder returns a name that is
greater than 128 characters, the initiator passes only the first 128 characters to the
application.
filename is an optional parameter.
initial-attrib output
INT .EXT:ref:(ZFTM-DDL-CREATE-ATTR-GRP)
defines the file attributes associated with the created file. The remote responder
can respond that no value is available for a proposed attribute if it does not support
the attribute, except for the filename and permitted-actions attributes to which
values must be assigned.
The only attributes to which the remote responder can assign a different value from
the one proposed by the initiator are filename and permitted-actions, for a create
operation, and permitted-actions only, for a select operation. For all other file
attributes, the remote responder must either accept the proposed value or respond
that no value is available. In the case of attributes to which the initiator does not
assign values in the initial-attrib parameter in the
FTM_FILE_OPEN_REQ_, the remote responder can supply its own default values.
You must have negotiated the appropriate attribute group on the
FTM_INITIALIZE_REQ_ call for an attribute to be defined at file creation.
initial-attrib is an optional parameter.
contents-type output
INT.EXT:ref:(ZFTM-DDL-CNTNTS-TYPE)
returns the contents type of the file that was opened. The contents type returned is
a document type name with appropriate parameters.
If the application specified a value of ZFTM-VAL-FOPEN-NEW (0) or ZFTM-VAL-
FOPEN-RECREATE (3) for the file-status parameter on the
FTM_FILE_OPEN_REQ_, the maximum-string-length value returned as part
of this parameter must match the value proposed on the FTM_FILE_OPEN_REQ_
call. If the two values do not match, the initiator generates a provider abort.