FTAM/9000 Programmer's Guide

Chapter 5 211
Using High Level, Context Free Functions
Copying and Moving FTAM Files (HLCF)
ft_fmove()
#include %</opt/ftam/include/map.h>
#include %</opt/ftam/include/mapftam.h>
Return_code
ft_fmove(source_dirname, source_filename, destination_dirname,
destination_filename, ae_label, return_event_name,
input_dcb, inout_dcb)
Ae_dir_name source_dirname;
Ft_filename source_filename;
Ae_dir_name destination_dirname;
Ft_filename destination_filename;
Ae_label *ae_label;
Local_event_name return_event_name;
struct Ft_fmove_in_dcb *input_dcb;
struct Ft_fmove_out_dcb **inout_dcb;
The ft_fmove() function moves a file from one filestore to another (i.e.,
moves source_filename in the source_dirname filestore to
destination_filename in the destination_dirname filestore). The new file
contains the source file attributes and those attributes that are
automatically set (e.g., filesize).
• If the file you are moving to already exists, the outcome depends on
how you set input_dcb->overwrite. If input_dcb->overwrite is set to
FT_RECREATE_FILE, FTAM copies the source file over the existing
destination file. If the value is FT_DONT_RECREATE_FILE, FTAM
does not copy the source file over the existing file, the function fails,
and you receive an error.
NOTE The following points do not apply to HP–UX FTAM responders. HP–UX
FTAM responders do not use these fields. The information is provided
here because other implementations may use these fields.
• If the file has access control elements, and an identity field matches
the source_init_id, the input_dcb->src_concur_cntl must be a subset
of the values in the conc_access field of the access control element.
• 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 in the conc_access field of the access control element.