FTAM/9000 Programmer's Guide

292 Chapter 7

Managing and Accessing HP FTAM/9000 Files

Opening and Closing Files (HLCS)

ft_fclose() (HLCS)

#include %</opt/ftam/include/map.h>

#include %</opt/ftam/include/mapftam.h>

Return_code

ft_fclose (connection_id, delete_action,

return_event_name, input_dcb, inout_dcb)

Connection_id connection_id;

enum Ft_delete_action delete_action;

Local_event_name return_event_name;

char *input_dcb;

struct Ft_fclose_out_dcb **inout_dcb;

Use ft_fclose() to close a ﬁle, and then either deselect or delete it (rather

than invoking the low level ft_close() function with ft_deselect() or

ft_delete()).

• Invoke ft_fclose() in the File Open regime to move back to the FTAM

regime.

• The delete_action parameter determines whether the ﬁle is deleted or

deselected.

• The ft_close() input_dcb parameter does not contain information;

therefore, pass a NULL pointer for the input_dcb parameter.

Ft_fclose_out_dcb

struct Ft_fclose_out_dcb {

Uint32 size;

struct Api_rc result;

enum Ft_action_result action_result;

struct Ft_diagnostic *diagnostic;

};