The BRU command syntax is: BRU>/qualifiers indevice:[filespec] outdevice:[filespec] or you may be prompted for the devices: BRU>/qualifiers FROM: indevice:[filespec] TO: outdevice:[filespec] BRU uses DCL syntax, hence a space is used to seperate and distinguish 'indevice:[filespec]' and ' outdevice:[filespec]'. The BRU command invokes the BRU system utility program to provide functions that allow you to back-up and restore Files-11 volumes. It transfers files from a volume to a back-up volume (or volumes) to ensure that copies of the files are available in case the original files are destroyed. If the original files are destroyed, or if for any other reason the copies need to be retrieved, you can restore the backed-up files with this command. Both source and target fields specify disk or tape units. At least one of these must be a disk. The source field may optionally include from 1 to 16 file specifications which are used to select which files are to be transfered. See HELP BRU QUALIFIERS for a list of available qualifiers. See HELP BRU for information on a particular qualifier. See HELP BRU EXAMPLES for some command examples. 2 APPEND BRU>/APPEND source targetdevice The /APPEND qualifier causes a backup set from the input volume to be appended to the last backup set on the output tape. /APPEND causes a skip to the logical end of tape before writing the new backup set, if the tape was positioned at the beginning. The output volume is searched for the last logical end-of-file. If the tape is a continuation tape, i.e. not the first tape of a tape set, an error message is displayed. If the tape is not positioned at the beginning, /APPEND will cause BRU to start writing where the tape is currently positioned. /APPEND/REWIND will cause BRU to rewind the tape and then space forward until the end of the volume. 2 BACKUP_SET BRU>/BACKUP_SET:name source targetdevice The /BACKUP_SET qualifier allows you to specify the name of the backup set to be placed on the tape. The default is the volume name of the disk being backed up. This name may be up to 12 characters long. When applied to an output tape volume, the backup set name assigns the name of the backup set being placed on the volume. Multiple backup sets may be placed on a single volume. If you specify no backup set name for the output volume, the volume name of the input disk is used to name the backup set. When applied to an input tape volume, the first tape is searched for the specified backup set name. If you specify no backup set name with the input volume, the first backup set on the tape is restored. The first tape in the backup set is not rewound unless you specify /REWIND. 2 BAD BRU>/INITIALIZE/BAD:[AUTOMATIC] source targetdevice [MANUAL ] [OVERRIDE ] The /BAD qualifier is used with the /INITIALIZE qualifier during tape to disk or disk to disk operations. For last-track devices, AUTOMATIC causes the manufacturer's bad block information and the software detected bad sector file to be used to create BADBLK.SYS. For nonlast-track devices, the software bad block descriptor block is used to create BADBLK.SYS. OVERRIDE applies only to last-track devices, causing the last-track device to appear to be a nonlast-track device. When OVERRIDE is speci- fied, BRU uses the software bad block descriptor block to create BADBLK.SYS. MANUAL specifies that both the manufacturer-written bad block infor- mation and either the software-detected bad sector file or the bad block descriptor block be used to create BADBLK.SYS. Also, MANUAL accepts the addresses of bad blocks entered manually from the terminal. 2 BUFFERS BRU>/INITIALIZE/BUFFERS:fcbcount source targetddn: The /BUFFERS qualifier specifies the number of directory File Control Blocks (FCBs) per volume kept in memory by the ACP. The more FCBs that are kept in memory, the faster the files are found. The default value for 'fcbcount' is the same as the default for the input disk. The /BUFFERS qualifier is used with the /INITIALIZE qualifier during tape to disk or disk to disk operations. 2 COMPARE BRU>/COMPARE sourceddn: targetddn: The /COMPARE qualifier causes the data on the output device to be com- pared with the date on the input device and any differences to be reported. No data transfer takes place during a COMPARE operation. The command string specifying the COMPARE operation must be identical to that entered when the data on the output volume was created, with the exception of the /INITIALIZE and /NOINITIALIZE qualifiers. 2 CREATED BRU>/CREATED:BEFORE:(dd-mmm-yy [hh:mm:ss]) source targetddn: AFTER:(dd-mmm-yy [hh:mm:ss]) The /CREATED qualifier allows you to select for back-up or restore files created on or before, or after the specified date and time. If you specify both a date and time, the date and time must be enclosed in parentheses. If you specify only a date or only a time, the paren- theses are not necessary. If you specify only a time, today's date is used. 2 DENSITY BRU>/DENSITY:n source targetddn: The /DENSITY qualifier specifies the density at which a magnetic tape is to be written. The following are legal values: Drive Default Density Optional Density TU10 800 NONE TU16 800 1600 TU45 800 1600 TU77 800 1600 TS04 1600 NONE If you specify /DENSITY with /APPEND, you must specify the density at which the old tape data was written. If you specify a density other than the original density, a warning message will be displayed and processing will continue at the correct density. If you specify an incorrect density for a restore operation, an error message is displayed and the operation is terminated. 2 DIRECTORY BRU>/DIRECTORY sourceddn: BRU>/BACKUP_SET:name/DIRECTORY sourceddn: The /DIRECTORY qualifier can be used to list the backup sets on a volume, or to list the files in a backup set. When specified with no backup set name, /DIRECTORY lists all the backup sets on the volume. If a continuation tape is mounted when you enter the command, only the backup sets on that volume, and not those on the first or previous volumes, are listed. The continuation tape number is also listed. When used in conjunction with the /BACKUP_SET qualifier, /DIRECTORY causes the files in the specified backup set to be listed. If the backup set is not on the tape, an error message is displayed and the operation is terminated. 2 DISPLAY BRU>/DISPLAY source targetddn: The /DISPLAY qualifier causes the file name and UFD of each file being transferred to be printed. 2 ERRORS BRU>/ERRORS:n The /ERRORS qualifier requests termination of a restore operation after the specified number of nonfatal tape read errors. The default is /ERRORS:25. 2 EXAMPLES Example of a complete disk copy to a 1600 bpi tape: BRU>/DENSITY:1600 DB2: MM0: Example of a copy from tape to disk, initializing the disk and using prompting: BRU>/DENSITY:1600 FROM: MM1: TO: DK2: INITIALIZE THE OUTPUT DISK? YES Example of a disk to disk transfer from a mounted disk, initializing the output disk: BRU>/INITIALIZE/MOUNTED FROM: DB0: TO: DB3: 2 EXCLUDE BRU>/EXCLUDE ddn:filespec targetddn: The /EXCLUDE qualifier specifes that files matching the file specifi- cation in the source field be excluded from the backup or restore operation. 2 EXTEND BRU>/INITIALIZE/EXTEND:n source targetddn: The /EXTEND qualifier specifies the default number of blocks a file will be extended when that file has exhausted its allocated space. The /EXTEND qualifier is used in conjunction with the /INITIALIZE qualifier during tape to disk or disk to disk operations. 2 HEADERS BRU>/INITIALIZE/HEADERS:n source targetddn: The /HEADERS qualifier specifies the number of file headers to allocate initially to the index file. The primary reason for preallocating file headers is to locate them near the storage bit map file. Proper place- ment of file headers can help reduce head motion during I/O operations. The /HEADERS qualifier is used in conjunction with the /INITIALIZE qualifier during tape to disk and disk to disk operations. 2 INITIALIZE #NOINITIALIZE 2 INVOLUME BRU>/INVOLUME:name source targetddn: The /INVOLUME qualifier specifies the volume label of the input disk or tape. This name can be up to 12 characters long. For backup or disk to disk operations, the volume label of the input volume is checked to verify that the disk has the correct label. This check insures that you do not back up the wrong volume. For restore operations, the volume label of the input tape is checked in order to locate the correct backup set. If the label cannot be located, an error message is displayed and the operation is terminated. 2 LENGTH BRU>/LENGTH:n source targetddn: The /LENGTH qualifier specifies the length of the output tape in deci- mal feet. If the length specified exceeds the length of the tape, the entire length of the output tape will be used. In cases where you know the end of the tape must not be used, you can specify a shorter length to ensure that you do not write on that part of the tape. 2 MAXIMUM BRU>/INITIALIZE/MAXIMUM:n source targetddn: The /MAXIMUM qualifier specifies the maximum number of files that can be placed on a volume, as determined by the number of file headers in the volume's index file. The default maximum is the maximum number of files on the input disk. 2 MOUNTED BRU>/MOUNTED source targetddn: The /MOUNTED qualifier allows you to back up or restore files that are on volumes that are mounted as File-11 volumes. Normally, both the source and target devices are mounted as foreign devices, but by using the /MOUNTED qualifier, the source device may be mounted as a Files-11 device. However, files being transfered should not be modified while the transfer is taking place. 2 NEWVERSION BRU>/NEWVERSION source targetddn: The /NEWVERSION qualifier resolves conflicts that occur during restore operations to an existing disk by creating new versions of the duplicate files. 2 NOINITIALIZE BRU>/INITIALIZE source targetddn: BRU>/NOINITIALIZE source targetddn: The /INITIALIZE qualifier specifies that you want to initialize the output volume during a tape to disk or disk to disk operation. Initia- lization places a Files-11 structure on the disk, including the boot block, the home block, and the required system files. Along with the /INITIALIZE qualifier, you can specify the following qualifier when you are initializing a disk: /BAD, /BUFFERS, /EXTEND, /HEADERS, /MAXIMUM, /POSITION, /PROTECTION, and /WINDOWS. If you do not specify any of these qualifiers, the defaults of the input disk are used. /NOINITIALIZE specifies that you do not want to initialize the disk; it already has a Files-11 structure. The output disk must be mounted as a Files-11 volume. You cannot enter any of the initialization qualifiers listed above when you specify /NOINITIALIZE. When you are restoring to a mounted volume, the file system is used to access the output device. Therefore, a restore operation to a mounted volume is slower than a restore to an unmounted volume. 2 NOPRESERVE BRU>/NOPRESERVE source targetddn: The /NOPRESERVE qualifier specifies that you do not want to preserve file-ids. When file-ids are not preserved, new file-ids are assigned starting at 6 and incrementing sequentially. 2 NOSUPERSEDE #SUPERSEDE 2 OUTVOLUME BRU>/OUTVOLUME:name source targetddn: The /OUTVOLUME qualifier specifies the volume label of the output disk. This label can be up to 12 characters in length. For backup operations, the name of the disk volume, as stored on the output tape volume, is changed to the name specified. For restore operations or for disk to disk transfers, the name of the output disk volume is changed to the name specified. 2 POSITION BRU>/INITIALIZE/POSITION:BEGINNING source targetddn: MIDDLE END BLOCK:n The /POSITION qualifier specifies where on the output volume the index file is to be placed. This qualifier can be used to force the index file, the Master File Directory, and the storage allocation file to a specific location on the disk, usually to minimize access time. The default location is at the same location as that on the input disk. 2 PROTECTION BRU>/INITIALIZE/PROTECTION:(code) source targetddn: The /PROTECTION qualifier specifies the default protection for all new files created on the disk after the BRU transfer has completed. Each access code consists of a positional keyword specifying the protection group (SYSTEM:, OWNER:, GROUP:, WORLD:) followed by a 4-code group specifying the protection, as follows: R - allow read access to file W - allow write access to file E - allow file to be extended D - allow file to be deleted If this qualifier is not specified, the defaults from the input disk are used. 2 QUALIFIERS The available qualifiers are: /APPEND /ERRORS:n /POSITION:BEGINNING /BACKUP_SET:name /EXCLUDE MIDDLE /BAD:[AUTOMATIC] /EXTEND:n END MANUAL /HEADERS:n BLOCK:n OVERRIDE /[NO]INITIALIZE /PROTECTION:(code) /BUFFERS:n /INVOLUME:name /REVISED:BEFORE:date /COMPARE /LENGTH:n AFTER:date /CREATED:BEFORE:date /MAXIMUM:n /REWIND AFTER:date /MOUNTED /SUPERSEDE /DENSITY:800 ! 1600 /NEWVERSION /TAPE_LABEL:name /DIRECTORY /NOPRESERVE /VERIFY /DISPLAY /OUTVOLUME:name /WINDOWS:n 2 REVISED BRU>/REVISED:BEFORE:(dd-mmm-yy [hh:mm:ss]) source targetddn: AFTER:(dd-mmm-yy [hh:mm:ss]) The /REVISED qualifier allows you to select for backup or restore files revised on or before, or after the specified date and time. If you specify both a date and time, the date and time must be enclosed in parentheses. If you specify only a date or only a time, the paren- theses are not necessary. If you specify only a time, today's date is used. 2 REWIND BRU>/REWIND source targetddn: The /REWIND qualifier causes the first magnetic tape of a tape set to be rewound before executing a backup or restore operation. When specified with an input tape, the first tape of the tape set is rewound before it is searched for backup sets. When specified with /APPEND, the first tape of the tape set is rewound and then searched for the logical end of the last backup set before executing the backup operation. 2 SUPERSEDE BRU>/SUPERSEDE source targetddn: The /SUPERSEDE qualifier specifies that when file specifications on the output volume are identical to the file specifications on the input volume, the file on the output volume is deleted and replaced with the file from the input volume. 2 TAPE_LABEL BRU>/TAPE_LABEL source targetddn: The /TAPE_LABEL qualifier specifies the 6 character volume identifier on the ANSI VOL1 label to be placed on the tape during a backup opera- tion or to be compared with the label on the tape on append and restore operations. This allows you to verify that you have mounted the correct tape. 2 VERIFY BRU>/VERIFY source targetddn: The /VERIFY qualifier specifies that after data transfer is complete, the input and output volumes be compared to verify that the transfer was carried out successfully. 2 WINDOWS BRU>/INITILAIZE/WINDOWS:n source targetddn: The /WINDOWS qualifier specifies the default number of mapping pointers to be allocated for file windows. A file window consists of a number of pointers and is stored in memory when the file is opened. The default number of mapping pointers is the same as the default for the input disk.