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

    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.