FTAM/9000 Programmer's Guide

Chapter 7 277
Managing and Accessing HP FTAM/9000 Files
Gaining Access to FTAM Files
ft_select()
#include %</opt/ftam/include/map.h>
#include %</opt/ftam/include/mapftam.h>
Return_code
ft_select (connection_id, filename, requested_access,
return_event_name, input_dcb, inout_dcb)
Connection_id connection_id;
Ft_filename filename;
Ft_file_actions requested_access;
Local_event_name return_event_name;
struct Ft_select_in_dcb *input_dcb;
struct Ft_select_out_dcb **inout_dcb;
Use ft_select() to choose an existing file for file management or access
(e.g., reading attributes, opening a file). You select a file based only on its
filename.
• Invoke ft_select() in the FTAM regime to move to the File Selection
regime.
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 regime 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 attributes of the file you
created (those attributes accepted by the
responder)
inout_dcb-
>diagnostic
Output Provides ISO-specific error information
ft_create()
Parameter
Type Description