File-specification

   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.