FTAM/9000 Programmer's Guide

230 Chapter 5
Using High Level, Context Free Functions
Reading and Changing Attributes (HLCF)
ft_fcattributes()
#include %</opt/ftam/include/map.h>
#include %</opt/ftam/include/mapftam.h>
Return_code
ft_fcattributes (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_fcattributes_in_dcb *input_dcb;
struct Ft_fcattributes_out_dcb **inout_dcb;
Use ft_fcattributes() to change file attributes. For example, you can
change an attribute such as access_control to place file access
restrictions on a specific user.
• The attribute_groups negotiated dictate the attributes you can
change.
* HP–UX responders accept, but ignore, these values.
• 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.
Attributes You Can Change
Attributes You Cannot
Change
access_control
file_availability
filename
future_filesize*
legal_qualification*
private_use*
storage_account*
contents_type
date_time_of_attribute_mod
date_time_of_creation
date_time_of_modification
date_time_of_read filesize
identity_of_attribute_mod
identity_of_creator
identity_of_modifier
identity_of_reader
permitted_actions