OSI/FTAM Programming Reference Manual

FTM Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
4-117
FTM_OPEN_CNF_
FTM_OPEN_CNF_
This procedure allows you to retrieve the remote responder’s response to the
application’s request to open the previously selected file.
error return value
INT
indicates the outcome of the call. For a list of defined values, see Appendix B,
NonStop FTAM Initiator Error Messages.
cepi input
INT:value
is the connection endpoint identifier (CEPI) used to identify the specific
association. Use the CEPI value returned from the FTM_INITIALIZE_REQ_
procedure for this association. For additional information on using the cepi
parameter, see the OSI/FTAM Programming Guide.
cepi is a required parameter.
state-result output
INT(32) .EXT:ref:1
indicates whether the responder established the file-open regime as requested.
Valid values are as follows:
ZFTM-VAL-STATE-SUCCESS
ZFTM-VAL-STATE-FAILURE
state-result is an optional parameter.
action-result output
INT(32) .EXT:ref:1
summarizes information available in the diagnostic parameter. The action-
result value is never less severe than the most severe diagnostic value.
Valid values are the following:
ZFTM-VAL-ACTION-SUCCESS
ZFTM-VAL-ACTION-FAILURE
A value of ZFTM-VAL-ACTION-SUCCESS indicates that the operation was
successful. Even for a successful operation, the diagnostic parameter might
error := FTM_OPEN_CNF_ ( cepi ! I
, [ state-result ] ! O
, [ action-result ] ! O
, [ contents-type ] ! O
, [ diagnostic ] ) ; ! O