Tingo: created page for the COPY-USERS-FILES command

2012-12-17T19:17:54Z

created page for the COPY-USERS-FILES command

New page

@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.
== Related commands ==
@[[COPY]]

@[[COPY-FILE]]

@[[CREATE-VOLUME]]

== References ==
{{ND-doc|60.128.01}} (printed June 1980), pages 1-41, 1-42

{{ND-doc|60.174.Q01}}
[[Category:Background Commands]]

COPY-USERS-FILES - Revision history

Tingo: created page for the COPY-USERS-FILES command