FTAM/9000 Programmer's Guide

226 Chapter 5
Using High Level, Context Free Functions
Reading and Changing Attributes (HLCF)
Reading and Changing Attributes
(HLCF)
Use ft_frattributes() and ft_frattributes_aet to read file attributes, and
ft_fcattributes() and ft_fcattributes_aet() to change file attributes by
making only one call.
ft_frattributes()
#include %</opt/ftam/include/map.h>
#include %</opt/ftam/include/mapftam.h>
Return_code
ft_frattributes (dirname, filename, ae_label,
return_event_name, input_dcb, inout_dcb)
Ae_dir_name dirname;
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() to read file attributes. Examples of using
ft_frattributes() are as follows.
You might want to use ft_frattributes() to determine the creation dates
when a deleting files older than a specific date. Another example of using
ft_frattributes() is to know how to set destination file attributes when
copying files with low level calls.
• 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.