OSI/FTAM Programming Guide

Using FTM Procedure Calls
HP NonStop OSI/FTAM Programming Guide—528612-001
4-30
The File Open Procedure
FTM_INITIALIZE_REQ_ call. The remote responder will reject the file selection if
the access passwords for the requested actions do not match the responder’s
access passwords. If the parameter is not supplied, the initiator will not send any
passwords to the remote responder.
If the file-status parameter specifies creating a new file or recreating a file with
new attributes, the access-passwords attribute only verifies any delete actions. The
initial-attrib (ZFTM-DDL-CREATE-ATTR-GRP) parameter of this call
includes the appropriate passwords for other actions on the selected file.
5. The initial-attrib (ZFTM-DDL-CREATE-ATTR-GRP) parameter allows you
to define 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. A value must
always be assigned to these two attributes.
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 filename 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 for which the initiator does not assign values
via the initial-attrib parameter, the remote responder can supply its own
default values.
The initiator and remote responder must negotiate the appropriate attribute group
on the FTM_INITIALIZE_REQ_ call for an attribute to be defined at file creation.
initial-attrib is a conditional parameter. If file-status is equal to
ZFTM-VAL-FOPEN-OLD, you should not specify a value for initial-attrib.
For all other values of file-status, you must specify at least the filename
attribute and the document-type components of the contents-type attribute in the
value for initial-attrib; if you do not, an error is returned.
6. The create-password (ZAPS-DDL-CHAR32) parameter is an optional
parameter that can be used to verify that the user identified by initiator-id
has permission to create files in the current file system. If you do not supply
create-password, the initiator will not send a password to the remote
responder. You do not need to specify create-password for any file with a
file-status value of ZFTM-VAL-FOPEN-OLD.
7. The process-mode (ZFTM-DDL-PROC-MODE) parameter allows you to specify
the actions permitted on the file after establishment of the file-open regime. This
parameter indicates the valid actions for access control and bulk data transfer
requests and determines which file-system actions the responder can perform.
The process-mode parameter is a string of Boolean fields, and each Boolean
field can take on the values ZAPS-VAL-TRUE or ZAPS-VAL-FALSE. The fields and
default values for process-mode include: