Examples

   1.  $ COPY/APPLICATION_PROT=FTAM TEST.DAT AMIGUITA::"\DIR\FILE" <RET>

      This command copies the single local file TEST.DAT to \DIR\FILE
      on AMIGUITA.

      Note that without the double quotation marks (" ") surrounding
      \DIR\FILE, RMS would generate the following error:

         %COPY-F-OPENIN, error opening AMIGUITA::\DIR\FILE as input
         -RMS-F-SYN, file specification syntax error

   2.  $ COPY/APPLICATION_PROTOCOL=FTAM TEST.DAT AMIGUITA::* <RET>

      This command copies the single local file TEST.DAT to TEST.DAT
      on AMIGUITA.

   3.  $ COPY/APPLICATION_PROTO=FTAM TEST.DAT LESAMIES::"test.dat" <RET>

      This command copies the single local file TEST.DAT to test.dat
      on LESAMIES. Since the output-file designation is enclosed in
      double quotation-marks ("-"), the lower case characters entered
      in the command are retained in the output-file designation sent
      to the remote FTAM system.


   4.  $ COPY/APPLICATION_PROTOCOL=FTAM *.DAT FREUNDE::NEWFILE <RET>

      This command concatenates alphabetically the .DAT files in the
      local default directory. Concatenation ceases if any file dif-
      fers in file organization, record format, or record attributes
      from those of the first .DAT file listed in the directory.
      Note that the specified output-file designation, NEWFILE, lacks
      locational information. Therefore, the responding FTAM applica-
      tion places the file NEWFILE in whatever location serves as its
      default location for files created by an FTAM process.

   5.  $ COPY/APPLICATION_PROTOCOL=FTAM MITRA::FILE.DAT [MAIN.SUB] <RET>

      This command copies the remote file FILE.DAT to the local
      RMS directory [MAIN.SUB]. The resulting file specification
      is [MAIN.SUB]FILE.DAT.


   6.  $ COPY/APPLICATION_PROTOCOL=FTAM AMIGUITA::"/DIR/FILE" <RET>
       _To: AMIGUITA::"/NEWMAIN/FILE" <RET>

      This command copies the file /DIR/FILE on AMIGUITA to
      /NEWMAIN/FILE on the same system. Two remote systems could
      just as easily be involved. Note that the file passes through
      the local FTAM system but is not opened or stored locally.

   7.  $ COPY/APPLICATION=FTAM FREUNDE::"^VOL>MAIN>FILE.EXT",TEST.DAT -
       _$ LARGETEST.DAT <RET>

      This command concatenates the remote input file, 
      ^VOL>MAIN>FILE.EXT, and the local input file, TEST.DAT, 
      (assuming that they have a common file organization and data 
      type) into the local output file, LARGETEST.DAT.

      Note that without the double quotation marks (" ") surround-
      ing ^VOL>DIR>FILE.EXT, DCL would interpret ^ as a parameter
      delimiter and generate the following error:

         %DCL-W-PARMDEL, invalid parameter delimiter ...
         \^VOL\

   8.  $ COPY/APPLICATION_PROTOCOL=FTAM TEST.DAT -
       _$ AMIGUITA::"/MAIN/SUB/TEST/DAT"/ALLOCATION=90  <RET>

      This command sets the future file size of /MAIN/SUB/TEST/DAT to
      90 blocks.

      Note that without the double quotation marks (" ") surrounding
      /MAIN/SUB/FILE, DCL would interpret /MAIN as a qualifier and
      generate the following error:

         %DCL-W-IVQUAL, unrecognized qualifier ...
         \MAIN\


   9.  $ COPY/APPLICATION_PROTOCOL=FTAM /CONFIRM  PUNGYO::FILE.DAT <RET>
       _To: FILE.DAT <RET>
       Copy PUNGYO::FILE.DAT? [N] Y<RET>

      After the command is confirmed, it copies the file FILE.DAT
      from the system PUNGYO to the local system.

   10. $ COPY/APPLICATION_PROTO=FTAM /EXCLUDE=(*.DIR,*.LOG) [...] <RET>
       _To: PUNGYO::"MAIN/SUB/FILE.EXT" <RET>

      This command concatenates all files in the local default di-
      rectory except those having the extensions .DIR or .LOG. The
      output file is a remote file MAIN/SUB/FILE.EXT on the remote
      FTAM system PUNGYO.

   11. $ COPY/APPLICATION_PROTOCOL=FTAM /REPLACE <RET>
       _From: AMIGUITA::"/MAIN/SUB/FILE/EXT" <RET>
       _To: FILE.DAT;5 <RET>

      This command causes the contents of a remote file,
      /MAIN/SUB/FILE/EXT from the remote FTAM system AMIGUITA, to
      replace the contents of a local file, FILE.DAT;5. The local
      file retains the original file name, FILE.DAT;5.