OSI/FTAM Programming Reference Manual

FTM Procedures
HP NonStop OSI/FTAM Programming Reference Manual—528611-001
4-38
FTM_CREATE_REQ_
requested-access is an optional parameter.
access-passwords input
INT .EXT:ref:(ZFTM-DDL-ACCESS-PASSWDS) authenticates the actions
requested in the requested-access parameter. To use this parameter, you must
have selected the security group on the FTM_INITIALIZE_REQ_ call. The remote
responder will reject the subsequent file selection if the access passwords for the
requested actions do not match the responder’s access passwords.
access-passwords is an optional parameter. If you do not supply
access-passwords, no passwords are sent to the remote responder.
account input
INT .EXT:ref:(ZAPS-DDL-CHAR32) identifies the account to be charged for costs
that are incurred during the file-selection regime.
account is an optional parameter. If you omit account, no account name will be
supplied to the remote responder.
Some responders require an account name. For information on responder
requirements for the account name, refer to the responder documentation.
tag input
INT(32):value
is for use in nowait mode only. Specify a unique value to identify this instance of
the procedure call. When the operation is complete, the MFM_AWAITIOX_
procedure returns the tag value, allowing your application to match the completion
with the correct instance of the procedure call. For details on the use of the tag
parameter, see the OSI/FTAM Programming Guide.
tag is an optional parameter.
Considerations
•
To complete this procedure call successfully, the association must be in the FTAM
regime.
•
Before calling FTM_CREATE_REQ_, you must have negotiated the
limited-file-management functional unit. A parameter value of ZFTM-VAL-
CNTNTSTYPE-UNKNOWN is allowed for the contents type specified in intial-
attrib. Maximum-string-length must be in the range of 1 through 7148.
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