FTAM/9000 Programmer's Guide

330 Chapter 8
Transferring HP FTAM/9000 Data
Ending Data Transfer
ft_rcancel()
#include %</opt/ftam/include/map.h>
#include %</opt/ftam/include/mapftam.h>
Return_code
ft_rcancel (connection_id, return_event_name, input_dcb,
inout_dcb)
Connection_id connection_id;
Local_event_name return_event_name;
struct Ft_rcancel_in_dcb *input_dcb;
struct Ft_rcancel_out_dcb **inout_dcb;
If an error occurs during a data transfer, the responder sends you a
cancel indication. To acknowledge you received this indication, call
ft_rcancel(). A cancel indication returns either as an
• inout_dcb->result.return_code of
FTE175_FCANCEL_IN_RECEIVED on ft_sdata() or
• as an inout_dcb->data_unit.structure_id of FT_CANCEL_IND on
ft_rdata().
If you do not send ft_rcancel(), you receive a protocol error which results
in an abort.
• Invoking ft_rcancel() in the Data Transfer regime moves you back to
the File Open regime.
Ft_rcancel_in_dcb
struct Ft_rcancel_in_dcb {
enum Ft_action_result action_result;
struct Ft_diagnostic *diagnostic;
};
Ft_rcancel_out_dcb
struct Ft_rcancel_out_dcb {
Uint32 size;
struct Api_rc result;
};