COPY-USERS-FILES

@COPY-USERS-FILES ,, , @COPY-USERS-FILES ,, [ ], , , ,, [ ], , ,

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


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

Rules: Examples:
 * 1) permitted for all users.
 * 2) 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.
 * 3) When files are copied to a volume they are appended at the end of the volume.
 * 4) 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.
 * 5) or are an extension to the file name when used as a file reference.
 * 6) Files are copied including their "holes".
 * 7) Note that if there is only one unit on the device, the or MUST NOT be specified.

@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.

Related commands
@COPY

@COPY-FILE

@CREATE-VOLUME