/sys$common/syshlp/helplib.hlb DECnet-Plus, DCL Commands, APPEND, Examples  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    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\