OSI/FTAM Programming Reference Manual

FTM Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
4-43
FTM_CREATE_CNF_
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-CREATE-CNF event before calling FTM_CREATE_CNF_.
•
Initial attributes can vary from those requested. The responder might not fully
support all the attributes requested. In such a case, the responder will respond that
no value is available for those attributes not fully supported.
•
The association remains in the FTAM regime if state-result indicates a failure,
or moves to the file-selection regime if state-result indicates success.
•
The following regime transitions occur as a result of these different action results:
°
If the file creation fails, the association remains in the FTAM regime.
°
If the file was created, but the selection of the file failed, the association returns
to the FTAM regime.
°
In the case of file selection only, where the value of the override parameter
of the FTM_CREATE_REQ_ procedure is ZFTM-VAL-OVR-SELECT-OLD, the
association moves to the file-selection regime.
°
If the file was created and selected, the association moves to the file-selection
regime.
Errors
For cause, effect, and recovery information on these errors, see Appendix B, NonStop
FTAM Initiator Error Messages.
Examples
Examples of the FTM_CREATE_CNF_ call in a program begin on line 1063 of the C
version and line 1150 of the TAL version of Example 2 in Appendix G, NonStop FTAM
Programming Examples.
Table 4-13. Possible FTAM Initiator Errors for the FTM_CREATE_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