FTAM/9000 Programmer's Guide

236 Chapter 5
Using High Level, Context Free Functions
Reading and Changing Attributes (HLCF)
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
input_dcb->
concurrency_control
Optional input
(Used only with
non—HP–UX
responders.)
Sets the concurrency control for filename;
compared to conc_access in struct
Ft_access_control_element if an identity field
matches the init_id
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 (MAP 3.0
error) and vendor_code (HP–UX—specific error)
inout_dcb->
action_result
Output Specifies the overall success or failure of the
request
ft_frattributes_ae
t() Parameter
Type Description