OS/2 Professional

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

/ OS/2 Professional / OS2PRO194.ISO / os2 / diskutil / backup2 / bu.doc next >

Wrap

Text File | 1991-07-07 | 16.7 KB | 386 lines

████████████████████ ██ ██ ██ Backup/2 ██ ██ ██ ██ Version 1.01 ██ ██ ██ ████████████████████ ┌───────────────────────────────────────────────────────────────┐ │ GENERAL │ └───────────────────────────────────────────────────────────────┘ Backup/2 makes fast, intelligent file backups for machines running the OS/2 operating system. It copies up only files which don't exist on the target drive, or whose date-time stamps are later than those of existing target files. (A date-time stamp tells when a file was created or last changed; it appears in directory listings.) Backup/2 does not use or change file archive bits (unless you use the /A option). Regular, frequent backups are your insurance policy. They protect the integrity of your data, especially if you have a hard disk. Backups protect against the inevitable disk crash, and against malicious software that tries to destroy your files (e.g., computer viruses and so called "Trojan horses"). A single computer virus, for example, could bankrupt a business by destroying vital customer or financial records. Even in a home environment, you might have to spend hours or days reloading software and data files after a virus attack or a hard disk crash. Backup/2 can help protect against these disasters. To run program, enter: BU source[...] [target] [/A] [/G[C]] [/Vdrive:label...] Brackets ([]) indicate optional items. Ellipses (...) indicate items you can repeat. Arguments can be upper or lower case. Separate arguments with tabs or spaces. ■ 'Source' specifies the files to back up. You can use standard wild card characters (? and *), & you can give multiple sources if desired. ■ 'Target' is destination for the backed up files. If given, it must be a drive or directory (no wild card characters). The default is the current directory on the default drive. If you give more than one source file specification, you MUST list a target, so Backup/2 can distinguish between source & destination files. ■ /A clears the archive flag on backed up files. OS/2 sets the archive flag whenever a file changes. ■ /G (stands for "globally") performs the same backup operation in every directory on the default drive. To back up only in the current & subordinate directories, use /GC. Don't use /G when the default drive is the target, or you may copy files into every directory on the default drive (unless, of course, that's what you want). ■ /V makes Backup/2 check disk volume labels before copying. A volume label is the disk name that appears when you give a DIR or VOL command. OS/2 can put a volume label on a disk when you format it, or when you give the LABEL command. Follow the /V with a drive letter & colon, then the volume label itself. If the volume label contains spaces or tabs, enclose the entire label & /V in double quotes. If you enter BU with no arguments, the program shows instructions on the correct usage syntax. Backup/2 squeezes the maximum possible number of files onto the target disk. If there isn't enough room on the target, some files may not be copied, but Backup/2 will continue, trying to find smaller files that WILL fit. As Backup/2 runs, it shows the files it's processing & whether or not it backed them up. To abort the program while it's running, press ^C or ^Break (hold down Ctrl & press C or Break). ┌───────────────────────────────────────────────────────────────┐ │ EXAMPLES │ └───────────────────────────────────────────────────────────────┘ Example 1 BU *.C D: /G This command backs up all files in the current directory with an extension of 'C' to drive D: ________________________________________________________________ Example 2 BU *.C B: /GC /VB:UTILS backs up all files in the current & subordinate directories with an extension of 'C' to drive B:. Backup/2 checks to see that the disk in drive B: has a volume label of 'UTILS.' ________________________________________________________________ Example 3 BU A:*.C A:*.H . "/VA:DEMO PROG" backs up files from the current directory on drive A: with extensions of 'C' or 'H', or a root name of 'SAMPLE.' Backup/2 checks to see that the disk in drive A: has a volume label of 'DEMO PROG.' It puts the copied files into the current directory on the default drive. ┌───────────────────────────────────────────────────────────────┐ │ SYSTEM REQUIREMENTS │ └───────────────────────────────────────────────────────────────┘ This program requires the OS/2 operating system, version 1.2 or later. It does not require the OS/2 Presentation Manager (PM), though you can run it in a PM window. ┌───────────────────────────────────────────────────────────────┐ │ EXIT CODES │ └───────────────────────────────────────────────────────────────┘ Backup/2 reports the following exit codes. You can query these with the ERRORLEVEL function in OS/2 batch files. 0 Operator aborted 1 No files were backed up (either there were none to do or an error occurred) 2 Some, but not all, files were backed up 3 All files were backed up successfully ┌───────────────────────────────────────────────────────────────┐ │ REVISION HISTORY │ └───────────────────────────────────────────────────────────────┘ 1.00 Original version 1.01 Optimized code to make program file smaller Fixed bug that caused program to not back up multiple filespecs correctly ┌───────────────────────────────────────────────────────────────┐ │ MESSAGES │ └───────────────────────────────────────────────────────────────┘ In the following messages, "source" is the file you're copying FROM, & target is the file (or drive) you're copying TO. Aborted as requested. You pressed ^C or ^Break, so Backup/2 stopped. Some, none, or all of the specified files may have been copied to the target drive. Copied to XXXX. File was successfully backed up. Copy failed - reason unknown. For some reason, OS/2 refused to copy the file. Perhaps another program is using it at present. Couldn't open source. Another program is probably using the file at this time. Try again later. Couldn't open target. Either the target disk has too many files on it, another program is using the file at this time, or something's wrong with the disk. Try again later. Couldn't read source. Another program is using the file at this time, or something's wrong with your disk. Try again later. Couldn't write target. Another program is using the file at this time, or something's wrong with your disk. Try again later. No files found. Backup/2 found no files meeting your specifications. No more search directories. Other programs are current using all of OS/2's file search resources. Try terminating some of the other programs or wait until they finish. Not enough room. There's still space on the target drive, but not enough for the file in question. The program will continue in case there are smaller files that will fit in the available space. Put disk with volume label XXXX in drive X. Put the requested disk in the drive. If you get this message even with the correct disk, abort with ^C & check to see that you used the correct volume label with /V. Make sure you typed it exactly as it appears on the disk, including embedded spaces. Target full. You can't back up anything else until you delete some files from the target drive (or use a different target disk). Target is read only. If you have my ATTRIBUTION program, use it to clear the target file's flags so Backup/2 can update it. Otherwise, see your local computer expert for a utility program that will do this. Target still current. The target file's date-time stamp is the same as or later than the source file's, so Backup/2 didn't need to copy it. This program cannot be run in DOS mode. Either you're using the MS-DOS or PC-DOS operating system, or you're in OS/2's DOS compatibility box. You must run Backup/2 under OS/2 & you may not be in the DOS compatibility box. Volume label incomplete. You used /V, but omitted the drive letter and/or colon. ┌───────────────────────────────────────────────────────────────┐ │ CREDITS │ └───────────────────────────────────────────────────────────────┘ Backup/2 was written in C by Richard W. Adams. It was developed with PC-Write, version 3.02, & the Microsoft C Optimizing Compiler, version 5.1. The author is a member of the Association of Shareware Professionals (ASP). You may reach him at the address given in REGISTER.DOC. Should that address no longer be valid, try contacting him through the ASP (545 Grover Road, Muskegon, MI 49442). He is also sometimes available on CompuServe (76430,1071). ┌───────────────────────────────────────────────────────────────┐ │ REGISTRATION │ └───────────────────────────────────────────────────────────────┘ Backup/2 is copyright 1991 by Richard W. Adams, all rights reserved. The program is "shareware." If you use Backup/2 for more than 30 days, you must register. To do so, complete the registration form in REGISTER.DOC & send it with a check for the indicated amount to the author at the address on the form. When you register, you receive: o The right to use your copy of Except on a single computer o FREE technical support by mail for three months o Eligibility for FREE copies of future versions if you're the first to suggest improvements or report bugs that are fixed/incorporated in future versions o A DISCOUNT if you subscribe to Shareware Magazine Not only is registration a legal & ethical requirement, but registration fees give shareware authors the incentive to develop new software & improve old ones. Tax exempt Christian religious organizations & churches are eligible for free registration of Backup/2 for official business. Send a written request to the author, & you'll receive registration forms. The registration takes effect when you complete & return the forms. This is a charitable donation. Companies, government agencies & other organizations may obtain site licenses for Backup/2, at greatly reduced unit costs. Contact the author for details & a price list. ┌───────────────────────────────────────────────────────────────┐ │ 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, others require it, and 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. 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. DISCLAIMER - AGREEMENT Users of Backup/2 must accept this disclaimer of warranty: "Backup/2 is supplied as is. The author disclaims all warranties, expressed or implied, including, without limitation, the warranties of merchantability and of fitness for any purpose. The author assumes no liability for damages, direct or consequential, which may result from the use of Backup/2." Backup/2 is a Shareware program and is provided at no charge for your evaluation. Feel free to share it with your friends, but please don't give it away altered or as part of another system. The essence of "user-supported" software is to provide personal computer users with quality software without high prices, and yet to provide incentive for programmers to continue to develop new products. If you find Backup/2 useful and continue to use it after a reasonable trial period, you must make a registration payment to the author. The registration fee licenses one copy for use on any one computer at any one time. You must treat this software just like a book. An example is that any number of people may use this software and may freely move it from one computer location to another, so long as there is no possibility of it being used at one location while it's being used at another. Just as two different people can't read a book at the same time. Commercial users of Backup/2 must register and pay for their copies of Backup/2 within 30 days of first use or their license is withdrawn. Site-License arrangements may be made by contacting the author. Anyone distributing Backup/2 for any kind of remuneration must first contact the author for authorization. This authorization will be automatically granted to distributors recognized by the (ASP) as adhering to its guidelines for shareware distributors, and such distributors may begin offering Backup/2 immediately. (However, you must still advise the author so the distributor can be kept up-to-date with the latest version of Backup/2.) You are encouraged to pass a copy of Backup/2 to your friends for evaluation. Please encourage them to register their copy if they find that they can use it. ┌───────────────────────────────────────────────────────────────┐ │ COPYING │ └───────────────────────────────────────────────────────────────┘ You may copy & distribute Backup/2 freely, as long as you: o Include all constituent files. o Don't change the software or documentation. o Don't distribute the program for commercial purposes without written permission from the author. o Don't rent or lease it. o Charge no fee other than a nominal one to cover distribution costs. ┌───────────────────────────────────────────────────────────────┐ │ OMBUDSMAN │ └───────────────────────────────────────────────────────────────┘ The author is a member of the Association of Shareware Professionals (ASP). ASP wants to make sure that the shareware principle works for you. If you can't resolve a shareware related problem with an ASP member by contacting the member directly, ASP may be able to help. The ASP Ombudsman can help you resolve a dispute or problem with an ASP member, but does not provide technical support for members' products. Please write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442 or send a CompuServe mail message to the ASP Ombudsman (70007,3536). _______ ____|__ | (R) --| | |------------------- | ____|__ | Association of | | |_| Shareware |__| o | Professionals -----| | |--------------------- |___|___| MEMBER