Ft_attributes

struct  Ft_attributes {
        Ft_attribute_names          mask;
        struct Ft_attribute_values  values;
};

Ft_attributes Is Input To These Functions

Ft_attributes Is Output From These Functions

ft_cattributes()

ft_create()

ft_fcattributes()

ft_fopen()

ft_select()

ft_cattributes()

ft_create()

ft_fcattributes()

ft_fcopy()

ft_fmove()

ft_fopen()

ft_frattributes()

ft_rattributes()

ft_select()

Every file contains attributes that uniquely identify the file and are inherent in its existence (e.g., filename). Ft_attributes is the primary structure for setting these attributes. You can change only certain file attributes after creating the file, so be careful to set these attributes as you want them during ft_fopen() and ft_create().

Attributes You Can Change

Attributes You Cannot Change

filename

storage_account*

file_availability*

future_filesize*

access_control

legal_qualification*

private_use*

permitted_actions

contents_type

date_time_of_creation

date_time_of_modification

date_time_of_read

date_time_of_attribute_mod

identity_of_creator

identity_of_modifier

identity_of_reader

identity_of_attribute_mod

filesize

* With HP-UX FTAM responders, changing these values has no effect.

Ft_attributes may exist in the input_dcb and inout_dcb.

mask	The mask identifies which attributes are available for each file.
values	The values identifies the attribute values of the attributes specified in the mask.

Ft_attribute_names

typedef Uint32 Ft_attribute_names;

Ft_attribute_names Is Input To These Functions

Ft_attribute_names Is Output From These Functions

ft_cattributes()

ft_create()

ft_fcattributes()

ft_fopen()

ft_frattributes()

ft_rattributes()

ft_cattributes()

ft_create()

ft_fcattributes()

ft_fopen()

ft_frattributes()

ft_rattributes()

Ft_attribute_names is the type for the mask field in Ft_attributes.

Use Ft_attribute_names to identify which attributes you want available for each file. Use only those values in the FT_AN_XXX defined constants. Refer to the previous "Ft_attribute_names" section for more information.




	NOTE: When using Ft_cattributes or Ft_fcattributes, the attribute_names field has precedence over attributes.mask.

Ft_attribute_values

struct  Ft_attribute_values {
        Ft_filename                     filename;
        Ft_permitted_actions            permitted_actions;
        struct  Ft_contents_type        contents_type;
        Ft_account                      storage_account;
        Time                            date_time_of_creation;
        Time                            date_time_of_modification;
        Time                            date_time_of_read;
        Time                            date_time_of_attribute_mod;
        Ft_initiator_identity           identity_of_creator;
        Ft_initiator_identity           identity_of_modifier;
        Ft_initiator_identity           identity_of_reader;
        Ft_initiator_identity           identity_of_attribute_mod;
        enum    Ft_file_availability    file_availability;
        Sint32                          filesize;
        Sint32                          future_filesize;
        struct  Ft_access_control       access_control;
        Ft_legal_qualification          legal_qualification;
        struct  Octet_string            private_use;
};

Use Ft_attribute_values to specify the attribute values you want each attribute to have.

filename	Character string that identifies the name of the file.
permitted_actions	Specifies all allowable actions on the file (without specifying who is allowed to perform the actions). The permitted_actions is type Ft_permitted_actions. For each file, set bits in permitted_actions for the actions you are allowing to be performed. Use these defined constants: FT_PA_READ FT_PA_INSERT FT_PA_REPLACE FT_PA_EXTEND FT_PA_ERASE FT_PA_READ_ATTRIBUTE FT_PA_CHANGE_ATTRIBUTE FT_PA_DELETE_FILE FT_PA_TRAVERSAL FT_PA_REV_TRAVERSAL FT_PA_RANDOM_ORDER Each document type defines certain permitted_actions values, as follows: FTAM-1, -2, -3, INTAP-1 FTAM-1, FTAM-3 FTAM-2 and NBS-9 and INTAP-1 CHANGE_ATTRIBUTE ERASE ERASE DELETE_FILE EXTEND INSERT READ REPLACE TRAVERSAL READ_ATTRIBUTE
contents_type	Specifies the document type of the file; the contents_type is of type struct Ft_contents_type. Refer to the "Ft_contents_type" section for a detailed explanation.
storage_account	Identifies the accountable authority responsible for accumulated file storage charges. HP-UX FTAM responders set storage_account so that the indication no value available (0) returns if you invoke ft_rattributes() or ft_frattributes().
	If you invoke functions that contain storage_account in the input_dcb, HP-UX responders accept, but ignore, the value.

date_time_of_creation

date_time_of_modification

date_time_of_read

date_time_of_attribute_mod*

Specifies, respectively, the following dates.

Date file was created

Date file was last modified

Date file was last read

Date file attributes were last modified

These values are of type Time.

identity_of_creator

identity_of_modifier*

identity_of_reader*

identity_of_attribute_mod*

Specifies, respectively, the following user identities:

User who created the file

User who last modified the file

user who last read the file

User who last modified the file attributes

* Returns no value available

file_availability

The file_availability is of the following type:

enum    Ft_file_availability {
                                FT_IMMEDIATE_AVAIL, 
                                FT_DEFERRED_AVAIL
};

For HP-UX responders, you can access the file immediately regardless of which value you select. For some implementations, file_availability indicates whether a delay occurs before you can access the file.

filesize

Specifies the maximum size (in Octets) of the file.

future_filesize

Specifies the maximum size (in Octets) to which the file may grow if you modify or extend it. HP-UX responders return a value of zero (no value) on calls to ft_rattributes() or ft_frattributes().

access_control

Defines the conditions under which you and other users can access the file. The access_control is of type struct Ft_access_control and specifies who can access the file, their access privileges, types of file locks, and user passwords. Refer to the "Ft_access_control" section for a detailed explanation.

legal_qualifications

Conveys information about the legal status of the file and its use. HP-UX responders return a value of zero (no value) on calls to ft_rattributes() or ft_frattributes().

private_use

HP-UX responders return a value of zero (no value) on calls to ft_rattributes() or ft_frattributes().

Ft_attributes

Technical documentation

» Table of Contents

» Glossary

» Index

Ft_attribute_names

Ft_attribute_values