OSI/FTAM Programming Reference Manual

FTM Procedures

HP NonStop OSI/FTAM Programming Reference Manual—528611-001

4-36

FTM_CREATE_REQ_

This procedure allows you to request creation and selection of a file in the file storage

system with which an association has been established. Successful completion of this

procedure initiates the file-selection regime. For a description of the file-selection

regime, see the OSI/FTAM Programming Guide.

status return value

INT

indicates the outcome of the call. For a list of possible ZAPS-VAL-STATUS-xxx

values, see Table B-1 on page B-2.

cepi input

INT:value

is the connection endpoint identifier (CEPI) used to identify the specific

association. Use the CEPI value returned from the FTM_INITIALIZE_REQ_

procedure for this association. For additional information on using the cepi

parameter, see the OSI/FTAM Programming Guide.

cepi is a required parameter.

initial-attrib input

INT .EXT:ref:(ZFTM-DDL-CREATE-ATTR)

defines the file attributes associated with the created file. For an attribute to be

defined at file creation, you must have negotiated the appropriate attribute group

on the FTM_INITIALIZE_REQ_ call.

initial-attrib is a required parameter. You must specify at least the filename

attribute and the document type component of the contents-type attribute in this

parameter.

override input

INT(32):value

specifies the action to be taken if the named file already exists. Valid values are

defined below. The default override value is ZFTM-VAL-OVR-CREATE-FAIL.

status := FTM_CREATE_REQ_ ( cepi ! I

, initial-attrib ! I

, [ override ] ! I

, [ create-password ] ! I

, [ requested-access ] ! I

, [ access-passwords ] ! I

, [ account ] ! I

, [ tag ] ); ! I