OSI/FTAM Programming Reference Manual

FTM Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
4-112
FTM_LOCATE_CNF_
returns the FADU identity. For a full explanation of this parameter and its usage,
see the OSI/FTAM Programming Guide.
fadu-id 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, you must have previously called
FTM_LOCATE_REQ_, and the association must be in the file-open regime.
•
Before calling FTM_LOCATE_CNF_, you must call the following procedures:
FTM_LOCATE_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-LOCATE- CNF event before calling FTM_LOCATE_CNF_.
Errors
For cause, effect, and recovery information on these errors, see Appendix B, NonStop
FTAM Initiator Error Messages.
Example
For an example of a TAL program illustrating the use of the FTM_LOCATE_CNF_
procedure, see the Example on page 4-109 in the FTM_LOCATE_REQ_ procedure
description.
Table 4-32. Possible FTAM Initiator Errors for the FTM_LOCATE_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