FTAM/9000 Programmer's Guide

294 Chapter 7
Managing and Accessing HP FTAM/9000 Files
Reading and Changing Attributes (LLCS)
Reading and Changing Attributes
(LLCS)
Use the ft_rattributes() and ft_cattributes() to read and change
attributes using low level calls.
If you are already in the File Selection regime, it is faster and easier to
use low level calls to read and change attributes than to use high level
calls (which re-connect and re-select). In other cases, the high level calls
may be easier to use.
ft_rattributes() (LLCS)
#include %</opt/ftam/include/map.h>
#include %</opt/ftam/include/mapftam.h>
Return_code
ft_rattributes (connection_id, return_event_name, input_dcb,
inout_dcb)
Connection_id connection_id;
Local_event_name return_event_name;
char *input_dcb;
struct Ft_rattributes_out_dcb **inout_dcb;
Use ft_rattributes() to read attributes.
• Invoke ft_rattributes() in the File Selection regime; you do not move
to another regime.
• During ft_connect(), you must negotiate the FT_FU_LTD_MGMT
functional_units to use ft_rattributes().
• During ft_select(), you must specify FT_FA_READ_ATTRIBUTE in
requested_access.
• Use input_dcb->attribute_names to specify which attributes you want
to read. The attributes you read return in inout_dcb->attributes.
• HP-UX responders return the indication no value available (0) for the
attributes legal_qualification, private_use, future_filesize, and
storage_account.