FTAM/9000 Programmer's Guide

Chapter 7 299

Managing and Accessing HP FTAM/9000 Files

Locating and Erasing FTAM Files

Use the ft_locate() to locate FADUs (FTAM-2) and ft_erase() to erase

FTAM ﬁles.

ft_locate()

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

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

Return_code

ft_locate (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_locate_out_dcb **inout_dcb;

Use ft_locate() to locate a speciﬁc FADU within a ﬁle. Hence, use

ft_locate() only on FTAM-2 document types. For example, you might

want to locate the current FADU in an FTAM-2 ﬁle so that you can read

it.

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

therefore, pass a NULL pointer for the input_dcb parameter.

• Invoke ft_locate() 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_locate().

Ft_locate_out_dcb

struct Ft_locate_out_dcb {

Uint32 size;

struct Api_rc result;

enum Ft_action_result action_result;

struct Ft_fadu_identity *fadu_identity;

struct Ft_diagnostic *diagnostic;

};