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.

Ft_rattributes_in_dcb

struct  Ft_rattributes_in_dcb {
      Ft_attribute_names    attribute_names;
};

Ft_rattributes_out_dcb

struct  Ft_rattributes_out_dcb {
      Uint32                        size;
      struct  Api_rc                result;
      enum  Ft_action_result        action_result;
      struct  Ft_attributes         attributes;
      struct  Ft_diagnostic         *diagnostic;
};

ft_rattributes() Parameters

ft_rattributes() Parameter	Type	Description
connection_id	Mandatory Input	Uniquely identifies a specific connection to the filestore
return_event_name	Mandatory Input	If the call is asynchronous, uniquely identifies the function call; if the call is synchronous, the value is zero
input_dcb-> attribute_names	Optional Input	Indicates the file attributes to read; default is all file attributes associated with the attribute groups negotiated on ft_connect()
inout_dcb->size	Mandatory input if using inout_dcb	Size (in Octets) of the inout_dcb structure and data
inout_dcb->result	Output	Pointer to the struct Api_rc containing the outcome of the operation
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_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.

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

* HP-UX responders accept, but ignore, these values.

Ft_cattributes_in_dcb

struct  Ft_cattributes_in_dcb {
      Ft_attribute_names            attribute_names;
      struct  Ft_attributes         attributes;
};

Ft_cattributes_out_dcb

struct  Ft_cattributes_out_dcb {
      Uint32                        size;
      struct  Api_rc                result;
      enum    Ft_action_result      action_result;
      struct  Ft_attributes         attributes;
      struct  Ft_diagnostic         *diagnostic;
};

ft_cattributes() Parameters

ft_cattributes() Parameter	Type	Description
connection_id	Mandatory Input	Uniquely identifies a specific connection to the filestore
return_event_name	Mandatory Input	If the call is asynchronous, uniquely identifies the function call; if the call is synchronous, the value is 0 (zero)
input_dcb-> attribute_names	Mandatory Input	Mask that indicates which file attributes to change
input_dcb->attributes	Mandatory Input	Specifies the values of the attributes to change; attributes.values contains new values for each attribute specified in attribute_names
inout_dcb->size	Mandatory input if using inout_dcb	Size (in Octets) of the inout_dcb structure and data
inout_dcb->result	Output	Pointer to the struct Api_rc containing the outcome of the operation: result_code and vendor_code (HP-UX—specific error)
inout_dcb-> action_result	Output	Specifies the overall success or failure of the request
inout_dcb->attributes	Output	Contains values of the attributes you changed (those attributes accepted by the responder)
inout_dcb->diagnostic	Output	Provides ISO-specific error information

Reading and Changing Attributes (LLCS)

Technical documentation

» Table of Contents

» Glossary

» Index