Programmer 7500

home *** CD-ROM | disk | FTP | other *** search

/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / HARDDISK / P_SBURES.ZIP / PASBRDOC.TXT < prev next >

Wrap

Text File | 1988-07-30 | 36.2 KB | 993 lines

POINT & SHOOT BACKUP/RESTORE 1.0 Copyright (C) 1988 All Rights Reserved Applied Micro Systems Technology Kurt H. Diesch Member, Association of Shareware Professionals Revised: June 20, 1988 Point & Shoot Backup/Restore is a hard disk backup and restoration program designed for IBM Personal Computers and 100% compatibles. Applied Micro Systems Technology reserves the COPYRIGHT to this program and all related materials. The user is granted a non-exclusive license to use the program and is encouraged to pay for the program if it is found to be useful. Payment of the $35 registration fee will entitle the user to full registration including printed documentation and user support. Government and business entities may not use the program without paying the full registration fee. Please register your program with the form included at the end of the documentation. REMEMBER: Shareware is not free! Send payments to: Applied Micro Systems Technology P.O. Box 1596, Welch Ave. Station Ames, Iowa 50010 The user is also granted permission to make unlimited copies of the program and to distribute those copies as long as no fee is charged for the program. A duplication charge not to exceed $5 may be collected. Applied Micro Systems Technology specifically disclaims all warranties, expressed or implied, including but not limited to, implied warranties of merchantability and fitness for any particular purpose. In no event shall Applied Micro Systems Technology be liable for any loss of profit or any other commercial damage, including but not limited to special, incidental, consequential or other damages. MEMBER - ASSOCIATION OF SHAREWARE PROFESSIONALS The author of this program is a member of ASP and has agreed to comply with its standards: Programming standards- - The program meets ASP's definition of Shareware. - The program has been thoroughly tested by the author and should not be harmful to other files or hardware if used properly (although ASP cannot warrant this; therefore, the user should take normal precautions in trying new software). Documentation standards- - Sufficient documentation is provided to allow the average user to try all major functions of the program. - The program author has explained the Shareware concept in a professional and positive manner. Support standards- - The program author will respond as described in the documentation to people who send registration payments. At a minimum, the author will send an acknowledgement of payment. - The author will respond to written bug reports from registered users when the user provides a self-addressed, stamped envelope (some authors will respond by phone, but this is not an ASP requirement). - Incompatibilities with other software or hardware, major or unusual program limitations, or known problems are noted in the documentation that comes with the shareware version of the program. General- - The author keeps his/her membership in ASP current. - The author recognizes that any user may appeal to ASP for any unresolved dispute that arises. If you feel that the author has not complied with these standards in some manner or if you register the program with the author and subsequently have any disputes with the author which cannot be resolved, please write the ASP at: Association of Shareware Professionals 325 118th Ave SE, Suite 200 Bellevue, WA 98005 While ASP cannot warrant programs nor the actions of members, ASP will do what it can to assure that all authors who claim membership comply with ASP standards. These standards are the assurance of quality and support that you will get when you register Shareware produced by ASP members. SHAREWARE To promote better understanding of the shareware concept, ASP has developed the following official definition of shareware: Shareware distribution gives users a chance to try software before buying it. If you try a Shareware program and continue using it, you are expected to register. Individual programs differ on details -- some request registration while others require it, some specify a maximum trial period. With registration, you get anything from the simple right to continue using the software to an updated program with printed manual. Copyright laws apply to both Shareware and commercial software, and the copyright holder retains all rights, with a few specific exceptions as stated below. Shareware authors are accomplished programmers, just like commercial authors, and the programs are of comparable quality. (In both cases, there are good programs and bad ones!) The main difference is in the method of distribution. The author specifically grants the right to copy and distribute the software, either to all and sundry or to a specific group. For example, some authors require written permission before a commercial disk vendor may copy their Shareware. SO, Shareware is a distribution method, not a type of software. You should find software that suits your needs and pocketbook, whether it's commercial or Shareware. The Shareware system makes fitting your needs easier, because you can try before you buy. And because the overhead is low, prices are low also. Shareware has the ultimate money-back guarantee -- if you don't use the product, you don't pay for it. TABLE OF CONTENTS ----------------- INTRODUCTION .................................... 1 INSTALLATION .................................... 3 GENERAL OVERVIEW ................................ 4 MAIN MENU COMMANDS .............................. 6 Backup ....................................... 6 Restore ...................................... 6 Setup ........................................ 6 BACKUP COMMANDS ................................. 7 Backup ...................................... 7 Calculate .................................... 8 Delete ....................................... 8 Format ....................................... 9 Update ....................................... 9 RESTORE COMMANDS ................................ 11 Restore ...................................... 11 Update ....................................... 12 SETUP ........................................... 13 REGISTRATION FORM ............................... 14 INTRODUCTION ------------ Point & Shoot Backup/Restore is a companion program for the Point & Shoot Hard Disk Manager but can also be used as a stand-alone product. Point & Shoot Backup/Restore is designed to provide fast, easy backup of your hard disk data to floppy disks. User involvement is minimized in the backup and/or restore process. If you own a hard disk, Point & Shoot Backup/Restore is a necessity. Point & Shoot Backup/Restore currently supports the following functions: o Up to 10 user-defined backup configurations, each of which may contain a list of up to 10 subdirectory backup sources. Each backup source directory may include trailing directories for complete flexibility in backup definitions. o Each backup definition allows selection of matching file specs, modified files only, and optional disk formatting during the backup process. A graphic directory tree display assists in the selection of backup source directories. o Files remain intact on backup disks (except when disk boundaries must be crossed). Required number of backup disks are automatically calculated. o Restoration options include source drive, restoration to other than the original path, prompts for duplicate or modified files, and selective file restoration. Again, a graphic directory tree assists in selection of restoration paths. o Configuration options include colors, an hourly chime, and last drive designation. o Supports 360K and 1.2M 5-1/4", 720K and 1.4M 3-1/2" floppy disks. Point & Shoot Backup/Restore requires the following hardware and software to operate correctly: o IBM or 100% compatible computer with 256K minimum memory (640K if running from within the Point & Shoot Hard Disk Manager) o A hard disk and 1 floppy disk o MS-DOS version 2.0 or greater o Color/graphics, monochrome, EGA or VGA display adaptor - 1 - I am more than willing to enhance the program to meet the needs of you, the user. As you are well aware, part of the reward for writing well-received software is monetary. If you would like to continue to use Point & Shoot Backup/Restore, a $35 payment will register your copy of the program. The registration fee entitles you to printed documentation and user support. Please use the registration form found in this documentation file to register your copy of the program. - 2 - INSTALLATION ------------ Installation of this program is as simple as operating the program itself. Follow these installation instructions carefully. If any problems are encountered, first check your computer. If you still have problems, enlist the aid of someone who is perhaps more knowledgeable with computers than yourself. A third alternative is to contact AMST. Note: Only registered users will receive support, but if you are testing the program, you may receive limited support. 1) Place the Point & Shoot Backup/Restore program disk in floppy drive A: 2) From the ROOT DIRECTORY of your hard disk, type: A:INSTALL 3) If running Point & Shoot Backup/Restore from within Point & Shoot Hard Disk Manager, your AUTOEXEC.BAT file must contain the following line: PATH \P&S 4) You may now execute Point & Shoot Backup/Restore from within the Point & Shoot Hard Disk Manager or as a stand-alone program by entering PASBR at the DOS prompt. To print the documentation, type the following from the DOS prompt: COPY PASBRDOC.TXT PRN: Another option to print the documentation is to use the File Print command found in the Point & Shoot Hard Disk Manager file commands. To run the program, only the file PASBR.EXE must be available. Following is a complete list of the Point & Shoot Backup/Restore program and data files contained on the distribution disk. CHANGES.TXT Revisions of Point & Shoot Backup/Restore PASBR.EXE The Point & Shoot Backup/Restore program PASBRDOC.TXT Point & Shoot Backup/Restore documentation FILES.TXT Description of the files on the disk INSTALL.BAT Point & Shoot Backup/Restore installation file READ.ME Last minute changes to the program - 3 - GENERAL OVERVIEW ---------------- Point & Shoot Backup/Restore may be executed in three ways. If you own the Point & Shoot Hard Disk Manager, Point & Shoot Backup/Restore may be executed with the BACKUP command from Point & Shoot's main menu (you must have 640K memory for this option and PASBR.EXE must reside in the P&S directory or a directory in the PATH command of your AUTOEXEC.BAT). If you do not have enough memory for this option, you may install the Backup/Restore program as a user-defined menu item in the Point & Shoot Hard Disk Manager. The Point & Shoot Backup/Restore program may also be executed as a stand-alone program by entering PASBR from the DOS command line. When Point & Shoot Backup/Restore is run, the main program screen will appear. The top line of the screen displays the name and version of the program, a copyright notice and the current date and time. The center portion of the screen displays a detailed copyright notice and registration information. The bottom section of the screen displays the program menus with an explanatory line on the bottom. Most of the program functions are executed through the list of commands shown in the bottom area of the screen. The [space] or [BackSpace] keys may be used to highlight the desired command. The one line description of the command shown on the last line of the screen will change appropriately. To execute any of the functions, press the first letter of the command. The command corresponding to the selected letter will be immediately executed Some commands will invoke another command list. The name of the current command list is always shown on the left side of the command list. You may move to a previous command list by pressing the [Esc] key. Each command list also has a QUIT command which will move to the previous command list. In general, the [Esc] key serves to abort any operation or selection. To quit the program and return to the operating system (or back to the Point & Shoot Hard Disk Manager), press [Esc] or select QUIT from the Main Menu command list. At many points in the program, you will be entering or changing information on the screen. The procedure is generally the same and is outlined here. Differences that occur in this procedure are covered in the appropriate detail sections of this documentation. When entering or updating data screens a flashing "*" will appear on the data screen to indicate where your information is to be entered. A cursor will also show the current position within a data field. (Data fields are the hilited areas of the screen). Some or all of the following commands will be available for data entry: - 4 - [left/right arrow]: Moves the cursor within the current field. If the cursor is at the first position within a field, then the previous field will be selected. If the cursor is at the last position within a field, then the next field will be selected. [ctrl-left/right]: Moves the cursor to the first position or last character of the field. [up/down arrow]: Select the previous or next data field for editing. [Enter/return]: Same as right or down arrow for next field. [F8]: Blanks the current data field. [Esc]: Aborts changes made to the data screen and completes enter/update action. [F10]: Accepts changes made to the data screen and completes enter/update action. - 5 - MAIN MENU COMMANDS ------------------ The Main Menu is the center of Point & Shoot Backup/Restore activity. Some of the Main Menu commands move to another command list, while others will immediately execute a command. Following is a description of the Main Menu commands. BACKUP Moves to the BACKUP menu from which you may perform a backup of hard disk data to floppy disks. RESTORE Moves to the RESTORE menu from which you may perform a restoration of previous backup disks to your hard disk. SETUP Moves to the program setup data screen described later. - 6 - BACKUP COMMANDS --------------- The Backup Menu consists of a set of commands that perform the following functions: o Backup your hard disk using up to 10 different user-defined backup configurations o Calculate the number of disks required for a selected backup configuration o Format floppy disks to be used for backup Point & Shoot Backup/Restore performs backups on a file by file basis with some files crossing disk boundaries. Extensive error checking is included to provide a high level of backup integrity. Subdirectories may be selectively backed up and previous backups may be optionally restored to different subdirectories. For your protection, Point & Shoot Backup/Restore will not back up the system files found in the root directory of your hard disk. BACKUP The BACKUP command starts the backup process according to the displayed current backup configuration. See the UPDATE command for details concerning changes to the backup configuration. When the BACKUP command begins, a backup status screen will appear to show the progress of the backup including the following: File Name: Path and name of the current backup file File Size: Size (in bytes) of the current backup file Total Bytes: Total bytes of files that have been backed up Files: Total number of files that have been backup up Disk Space: Remaining space on current backup target disk Point & Shoot Backup/Restore will next instruct you to insert a disk in the drive indicated by the backup configuration. Insert a disk and press [Return] to proceed with the backup. The backup process may be aborted at this point by pressing [Esc]. Once the backup process begins, it may only be stopped when the prompt for the next backup disk appears. If the format option is selected, each new backup disk will be formatted before files are transferred. See the FORMAT command for details regarding the built-in format program. With or without the format option, Point & Shoot Backup/Restore will delete all files from the target disk before transferring files. The transfer of files to the backup disk will then begin. - 7 - If a file is to large to fit on a single disk, Point & Shoot Backup/Restore will split the file between two or more disks and mark it as a split file for restoration purposes. A situation may occur where the target backup disk contains a duplicate filename (when two or more hard disk subdirectories are placed on the same backup disk). In this case, Point & Shoot Backup/Restore will automatically rename the file. The original name is also stored so that the correct file name will be maintained during the restoration process. When the backup process is complete, a message will appear to indicate completion. Make sure that all backup disks are correctly numbered as the restoration process will require that the disks are restored in sequential order. CALCULATE CALCULATE calculates the number of disks required for the current backup configuration. The total number of files, along with the total number of bytes contained in those files, will be displayed. Note that the correct disk type must be selected prior to using the CALCULATE command. Several factors are considered when calculating the number of disks required for a backup. Point & Shoot Backup/Restore stores one special file called PASBRID.DAT on each backup disk, leaving a total possible of 111 files for 360K and 720K disks, and 223 files for 1.2M and 1.4M disks (a DOS limit). In addition, the special file will reduce the available space (in bytes) of each backup disk to the following: 360K 342,016 bytes available 1.2M 1,193,472 bytes available 720K 709,632 bytes available 1.4M 1,437,184 bytes available It should be noted that every file copied to a backup disk requires a minimum of 1024 bytes (this is a DOS requirement). The result is that more bytes must be available on a backup disk than the total of the individual file sizes. CALCULATE takes this into account when determining the required number of backup disks. It is a good idea to have several extra disks available for the backup session in case a bad disk is encountered. DELETE DELETE clears the current backup configuration to default entries. - 8 - FORMAT The FORMAT command is used like the DOS FORMAT command to format diskettes. For your protection, the FORMAT command will only operate on drives A and B. When you select the FORMAT command, the program will automatically initiate the format process based on the current backup configuration drive and disk type. All disks formatted with the FORMAT command will be checked for bad sectors. Progress of the format operation will be shown on the screen. When the format operation is complete, the total and available bytes on the formatted disk will be shown. Unlike the FORMAT command found in the Point & Shoot Hard Disk Manager, this FORMAT command will not allow the target disk to have any bad sectors. If you wish to format another disk, you may select FORMAT again. UPDATE Update modifies the settings for the backup configurations. Data entry is accomplished according to the commands described in the GENERAL OVERVIEW section of this documentation. In addition to the standard editing commands, the [F7] function key is used to select backup source paths. The [F7] key invokes the graphic directory tree display from which a path may be selected with the [up/down arrow], [PgUp], [PgDn], [Home], [End], and [Return] keys. The [Esc] key will abort from the path selection process without selecting a path. A different backup configuration may be selected with the [PgUp] and [PgDn] keys. The [F10] key saves all the backup configurations, and [Esc] will cancel changes made. Following is a description of the data fields found on the backup configuration screen: BACKUP CONFIGURATION DESCRIPTION: A short description of the backup configuration DESTINATION DRIVE: The floppy disk drive to be used for the backup BACKUP DRIVE TYPE: The type of the destination drive FORMAT BACKUP DISKS: Option to format backup disks during the backup process MODIFIED FILES ONLY: Option to include only files modified since the last backup - 9 - Ten backup source paths are available for each backup configuration. Each path line allows for entry of the following data: BACKUP SOURCE PATHS: The directory from which files will be backed up FILE SEARCH: The filename search string to match. Any string of characters may be entered including ? and *. Only those files matching the FILE SEARCH will be selected for backup. INCLUDE TRAILS: Option to include the subdirectories following the BACKUP SOURCE PATH. If enabled here and a subdirectory is duplicated in another specification line, the duplicated subdirectory will be backed up twice. - 10 - RESTORE COMMANDS ---------------- The Restore Menu consists of commands used to restore files to a hard disk from backups made with the Point & Shoot Backup/Restore BACKUP command. RESTORE The RESTORE command starts the restore process according to the Point & Shoot Restoration Options. Some of the files on a backup disk could be copied to a hard disk with a standard copy command, but files that cross disk boundaries and files that have been renamed during the backup process require the use of Point & Shoot Backup/Restore for proper restoration. In general, it is best to use Point & Shoot Backup/Restore for all restoration activity. The Restoration Options should be checked for accuracy before starting the restoration (see UPDATE below). The restore process begins by prompting for the first backup disk. Disks must be restored in the same order that they were backed up. If an error occurs during the restoration process, the restoration will be terminated. Restoration may be cancelled when a prompt appears for the next disk by pressing [Esc], but this action may result in partial files restored to the hard disk. If restoring to a new subdirectory (see UPDATE), a graphic directory tree will appear for path selection each time the original path changes on the backup disks. The commands used to select a new path are the same as with the BACKUP command. Target subdirectories other than the original directory must be created prior to the restoration process (otherwise, they could not be selected). If the restoration requires more than one disk, the program will prompt for additional disks. During the restoration process, the status is displayed at the bottom of the screen. The status display includes the following information: File Name: The original path and file currently in restoration Copy To: The path and file to restore to File Size: The size (in bytes) of the file being restored Total Bytes: Total number of bytes restored from all disks Files: Total number of files restored from all disks Disk Space: Number of bytes left on the target disk - 11 - Point & Shoot Backup/Restore maintains a record of how many disks were used for the backup and will automatically stop after the last disk has been restored. Point & Shoot Backup/Restore also tracks of the appropriate disk number during restoration and will issue an error message if a disk is inserted in non-sequential order. UPDATE Update modifies the data fields in the Restoration Options screen. Data entry is accomplished according to the commands described in the GENERAL OVERVIEW section of this documentation. The [F10] key saves all the Restoration Options, and [Esc] will cancel changes made. Following is a description of the data fields found on the restoration options screen: RESTORE SOURCE DRIVE: The floppy disk drive to be used for the restoration. RESTORE TO ORIG. PATH?: Option to restore backup files to the directory from which they came, otherwise the program will prompt for a target directory with a graphic directory tree. PROMPT ON DUPLICATES?: Option to force prompting if the restoration encounters a duplicate file name PROMPT ON MOD FILES: Option to force prompting if the restoration encounters a file that has been modified since the last backup RESTORE SELECTIVELY?: Option to force prompting for restoration of each file on a backup disk - 12 - SETUP ----- The SETUP command is used to establish the configuration for Point & Shoot Backup/Restore. In SETUP, you can select program colors and other defaults. Available fields for SETUP include: COLORS: If your computer has a color monitor, you will be allowed to edit the program colors. Only some of the colors can be set including the background, low text, normal text, headline, and help line. A sample screen is shown to assist in color selection. Use the up and down arrow keys to select a color to modify, then use the left and right arrow keys to choose a color. The new colors will take affect when you quit SETUP. BEEPER ON?: If "Y", the computer's beeper will sound on errors and other places within the program. Set this to "N" if the beep is not desired. HOURLY CHIME?: If "Y", the computer's beeper will sound when the time reaches the hour mark. LAST DRIVE: Determines the highest hard drive letter on your computer for directory tree scanning. - 13 - REGISTRATION FORM ----------------- PROGRAM: Point & Shoot Backup/Restore VERSION: 1.0A SERIAL #: ___________________________ Applied Micro Systems Technology P.O. Box 1596, Welch Ave. Station Ames, Iowa 50010 Name __________________________________________________ Company __________________________________________________ Address __________________________________________________ __________________________________________________ __________________________________________________ Phone ( ) _______________________ Payment $_______ $35 for full registration, printed documentation and user support. (no cash please) IA add 4% tax. Where did you hear about this program? ____________________ Comments __________________________________________________ __________________________________________________ __________________________________________________ __________________________________________________ __________________________________________________ __________________________________________________ - 14 -