Quarterback V1.4 Release Notes March 10, 1988 Thank you for purchasing Quarterback. We have put a lot of effort into making Quarterback as reliable as possible. We made some last-minute changes to it after the manual was printed, and we noticed a few things which are not clearly explained in the manual. We suggest that you printthese notes and keep a copy with your Quarterback manual. If you call us for support, please have your serial number and version number ready. The serial number is on the Quarterback master diskette label. The version number appears in the title bar of the Quarterback window. Be sure to send us your postage-paid warranty card. It costs you only a few seconds of your time, but we are much more receptive to your call if your card is already in our files. Our business hours are 8:30AM to 5:00PM Pacific time. GENERAL NOTES In our own testing of Quarterback, we can backup a full 20MB CLtd hard disk in about 39 minutes in the fastest mode (write verification disabled andarchive bits not set). Your results may vary, depending on the speed ofyour hard drive and the degree of fragmentation of your files. Quarterback stores its parameter file, QB.OPT, in the S: directory. This directory is normally found on the Workbench disk in DF0. Most hard disk users use the AmigaDOS ASSIGN command to assign the S: subdirectory to their hard disk. You may wish to add this command to your startup-sequence. Otherwise, you may be asked to put your Workbench disk back into a drive so that Quarterback can find the parameter file. After you have begun a restore operation using DF0, and Quarterback has already taken over DF0, you will not be able to use DF0 to access the S: subdirectory. In this case you must wait until after you have completed the restore in order to save your options. We have added a new option for both backup and restore which allows you to write the archive/restoration report to disk instead of printing it. If you specify "disk" as the destination of the report, Quarterback asks for the device and path to the directory into which you want the report written. You can specify any valid AmigaDOS device and path. The device:path you specify is saved along with the other options, and is automatically restored when you invoke Quarterback. If you do not specify a device:path for the report, it is written to the device and directory which is current when you start Quarterback. If you are a "power user" and you wish to use Quarterback without going through all of the normal Quarterback dialog, you may wish to invoke Quarterback from CLI with a parameter file, as described in the Quarterback manual. Quarterback can also be invoked with parameters via the CLI command line, which is not described in the manual. Command line parameters are the same as for a command file. The INCLUDEALL and EXCLUDEALL keywords defined in the Quarterback manual have been eliminated. Instead, the INCLUDE and EXCLUDE keywords accept a parameter of ALL for the file name. Therefore, you cannot INCLUDE or EXCLUDE a file named ALL in a command file or on the command line. For example, to invoke Quarterback to backup word processing documents which have changed since the last backup in subdirectory WP on DH0, you wouldtype: QUARTERBACK BACKUP DH0:WP EXCLUDE ALL ARCHIVE Command line or command file parameters can be in any order, but are executed in the order listed. Some keywords make no sense if executed in the wrong order. So be sure that you consider the effects of each keyword as you decide the order to enter them. For example, it makes no sense to follow DATE xx-mmm-yy with INCLUDE ALL. The maximum path length supported by Quarterback is 256 characters, including the device/volume name. Gadgets for selecting the floppy disk drives have been changed on theBACKUP OPTIONS screen and removed from the RESTORE OPTIONS screen. Backup and restore now support the use of DF0, DF1, DF2, or DF3. Backup can use one or two drives. Restore uses only a single drive. Menu items are disabled when the backup or restore is active. If you think you may need another CLI, open it before you proceed from the Options window. Quarterback does NOT support the full wild card options of AmigaDOS. Wild cards are limited to ? anywhere in a name, and #? appearing ONCE in a name, such as: #GA?E?.c or files#? Abort gadgets appear on several screens in Quarterback. Quarterback checks the abort gadget periodically, usually when it has finished performingsome major activity, such as backing up or restoring an entire file. Thus, if you click on an abort gadget you may not see any response for severalseconds. The natural temptation is to click a few more times to "wake up" Quarterback. This may create undesirable actions, since the extra clicks are usually saved, and may be acted upon in order when Quarterback finally looks for them. When Quarterback sends a report to the printer, the printer usually holds many lines of text in its buffer. Therefore, if you aborta report, the printer may continue to print for some time before stopping. Don't remove Quarterback disks while the drive light is on. And be sure to remove Quarterback disks when warned. AmigaDOS doesn't like Quarterback disks. Disks formatted by Quarterback can be copied/verified using the AmigaDOSDiskcopy utility. Quarterback has very low overhead per file. The catalog entry is about 25 bytes per file (depending on the length of the file name and possible file comments). There is a 14-byte ID per disk drive. Each file is stored as pure data. No compression is used, other than the fact that Quarterback has much lower overhead per file than AmigaDOS, and consequently is able to store more useful data per floppy than AmigaDOS. BACKUP NOTES If you have partitioned your hard disk, you must backup or restore eachpartition as a different device. When Quarterback builds a catalog of files to backup it automatically scans down through all levels of the directory tree structure, starting at the device or device/path that you specify. If you wish to include files from any directory on a drive, you should specify just the device itself, so that Quarterback can scan from the root directory down through all levels of the structure. If you know that you want only files from a single directory and nothing else, you should specify the full device/path to that directory. When Quarterback has built the complete catalog, you can then select theindividual files or groups of files to be included in (or excluded from) the backup. All files are "included" when Quarterback first displays the catalog. If you wish only to backup one or two files, you should first"exclude" all files, then "include" only the ones you really want. You can move down or up the tree, including or excluding files as you wish, until you have identified all files to be processed. Then you are ready to proceed with the backup. A new option affecting how subdirectories are backed up has been added to the BACKUP OPTIONS screen. It is: Backup full subdirectory structure: YES NO If you select YES, Quarterback includes all subdirectories in the backupcatalog, even if a subdirectory is empty (contains no files or other sub-directories). This takes up only a little more room in the catalog of the first backup disk, but makes it possible for you to restore the empty sub-directories, if you wish (using the Restore Full Subdirectory Structure option described below). You might want to do this if you are performing a full restore to a replacement disk drive, and you want the restored disk to have the exact same directory structure as the original drive. If you select NO, Quarterback includes only those subdirectories in thebackup catalog which contain files or other subdirectories to be backed up. Quarterback can now use any of the standard floppy drives, DF0-DF3, forbackup. Any pair of these drives is also valid. However, no more thantwo floppies can be used for backup. During backup, Quarterback writes a unique identification code to each disk, including a sequence number and the date and time of the backup. On restore, Quarterback checks each disk for the proper sequence number, and the date and time. The date/time stamp allows Quarterback to detect intermixing of disks from different sets of backups. Quarterback can be directed to read each track of the backup disks after writing. If Quarterback finds an unusable track on a disk during backup, it warns you and asks you to replace the bad disk with another disk. It then resets itself to the beginning of that disk and continues. The new diskreplaces the bad disk in its entirety. You need not retain the bad disk. You CANNOT overwrite an individual file on an existing set of backup disks. Each backup operation completely erases any previous data on a set of disks. Quarterback does NOT allow you to "add" more files to an existing backup set of disks. The "incremental" backup mode always produces a new set of disks which contain only those files which have changed since some previous backup. When you perform an incremental backup you must also retain the previous set of backup disks. Quarterback may encounter illegal file names, such as "*" when it builds the catalog of files. Such file names cannot be processed by Quarterback, and are automatically excluded from the catalog and from the backup. If Quarterback cannot open a file or detects a read error in a file during the backup, it fills the space allocated for the file on the backup disk with random data, warns you with a message on the screen, and marks the file name with *** ERROR *** on the archive report. However, the file does appear in the backup catalog, even though the data in the file is useless. This happens because the catalog is written to the first diskette, long before Quarterback discovers the problem. If you attempt to restore such a file, you will find the contents useless. During restore, you shouldexclude any files which are marked *** ERROR *** on the backup report. RESTORE NOTES Quarterback now restores comments, protection bits, and the date/time stamp on all files AND directories. The restore option called "Create Subdirectories, as necessary" has beeneliminated. In its place you will find a new restore option affecting the way empty subdirectories are handled. It is: Restore full subdirectory structure: YES NO If you are restoring to a device/path which already has a subdirectorystructure which matches the catalog on the backup disks, this option has no effect. If you select YES, Quarterback restores all subdirectories found in thebackup catalog, even if the new subdirectory will be empty. If you select NO, Quarterback restores only those subdirectories whichcontain files marked for restoration. You should set this option to "NO" if you are restoring just a few files to a device which already has the desired subdirectory structure in place. Specify "NO" to avoid creating a bunch of empty directories which are of no use to you. Creating all those empty subdirectories can takes many minutes. User beware! If you restore to a different subdirectory on the same device, you may run out of room on that device, especially if you specify that the full sub-directory structure is to be restored. Restore uses only a single floppy drive, with no automatic switching offloppy disk drives. You can use any one of the available floppy drives for the restore, but only one. Our reasoning for this limit is that restore is a critical process, and even though it may take some time, you should give it your total attention. Quarterback performs many error checks during restore. If it finds an error, the recovery from that error is much more complicated if there are two floppy drives involved, both for the userand the program. For restore, we have moved the floppy drive option from the options screen to the device screen, so that Quarterback can know which disk drive to use for reading the catalog, which is stored on the first disk of the backupset. We have added an additional restore option, "Set archive bit for restored files". If you select "YES" Quarterback sets the archive bit for all files it restores; if you select "NO" Quarterback restores the archive bit as it was saved at the time of the backup. Note: during backup, the archive bit is set AFTER the file is successfully backed up. Therefore the archive bit may not actually show up as set when the file is restored, unless you invoke this restore option. Restoring a set of files takes longer than backing up that same set of files. This is because of the extra steps necessary to restore the protection bits and the date/time stamp on each restored file. Restore also performs many other data integrity checks which you may never run across, unless you have a corrupted directory or have damaged your backup disks. During a restore operation, Quarterback replaces existing files if duplicates are found on the target device. Each original file is effectively erased before its replacement is copied from floppy. This means that if the replacement cannot be properly restored, the original is gone, and neither is available. Beware. This is to minimize disk usage. If you want to avoid the dangers of losing your original files and then having the restore fail, we suggest restoring your files to a different subdirectory or to a different device. That way you can verify the integrity of the replacements before deleting the originals. If Quarterback cannot restore a file because of a bad disk, or if some other error prevents the successful restoration of a file, Quarterback marks the bad file on the restoration report by adding "ERROR" to the line where the file name appears. During a restore operation, if a disk of the backup set becomes unreadable, or you cannot find one of the disks, Quarterback lets you skip the bad or missing disk and continue with the restoration. Of course, all files which would have been restored from that disk cannot be restored, and are marked "error" on the restoratiuon report. You CANNOT skip the first disk, since the catalog of files is stored on the first disk. Quarterback V2.2 Release Notes October 29, 1988 Thank you for purchasing Quarterback. We have put a lot of effort into making Quarterback as reliable as possible. We made some last-minute changes to it after the manual was printed, and we noticed a few things which are not clearly explained in the manual. We suggest that you print these notes and keep a copy with your Quarterback manual. If you call us for support, please have your serial number and versionnumber ready. The serial number is on the Quarterback master diskettelabel. The version number appears in the title bar of the Quarterback window. Be sure to send us your postage-paid warranty card. It costsyou only a few seconds of your time, but we are much more receptiveto your call if your name is already in our computer. Our business hours are 8:30AM to 5:00PM Pacific time. SUMMARY OF V2.2 CHANGES - Two-drive backup/restore, with automatic switching - Support for CLtd's Konica 10.7MB floppy drive - Support for CSA's streaming tape drive - Support for Inner-Connection's Bernoulli Box - Backup/restore to any AmigaDOS device with mountlist entry - Writes two copies of catalog to backup volumes - Backup/restore reports can be assigned unique path/name - Uses devices name strings, not gadgets for device selection - Selected devices and report path/names saved in parameter file - "Volume changed" gadgets added to status boxes - Report lines-per-page from Preferences - References to "diskettes" changed to "volumes" - Fully supports PAL windows and/or Morerows - Fully compatible with new Fast File System (VERY FAST!!) - Uses default report names if cannot open user-defined name GENERAL NOTES If you run Quarterback from CLI (instead of Workbench) you should makecertain that you issue the command: STACK 10000 before you invoke Quarterback. Many Amiga users insert the STACK command into their startup-sequence so that the stack is set large enough for a variety of programs. You can use a larger stack, if you wish, but Quarterback may occasionally crash if the stack is too small. Quarterback expects you to define the device(s) you wish it to use to backup your files or restore your files. Unless your Amiga is equippedwith some high-capacity removable-media device, such as the new Konica 10.7MB floppy drive, you will probably want to back up your files to oneor two floppy disk drives. In any case, you must always use the proper AmigaDOS name for the device, such as DF0:, DF1:, etc. If you intend tobackup your files to some device other than floppy disks, you must knowthe proper AmigaDOS name for that device. This is defined in the Mountlist file, which is part of the DEVS: subdirectory. If you do notknow what the Mountlist is or how to find it and examine it, you shouldask your Amiga dealer for help. Attention A2000 owners - if you have two 3.5-inch floppy drives, and they are physically arranged with DF2 on the left and DF0 on the right, youcan force Quarterback to display DF2 status in the left status box andDF0 status in the right status box (so that the status boxes correspondto the physical arrangement of the disk drives). To do this, simply enter DF2 as the primary backup device and DF0 as the secondary backupdevice. The primary backup device is always assigned to the left statusbox, and the secondary backup device is always assigned to the right status box. If you wish to use cheap 5.25-inch diskettes for your backup volumes, you can use the Amiga model 1020 5.25-inch floppy drive for backups and restores. However, you must follow these steps: 1. Make a new Mountlist entry for the drive. Assign it a new device name, such as FLOP:. Copy the remainder of the parameters from the entry for DF2:. DO NOT ASSIGN A NAME of DF0, DF1, DF2, or DF3. Anything else is fine. 2. Mount the new device name manually from CLI or add the new mount command to your startup-sequence. 3. Start Quarterback. Specify the new device name as the primary backup device. If you don't understand how to modify the Mountlist and startup-sequence, ask your Amiga dealer to help you. If you specify that an archive or restoration report is to be sent to adisk and Quarterback cannot successfully open a file to hold the report, Quarterback reports that fact and asks if you wish to retry. If you answer NO, Quarterback produces no report. If you answer YES, Quarterback uses the default report name and places the report in the current directory. This only applies to reports sent to disk. If you have specified PRT: to receive the report, the preceeding comment does not apply. DTM Werbung und EDV GmbH is the official distributor of the German language version of Quarterback. For further information, contact: Andreas Hoffmann DTM Werbung und EDV GmbH Poststrabe 25 6200 Wiesbaden-Bierstadt Federal Republic of Germany BACKUP NOTES In our own testing of Quarterback, we can backup a full 20MB hard disk in about 30 minutes in the fastest mode (write verification disabled andarchive bits not set). Your results may vary, depending on the speed ofyour hard drive and the degree of fragmentation of your files. Quarterback may encounter illegal file names, such as "*" when it buildsthe catalog of files. Such file names cannot be processed by Quarterback, and are automatically excluded from the catalog and from the backup. RESTORE NOTES Quarterback writes a list of all the files to be backed up onto the first backup volume. We call this list the "catalog of files". When you restore your files, Quarterback uses this list to find the name, size, and location of each file on the backup volumes. Quarterback cannot restore even a single file without this catalog. Earlier versions of Quarterback wrote the catalog of files to the first backup volume only. This means that NONE of your files could be restored if the first backup volume became lost or unreadable. We have corrected this problem in version 2.0. Quarterback V2.0 writes TWO copies of the catalog to your backup volumes. One copy is written to the FIRST backup volume, as before, andthe other copy is written to the LAST backup volume. This happens automatically during the backup operation. During a restoration, if Quarterback cannot find the catalog on the first backup volume, you candirect it to look for the alternate catalog on the LAST backup volume. Follow these steps: Step 1. Quarterback first directs you to load the first backup volume. Load the first volume and click PROCEED. Step 2. Quarterback checks for a valid Quarterback backup volume ID, sequence number 1. If Quarterback cannot find the a valid ID, it warnsyou that the volume is not a Quarterback backup volume. If it finds the proper ID, it tries to read the catalog. Step 3. If Quarterback cannot read the primary catalog from the first volume, it warns you in a requester. You have three choices: PROCEED (retry), SKIP (go past the bad disk) or CANCEL (stop the restoration). Step 4. Click on SKIP to direct Quarterback to attempt to read the alternate catalog. Quarterback directs you to load the LAST volume of the backup set. Note: Quarterback cannot know which volume is the lastone. YOU must do the thinking here. If you load a volume other than the last volume, Quarterback will not be able to find the alternate catalog. Step 5. Load the LAST volume of the backup set. Click PROCEED. Quarterback scans that volume looking for the alternate catalog. This scanning process may take a minute or more, since Quarterback does not know just where the catalog will be found, if it is found at all. If Quarterback cannot find the alternate catalog on the volume you have loaded, it will warn you in a requester. Note: It is possible that thealternate catalog may actually start on the next-to-last volume, and mayend on the last volume. In this case, Quarterback will direct you to load the proper volume by number. When Quarterback has successfully loaded one of the catalogs, it will display the catalog of files on the screen. If neither catalog can be found, it is not possible to restore ANY of the files. Quarterback V2.0 permits the use of two disk drives for restoring files to your hard disk. As the files are restored from a volume, Quarterbackdirects you to load the next sequential volume so that no time is lost when the first volume is finished. This works just fine if you are performing a full restoration, since the volumes are always used in numerical order in that case. However, if you are restoring only a few files which are scattered across several backup volumes, Quarterback may discover that the volume it has already told you to load is not the volume it needs next. In this case, it may direct you to load a different volume without ever looking at the one you have already loaded. To avoid this inconvenience you should consider using only a single drive when you restore only a few files. Attention A2000 owners with the Bridgeboard! You CAN backup and restoreyour MS-DOS virtual disk drives using Quarterback. You can specify theAmigaDOS device (such as P2:) and optional path to the directory containing the virtual MS-DOS drive (which appears as a single AmigaDOSfile on the Amiga side of the system). WARNING - If you attempt to restore this file from your backup volumes, you must perform the restore BEFORE you issue the JLINK command. If you attempt to restore the fileAFTER the JLINK command, Quarterback will be unable to write into file and you will see a cryptic requester indicating a restore error. This happens because the file is locked by JLINK, and cannot be deleted or written into from the Amiga side. GOOD LUCK! Here's hoping that you never need to use Quarterback to restore your hard disk. And thank's for your support! George and Betty Chamberlain Central Coast Software