FTAM/9000 Programmer's Guide

282 Chapter 7
Managing and Accessing HP FTAM/9000 Files
Gaining Access to FTAM Files
ft_close() (LLCS)
#include %</opt/ftam/include/map.h>
#include %</opt/ftam/include/mapftam.h>
Return_code
ft_close (connection_id, return_event_name, input_dcb,
inout_dcb)
Connection_id connection_id;
Local_event_name return_event_name;
char *input_dcb;
struct Ft_close_out_dcb **inout_dcb;
Use ft_close() to close a file when you finish processing it. After closing
the file, the only actions you can perform on the file without re-opening it
are ft_deselect(), ft_delete(), ft_rattributes(), and ft_cattributes().
• The ft_close() input_dcb parameter does not contain information;
therefore, pass a NULL pointer for the input_dcb parameter.
• Invoke ft_close() in the File Open regime to return to the File
Selection regime.
inout_dcb->
state_result
Output Indicates whether the request moved from the File
Selection to the File Open 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->
contents_type
Output contents_type of the opened file (as accepted by
the responder)
inout_dcb->
concurrency_contro
l
Output concurrency_control of the opened file (as accepted
by the responder)
inout_dcb-
>diagnostic
Output Provides ISO-specific error information
ft_open()
Parameter
Type Description