FTAM/9000 Programmer's Guide

296 Chapter 7
Managing and Accessing HP FTAM/9000 Files
Reading and Changing Attributes (LLCS)
ft_cattributes() (LLCS)
#include %</opt/ftam/include/map.h>
#include %</opt/ftam/include/mapftam.h>
Return_code
ft_cattributes (connection_id, return_event_name, input_dcb,
inout_dcb)
Connection_id connection_id;
Local_event_name return_event_name;
struct Ft_cattributes_in_dcb *input_dcb;
struct Ft_cattributes_out_dcb **inout_dcb;
Use ft_cattributes() to change file attributes. For example, you can
change an attribute such as access_control to allow a specific user to
access a file.
• Invoke ft_cattributes() in the File Selection regime; you do not move
to another regime.
• During ft_connect(), you must negotiate the FT_FU_ENH_MGMT
functional_units to use ft_cattributes().
• During ft_select(), you must specify FT_FA_CHANGE_ATTRIBUTE
in requested_access.
• The attributes_ groups negotiated on the ft_connect() request dictates
the attributes you can change.
• The input_dcb->attribute_names parameters takes precedence over
the input_dcb->attributes.mask field.
inout_dcb->
action_result
Output Specifies the overall success or failure of the
request
inout_dcb-
>attributes
Output Contains values of the attributes of the file you
read (those attributes accepted by the responder)
inout_dcb-
>diagnostic
Output Holds ISO-specific error information
ft_rattributes()
Parameter
Type Description