FTAM/9000 Programmer's Guide

316 Chapter 8
Transferring HP FTAM/9000 Data
Reading Data
ft_rdata() Parameters
ft_rdata()
Parameter
Type Description
connection_id Mandatory
Input
Uniquely identifies a specific connection to the
filestore
des_requested Mandatory
Input
Maximum number of data elements you want to
receive
return_event_name Mandatory
Input
If the call is asynchronous, uniquely identifies
the function call; if the call is synchronous, the
value is zero
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->
des_received
Output Number of data elements received by this
request if it is successful
inout_dcb->data_unit Output Contains the returned data
inout_dcb->
action_result
Output Specifies the overall success or failure of the
request
inout_dcb->diagnostic Output Provides ISO-specific error information