FTAM/9000 Programmer's Guide

234 Chapter 5
Using High Level, Context Free Functions
Reading and Changing Attributes (HLCF)
ft_frattributes_aet()
#include %</opt/ftam/include/map.h>
#include %</opt/ftam/include/mapftam.h>
Return_code
ft_frattributes_aet (ascii_ddn, filename, ae_label,
return_event_name, input_dcb, inout_dcb)
char *ascii_ddn;
Ft_filename filename;
Ae_label *ae_label;
Local_event_name return_event_name;
struct Ft_frattributes_in_dcb *input_dcb;
struct Ft_frattributes_out_dcb **inout_dcb;
Use ft_frattributes_aet() to read file attributes. Examples of using
ft_frattributes_aet() are as follows.
You might want to use ft_frattributes_aet() to determine the creation
dates when a deleting files older than a specific date. Another example of
using ft_frattributes_aet() is to know how to set destination file
attributes when copying files with low level calls.
• Both ft_frattributes_aet() and ft_frattributes() are used for reading
file attributes. However, ft_frattributes_aet() sends both the Called
AE Title and calling AE title to the remote system while
ft_frattributes() sends only the calling AE title. Also, in
ft_frattributes_aet(), the DDN is passed directly as an ASCII string
without any conversion while in ft_frattributes(), the DDN has to be
converted and passed as an Ae_dir_name.
• If the responder supports the conc_access field of struct
Ft_access_control_element, and the file has access control elements,
and an identity field matches the init_id, the input_dcb-
>concurrency_control must be a subset of the values stored in the
conc_access. HP-UX responders do not support the conc_access field
of struct Ft_access_control_element.
• The input_dcb->attribute_names field defaults to indicate all
attributes in the attribute_groups negotiated.
• You must supply matching passwords in input_dcb->file_passwords
for FT_FA_READ and FT_FA_READ_ATTRIBUTE file actions if the
following conditions exist.
• If the file contains an identity (in Ft_access_control_element) that
matches the init_id AND
• If passwords exist for these file actions