FTAM/9000 Programmer's Guide

300 Chapter 7
Managing and Accessing HP FTAM/9000 Files
Locating and Erasing FTAM Files
ft_locate() Parameters
ft_locate()
Parameter
Type Description
connection_id Mandatory Input Uniquely identifies a specific connection to the
filestore
fadu_identity Mandatory Input Identifies the FADU to locate (FTAM-2 only)
return_event_name Mandatory Input If the call is asynchronous, uniquely identifies
the function call; if the call is synchronous, the
value is 0 (zero)
input_dcb Optional input Contains no information; pass a NULL pointer
inout_dcb->size Mandatory
input if using
inout_dcb
Size (in Octets) of the inout_dcb structure and
data
inout_dcb->result Output Pointer to the struct Api_rc containing the
outcome of the operation: result_code and
vendor_code (HP-UX—specific error)
inout_dcb->
action_result
Output Specifies the overall success or failure of the
request
inout_dcb->
fadu_identity
Output fadu_identity of the FADU you located (FTAM-2
only)
inout_dcb-
>diagnostic
Output Provides ISO-specific error information