OSI/FTAM Programming Guide

Using FTM Procedure Calls
HP NonStop OSI/FTAM Programming Guide—528612-001
4-29
The File Open Procedure
3. The requested-access (ZFTM-DDL-REQUESTED-ACCESS) parameter
specifies the level of access to the file you are requesting. The
requested-access parameter can include any or all the file-action capabilities
specified in the permitted-actions field of the initial-attrib
(ZFTM-DDL-CREATE-ATTR) parameter of the create request, but no others.
The requested-access parameter is a string of Boolean fields, and each
Boolean field can take on the values ZAPS-VAL-TRUE or ZAPS-VAL-FALSE. The
fields and default values for requested-access include:
4. The access-passwords (ZFTM-DDL-ACCESS-PASSWDS) parameter
authenticates the actions that the requested-access parameter requests. To
use this parameter, you must have specified the security group in the
attrib-groups (ZFTM-DDL-ATTR-GROUPS) parameter of the
Value Name and Code
If File Does Not
Exist... If File Exists...
ZFTM-VAL-FOPEN-NEW (0) New file is created. Call fails.
ZFTM-VAL-FOPEN-UNKNOWN (1) File is created using the
file attributes specified
in the initial-
attrib parameter.
File is selected.
ZFTM-VAL-FOPEN-REPLACE (2) New file is created. File is deleted, and a
new file having the
same file attributes as
the old file is created.
ZFTM-VAL-FOPEN-RECREATE (3) New file is created. File is deleted, and a
new file is created
using the file attributes
specified in the
initial-attrib
parameter.
ZFTM-VAL-FOPEN-OLD (4) Call fails. File is selected (the
F-CREATE primitive is
not called).
Field Name Task Associated With Access Default Value
ZREAD Read the file. TRUE
ZINSERT Insert information into the file. FALSE
ZREPLACE Replace some or all the contents of the file. FALSE
ZEXTEND Extend the file. FALSE
ZERASE Erase some or all the contents of the file. FALSE
ZREADATTR Read the attributes of the file. TRUE
ZCHNGATTR Change the attributes of the file. FALSE
ZDELETE Delete the file. FALSE