OSI/FTAM Programming Guide

Using FTM Procedure Calls
HP NonStop OSI/FTAM Programming Guide—528612-001
4-13
Setting Procedure Parameters
If the state-result value is ZFTM-VAL-STATE-SUCCESS and the
action-result value is ZFTM-VAL-ACTION-SUCCESS, the file was created
and has been selected. If the state-result value is
ZFTM-VAL-STATE-FAILURE and the action-result value is
ZFTM-VAL-STATE-SUCCESS, the file was created, but not selected.
Setting Procedure Parameters
To provide details about the file you wish to create, use these parameters of the
FTM_CREATE_REQ_ procedure:
1. The initial-attrib (ZFTM-DDL-CREATE-ATTR) parameter 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. 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 all other file attributes, the
remote responder must either accept the proposed value or respond that no value
is available.
The application must have negotiated the appropriate attribute group on the
FTM_INITIALIZE_REQ_ call to define an attribute at file creation. You must specify
at least the filename attribute and the document type and
maximum-string-length components of the contents-type attribute in this
parameter.
2. The override parameter specifies the action to take if the named file already
exists. Valid values are defined below. The default override value is
ZFTM-VAL-OVR-CREATE-FAIL.
Value Name and Code
If File Does Not
Exist... If File Exists...
ZFTM-VAL-OVR-CREATE-FAIL (0) New file is created. Call fails.
ZFTM-VAL-OVR-SELECT-OLD (1) New file is created. File is selected (the
F-CREATE primitive is not
called).
ZFTM-VAL-OVR-CREATE-OLD (2) New file is created. File is deleted, and a new
file having the same file
attributes as the old file is
created.
ZFTM-VAL-OVR-CREATE-NEW (3) New file is created. File is deleted, and a new
file is created using the file
attributes specified in the
initial-attrib
parameter.