FTAM/9000 Programmer's Guide

328 Chapter 8
Transferring HP FTAM/9000 Data
Ending Data Transfer
Use ft_cancel() to prematurely terminate the transferring of data. Using
ft_cancel() does not abort the entire connection (as does ft_abort()). An
example of using ft_cancel() could be when you are reading data from one
FTAM file and writing to another, and you encounter an error when
writing the data. You may want to cancel reading data from the FTAM
file.
Call ft_cancel() after ft_read() or ft_write(), rather than calling
ft_etransfer().
• If you are reading a file, you will not lose data. If you are writing to a
file, you may or may not lose the data you wrote.
• Invoking ft_cancel() in the Data Transfer regime moves you back to
the File Open regime.
Ft_cancel_in_dcb
struct Ft_cancel_in_dcb {
enum Ft_action_result action_result;
struct Ft_diagnostic *diagnostic;
};
Ft_cancel_out_dcb
struct Ft_cancel_out_dcb {
Uint32 size;
struct Api_rc result;
enum Ft_action_result action_result;
struct Ft_diagnostic *diagnostic;
};