COPY-USERS-FILES

@COPY-USERS-FILES <destination type = DIRECTORY>, <destination directory>, <source type = DIRECTORY>, <source files>
@COPY-USERS-FILES <destination type = VOLUME>, <destination device name>, [<destination unit>], <destination volume name>, <destination file generation>,
                  <source type = VOLUME>, <source device name>, [<source unit>], <source volume name>, <source file generation>, <source files>

Copy a set of mass storage files. The set can reside on either an ANSI standard magnetic tape volume or a directory.

<destination type>: DIRECTORY or VOLUME (default = DIRECTORY)
<destination directory>: specified if <destination type> = DIRECTORY
<destination device name>: choose MAG-TAPE-1 or MAG-TAPE-2, specified if <destination type> = VOLUME
<destination unit>: specified only if system has multiple units and <destination type> = VOLUME
<destination volume name>: name of the destination tape reel label. Specified only if <destination type> = VOLUME
<destination file generation>: four character identification of this backup generation, specified only if <destination type> = VOLUME
<source type>: DIRECTORY or VOLUME (default = DIRECTORY)
<source files>: copy all files matching this name. Can be abbreviated. Applies to any <source type> (if VOLUME, default is all files, if DIRECTORY default is all files for terminal user in default directory)
<source device name>: choose MAG-TAPE-1 or MAG-TAPE-2, specified if <destination type> = VOLUME
<source unit>: specified only if system has multiple units and <destination type> = VOLUME
<source volume name>: name of the destination tape reel label. Specified only if <destination type> = VOLUME
<source file generation>: four character identification of this backup generation, specified only if <destination type> = VOLUME

Rules:

permitted for all users.
If a volume is owned (created) by user SYSTEM, it may contain files for several users. But only files for one user may be copied in one @COPY-USERS-FILES command. If a volume is owned by any other user, it may only contain files for that user.
When files are copied to a volume they are appended at the end of the volume.
When files are copied to a directory, the user must be created and have space in the destination directory. If a file does not exist in the destination directory, it will be created, however, contiguous files must be created first.
<source file generation> or <destination file generation> are an extension to the file name when used as a file reference.
Files are copied including their "holes".
Note that if there is only one unit on the device, the <destination unit> or <source unit> MUST NOT be specified.

Examples:

@COPY-USERS-FILES DIR, P-3, DIR, A:SYMB

Copy all symbolic files matching A:SYMB to the directory P-3.

@CREATE-VOLUME VOL1 MAG-TAPE-1

@COPY-USERS-FILES VOL, MAG-TAPE-1, VOL1, 0312, DIR, :SYMB

Make a backup of all symbolic files of the currently logged on user on a magnetic tape volume.

Assuming user SYSTEM is logged on:

@CREATE-VOLUME VOLSY, MAG-TAPE-1

@COPY-USERS-FILES VOL, M-T-1, VOLS, 0312, DIR (OLE):SYMB

@COPY-USERS-FILES VOL, M-T-1, VOLS, 0312, DIR (PER):SYMB

this command sequence will make a backup of the symbolic files of users OLE and PER on a magnetic tape volume.

@COPY-USERS-FILES DIR, P-3, VOL, M-T-1, VOL1, A:SYMB, 0312

This command will replace all symbolic files starting with A in directory P-3 for the current user with the corresponding files in the magnetic tape volume VOL1, from backup generation 0312.