OSI/FTAM Programming Reference Manual

FTM Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
4-42
FTM_CREATE_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.
initial-attrib output
INT .EXT:ref:(ZFTM-DDL-CREATE-ATTR)
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. To these two attributes, the remote responder can assign
a different value from the one proposed by the initiator. For all other file attributes,
the remote responder must either accept the proposed value or respond that no
value is available. If the initiator proposes no value for this parameter, the remote
responder can supply its own default value for this parameter. The appropriate
attribute group must be negotiated on the FTM_INITIALIZE_REQ_ call for an
attribute to be defined at file creation.
If the application specified a value of ZFTM-VAL-OVR-CREATE-FAIL (0) or
ZFTM-VAL-OVR-CREATE-NEW (3) for the override parameter on the
FTM_CREATE_REQ_, the maximum-string-length value returned as part of
the contents-type attribute in this parameter must match the value proposed on the
FTM_CREATE_REQ_ call.
initial-attrib is an optional parameter.
diagnostic output
INT .EXT:ref:(ZFTM-DDL-DIAGNOSTIC)
provides information that qualifies the success or explains the failure of a
requested action. For a complete list of possible diagnostic values, see
Appendix C, ISO FTAM Diagnostic Messages.
diagnostic is an optional parameter.
Considerations
•
To complete this procedure call successfully, the association must be in the FTAM
regime.
•
Before calling FTM_CREATE_CNF_, you must call the following procedures:
FTM_CREATE_REQ_
APS_EVENT_RECEIVE_
APS_STATUS_