FTAM/9000 Programmer's Guide

Chapter 7 301

Managing and Accessing HP FTAM/9000 Files

Locating and Erasing FTAM Files

ft_erase()

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

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

Return_code

ft_erase (connection_id, fadu_identity, return_event_name,

input_dcb, inout_dcb)

Connection_id connection_id;

Ft_fadu_identity fadu_identity;

Local_event_name return_event_name;

char *input_dcb;

struct Ft_erase_out_dcb **inout_dcb;

Use ft_erase() to erase a ﬁle's contents; attributes are not erased.

• To erase the entire ﬁle's contents, the fadu_identity.fadu_location

must be FT_FIRST for FTAM-1, FTAM-3, and INTAP-1 and must be

FT_BEGIN for FTAM-2.

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

therefore, pass a NULL pointer for the input_dcb parameter.

• Invoke ft_erase() in the File Open regime; you do not move to another

regime.

• During ft_connect(), you must negotiate the FT_FU_FILE_ACCESS

functional_units to use ft_erase().

• During ft_open(), you must specify FT_PM_ERASE in

processing_mode to use ft_erase().

Ft_erase_out_dcb

struct Ft_erase_out_dcb {

Uint16 size;

struct Api_rc result;

enum Ft_action_result action_result;

struct Ft_diagnostic *diagnostic;

};