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