OSI/FTAM Programming Reference Manual

FTM Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
4-83
FTM_FILE_OPEN_REQ_
FTM_FILE_OPEN_REQ_
This grouped procedure issues the primitives F-BEGIN-GROUP, F-SELECT or
F-CREATE, F-OPEN, and F-END-GROUP, allowing you to select or create a file and
then open it in a single procedure call. Successful completion of this procedure initiates
the file-selection and file-open regimes and leaves the association in the file-open
regime. For a description of these regimes, 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.
filename input
INT .EXT:ref:(ZAPS-DDL-CHAR128)
is the name of the file to be selected. The name should uniquely identify the file,
according to the requirements of the remote system. You can specify a maximum
of 128 characters for the file name.
filename is a required parameter.
file-status input
INT(32):value
indicates whether an existing file should be selected or a new file created, and if a
new file is created, what the file attributes should be. The meaning of all these
status := FTM_FILE_OPEN_REQ_ ( cepi ! I
, filename ! I
, [ requested-access ] ! I
, [ access-passwords ] ! I
, [ initial-attrib ] ! I
, [ create-password ] ! I
, [ process-mode ] ! I
, [ contents-type ] ! I
, [ account ] ! I
, [ tag ] ) ; ! I