Copyright Digital Equipment Corp. All rights reserved.

Examples

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

      This command appends 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:

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

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

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


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

      This command appends 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.  $ APPEND/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.  $ APPEND/APPLICATION_PROTOCOL=FTAM AMIGUITA::"/DIR/FILE" <RET>
       _To: AMIGUITA::"/NEWMAIN/FILE" <RET>

      This command appends 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.

   6.  $ APPEND/APPLICATION_PROTOCOL=FTAM -
       _$ FREUNDE::"^VOL>MAIN>FILE.EXT", TEST.DAT <RET>
       _To: 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\

   7.  $ APPEND/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\