FTAM/9000 Programmer's Guide

322 Chapter 8
Transferring HP FTAM/9000 Data
Writing Data
Use ft_sdata() to send data units to a file. You can send a maximum of 14
data units linked together for each ft_sdata() function call.
• Invoke ft_sdata() in the Data Transfer regime; you do not move to
another regime.
• During ft_connect(), you must negotiate the FT_FU_WRITE
functional_units to use ft_sdata().
• During ft_create() and ft_select(), you must set requested_access
according to the document type.
• If you call ft_sdata() asynchronously and then receive the
FTE008_NO_CON_RESOURCES error, either call ft_nwcleared() to
determine when the resources are free or re-issue ft_sdata().
• The total amount of data sent per ft_sdata() call is limited to about 7K
octets. The function will return FTE101_BUFF_TOO_BIG if this
threshold is exceeded.
Ft_sdata_out_dcb
struct Ft_sdata_out_dcb {
Uint32 size;
struct Api_rc result;
enum Ft_action_result action_result;
struct Ft_diagnostic *diagnostic;
};
FTAM-1, FTAM-3, and
INTAP-1
FTAM-2
FT_FA_EXTEND
FT_FA_REPLACE
FT_FA_INSERT