FTAM/9000 Programmer's Guide

Chapter 5 217
Using High Level, Context Free Functions
Copying and Moving FTAM Files (HLCF)
• If the file has access control elements, and an identity field matches
the dest_init_id, the input_dcb->dest_concur_cntl must be a subset of
the values stored in the conc_access field of struct
Ft_access_control_element.
• You must supply matching passwords in input_dcb-
>source_file_passwords for FT_FA_READ and
FT_FA_READ_ATTRIBUTE file actions if the following conditions
exist.
• If the file you are copying from contains an identity (in
Ft_access_control_element) that matches the source_init_id AND
• If passwords exist for these file actions
• You must supply matching passwords in input_dcb-
>dest_file_passwords if the file you copying to exists and contains an
identity (in Ft_access_control_element) that matches the dest_init_id
and if passwords exist for these file actions.
• If the file is an FTAM-1, FTAM-3, or INTAP-1 document type, you
must supply matching passwords for FT_FA_DELETE_FILE and
FT_FA_REPLACE.
• If the file is an FTAM–2 document type, you must supply
matching passwords for FT_FA_DELETE_FILE and
FT_FA_INSERT.
Ft_fcopy_in_dcb
struct Ft_fcopy_in_dcb {
Ft_initiator_identity source_init_id;
Ft_single_file_pw source_filestore_pw;
Ft_account source_account;
struct Ft_file_passwords source_file_passwords;
Ft_initiator_identity dest_init_id;
Ft_single_file_pw dest_filestore_pw;
Ft_account dest_account;
struct Ft_file_passwords dest_file_passwords;
Ft_single_file_pw create_file_pw;
enum Ft_delete_overwrite overwrite;
struct Ft_concurrency_control *src_concur_cntl;
struct Ft_concurrency_control *dest_concur_cntl;
};