FTAM/9000 Programmer's Guide

266 Chapter 6
Managing HP FTAM/9000 Connections
Aborting Connections
Aborting Connections
Use ft_abort() to abort a connection and ft_ireceive() to determine why
you received an abort indication.
ft_abort()
#include %</opt/ftam/include/map.h>
#include %</opt/ftam/include/mapftam.h>
Return_code
ft_abort(connection_id, return_event_name, input_dcb,
inout_dcb)
Connection_id connection_id;
Local_event_name return_event_name;
struct Ft_abort_in_dcb *input_dcb;
struct Ft_output **inout_dcb;
Use ft_abort() to abruptly terminate a connection at any time (i.e., in any
regime).
NOTE If you abort while writing data, you could lose any or all data written
during that transfer; you will not, however, lose the source file.
Ft_abort_in_dcb
struct Ft_abort_in_dcb {
struct Ft_abort_req_info info;
};
struct Ft_abort_req_info {
enum Ft_action_result action_result;
struct Ft_diagnostic *diagnostic;
};
Ft_output
struct Ft_output {
Uint32 size;
struct Api_rc result;
};