OSI/FTAM Programming Reference Manual

FTM Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
4-92
FTM_FILE_OPEN_CNF_
contents-type 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.
The initiator can also return the informative diagnostic message ZFTM-DIAG-
CNTNTS-TYPE-SIMPLE (5037) on this call. For more information on this
diagnostic message, see Appendix D, NonStop FTAM Initiator Diagnostic
Messages.
diagnostic is an optional parameter.
Considerations
•
To successfully complete this procedure call, you must have previously called
FTM_FILE_OPEN_REQ_, and the association must be in the FTAM regime.
•
You must 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-FILEOPEN-CNF event before calling FTM_FILE_OPEN_CNF_.
•
The association either stays in the FTAM regime if state-result indicates a
failure, or moves to the file-open regime if state-result indicates success.
Errors
For cause, effect, and recovery information on these errors, see Appendix B, NonStop
FTAM Initiator Error Messages.
Examples
Examples of the FTM_FILE_OPEN_CNF_ call in a program begin on line 1100 of the
C version and line 1062 of the TAL version of Example 1 in Appendix G, NonStop
FTAM Programming Examples.
Table 4-28. Possible FTAM Initiator Errors for the FTM_FILE_OPEN_CNF_
Procedure
Error Code FTAM Initiator Error
- 6000 ZFTM-ERR-INTERNAL
- 6017 ZFTM-ERR-INVALID-IF-VERSION
- 6018 ZFTM-ERR-INVALID-FIELD-VERSION
- 6036 ZFTM-ERR-SU-ABORTED