FTAM/9000 Programmer's Guide

Chapter 7 279
Managing and Accessing HP FTAM/9000 Files
Gaining Access to FTAM Files
requested_access Mandatory
Input
Specifies the actions you want available for the
connection (during the File Selection regime and
those regimes nested within it)
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-
>attributes
Optional input FTAM does not use this field; provided for future
use
input_dcb->
file_passwords
Optional Input Passwords associated with the actions specified
by requested_access
input_dcb->account Optional Input HP-UX responders accept, but ignore, this value
input_dcb->
concurrency_control
Optional Input File access locks required on the actions specified
in requested_access
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->
state_result
Output Indicates whether the request moved from the
FTAM to the File Selection regime; if a failure
returns, you will also receive an action_result of
FT_AR_PERMANENT_ERROR
inout_dcb->
action_result
Output Specifies the overall success or failure of the
request
inout_dcb-
>attributes
Output Contains values of the filename attribute of the
file you selected HP-UX responders accept, but
ignore, this value
inout_dcb-
>diagnostic
Output Provides ISO-specific error information
ft_select()
Parameter
Type Description