FTAM/9000 Programmer's Guide

228 Chapter 5
Using High Level, Context Free Functions
Reading and Changing Attributes (HLCF)
ft_frattributes() Parameters
ft_frattributes()
Parameter
Type Description
dirname Optional Input Directory distinguished name of the filestore;
NULL implies the local filestore
filename Mandatory
Input
Path name of the file that has the attributes you
are reading; must be in the syntax of the real
filestore
ae_label Mandatory
Input
Unique identifier for ftam_init you want to service
the request; if pointing to a NULL location, the
interface uses a currently activated ftam_init or
activates and deactivates a ftam_init
Output Unique identifier for ftam_init that serviced the
request
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->init_id Optional Input Login account
input_dcb->
filestore_pw
Optional Input Login password for init_id
input_dcb->
file_passwords
Optional Input Structure containing the passwords for
FT_FA_READ and FT_FA_READ_ATTRIBUTE.
Set file_passwords only if the file has an identity
(in Ft_access_control_element) that matches
init_id and if passwords exist for these two actions
input_dcb->
attribute_names
Optional Input Mask that indicates which file attributes to read
input_dcb->account Optional Input Identifies who is responsible for accumulated file
storage charges; HP–UX responders accept, but
ignore, this value