FTAM/9000 Programmer's Guide

276 Chapter 7
Managing and Accessing HP FTAM/9000 Files
Gaining Access to FTAM Files
ft_create() Parameters
ft_create()
Parameter
Type Description
connection_id Mandatory
Input
Uniquely identifies a specific connection to the
filestore
filename Mandatory
Input
Path name of the file you are creating; must be in
the syntax of the real filestore
contents_type Mandatory
Input
Specifies the document type of the newly created
file
requested_access Mandatory
Input
Specifies the actions you want available for the
connection (during the File Selection regime and
those regimes nested within it)
file_status Mandatory
Input
Determines the action to take if the file already
exists
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-
>attributes
Optional Input Uniquely identifies the file you are creating; do
not use input_dcb->attributes.filename and
input_dcb->attributes.contents_type
input_dcb->
concurrency_control
Optional Input File access locks required on the actions specified
in requested_access
input_dcb->
create_file_pw
Optional Input Establishes permission to create files in the
current filestore; HP-UX responders ignore this
value
input_dcb->
file_passwords
Optional Input Passwords associated with the actions specified by
requested_access
input_dcb->account Optional Input HP-UX responders accept, but ignore, this value
inout_dcb->size Mandatory
input if using
inout_dcb
Size (in Octets) of the inout_dcb structure and
data