OSI/FTAM Programming Reference Manual

FTM Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
4-136
FTM_SELECT_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 selected file as returned from the remote responder. The name
will be 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.
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_SELECT_CNF_, you must call the following procedures:
FTM_SELECT_REQ_
APS_EVENT_RECEIVE_
APS_STATUS_
You call APS_EVENT_RECEIVE_ to receive the confirm event and
APS_STATUS_ to determine, via the APS_STATUS_ event-code parameter, the
proper confirm procedure to use to retrieve the data. You must receive the
ZFTM-VAL-EVT-SELECT-CNF event before calling FTM_SELECT_CNF_.
•
Depending on the value of state-result, the association moves to the
file-selection regime (ZFTM-VAL-ACTION-SUCCESS), or remains in the FTAM
regime (ZFTM-VAL-ACTION-FAILURE).