The FTAM DCL commands accept any of the following file specifica-
tion formats:
rms-file-designation
appl-address::rms-file-designation
appl-address::"non-rms-file-designation"
appl-address"initiator-id password account"::rms-file-designation
appl-address"initiator-id password account"::"non-rms-file-
designation"
The following table describes the variables in these format state-
ments:
__________________________________________________________________
Variable Explanation
__________________________________________________________________
appl-address An FTAM application address that corresponds to the
FTAM responder of an FTAM system. An FTAM responder
handles incoming requests for files from FTAM users.
initiator-id A character string that identifies an initiator
ID on the specified FTAM node. If you specify this
string in a local file specification, FTAM uses
the initiator ID as the user name of an OpenVMS
account.
password A string that identifies an FTAM filestore password.
If you specifiy this string in a local file specifi-
cation, FTAM uses the filestore password as the
login password for the OpenVMS account identified by
the initiator ID.
account A string that identifies an FTAM account name. If
you specify this string in a local file specifi-
cation, FTAM uses it as an OpenVMS account name. To
specify an account, you must also specify both a
user name and a password.
rms-file- A standard Record Management Services (RMS) file
designation specification, which contains one or more components
in the following format:
(device-name:[directory-name]file-name.file-
extension;version-number).
Except for the file name or file name delimiter
(.), all the components are optional.
For local files, the FTAM copying facility per-
mits standard DCL wildcards. See the "Wildcards"
subtopic for more information about DCL wildcards.
non-rms- A file designation whose format RMS cannot inter-
file- pret. A non-rms file designation contains whatever
designation information the remote FTAM system requires for
locating a remote file. Enclosing non-RMS file des-
ignations between double quotation marks ("non-rms-
file-designation") causes RMS to accept the enclosed
designation without trying to parse it. Failing
to enclose non-rms file designations within double
quotation marks causes an error.
Note that FTAM cannot handle a remote file des-
ignation that contains one or more double quotation
marks among its characters.
__________________________________________________________________
File designations equate to FTAM file names. An FTAM file name
is a text string that identifies a file to an FTAM system. The
FTAM system requesting a file (the initiator) supplies an FTAM
file name to the FTAM system accepting the file request (the
responder).
FTAM treats FTAM file names as follows:
o When you request a remote file, the FTAM initiator separates
the FTAM application address from the file designation. The
application address translates into the address of an FTAM
application on a particular FTAM system. The file designation,
which includes everything to the right of the double colons
(::) excluding double quotation marks that enclose an FTAM
file designation, serves unchanged as an FTAM file name.
o When processing an incoming file request, the FTAM responder
treats whatever string it receives for the FTAM file name
as an RMS file designation.