OSI/FTAM Programming Guide

Using FTM Procedure Calls
HP NonStop OSI/FTAM Programming Guide—528612-001
4-14
Setting Procedure Parameters
3. The create-password (ZAPS-DDL-CHAR32) is an optional parameter that you
can use to verify that the user identified by the initiator-id parameter has
permission to create files in the current file system. If the create-password
parameter is not supplied, no password is sent to the remote responder.
4. The requested-access (ZFTM-DDL-REQUESTED-ACCESS) parameter
establishes the level of file access available in the select regime, following file
creation. To use this parameter, you must have specified the security group in the
attrib-groups parameter of the FTM_INITIALIZE_REQ_ call. The requested
access can encompass any of the file-action capabilities, although the
requested-access parameter must not exceed the file-action capabilities
specified in the permitted actions field of the initial-attrib parameter. If the
requested-access parameter is incompatible with the newly created file, the file
selection will fail, although the file was created.
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:
5. The access-passwords (ZFTM-DDL-ACCESS-PASSWDS) parameter
authenticates the actions requested in the requested-access parameter. To use
this parameter, the application must have negotiated the security group. The
access-passwords parameter verifies any delete actions only when the
override parameter specifies creating a new file or recreating a file with new
attributes. The initial-attrib parameter includes appropriate passwords for
other actions on the file after it has been selected. The file selection is rejected if
the passwords do not match the access passwords at the remote responder. If the
parameter is not supplied, no passwords are sent to the remote responder.
6. The account (ZAPS-DDL-CHAR32) parameter identifies the account to charge for
any costs incurred in the regime being established. If you do not provide this
parameter, the account name supplied to the remote responder on the
FTM_INITIALIZE_REQ_ procedure continues to bear responsibility for costs.
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