BU -- Backup Utility - Version 1.0 - 12/08/1984 by Kim Levitt (based on NEWBACK by G. Young) changes at a glance: v1.2 improved top-of-form, compressed or normal printing, no need to send printer escape sequences. Added RBYANC support, if desired. v1.1 file attributes kept, erase RO files on destination,VT100 code, 'K left' routine. More exclude files added. ******************************************************************************** BU Version 1.2 01/15/85 - Greg Teater Digital Equiment Corporation 6400 E. Broad St. Columbus, Ohio 43213 614-868-1900 x264 Installed top-of-forms for printer where needed. Added left print margin to allow copy to be put in notebook (very handy). If RBYANC support chosen, then second filename added to output disk, '--BACKUP.nnn' where nnn is the volume ID asked during BACKUP. This will avoid using the first file name added '+YYMMDDy.nnn' where YY=year, MM=month, DD=day, YY=output drive letter, and nnn=volume ID. RBYANC does not include a volume delete feature. If you use the volume date file as volume label, the MAST.CAT will fill up very quickly. The second volume label is always the same, therefore they no new volumes are created each time the BACKUP floppies are added to catalog. This feature is in BU4.COM. The BU-V12.LBR includes the source v1.2, this document file and BU?.COM files. They are described below: BU1.COM Normal Printing (66 lines/page, 80 columns). No escape sequences sent to printer. Most generic version. BU2.COM Compressed Printing (88 lines/page, 132 columns). Printer must be setup before running BU2.COM. BU3.COM Features of BU2.COM plus will send DEC standard escape sequences for 8 lines/in and a pitch of 16.5 char./in BU4.COM Features of BU3.COM plus RBYANC volume label support ** NOTE ** The printer set routine can be easily modified for other printers. The sequences are close to the top of BU.ASM. Be sure to set the 'PRNTSET' flag to 'YES' and enter the code at 'SETPRINTER' label. ******************************************************************************* BU Version 1.1 01/01/85 B.Eiben (EIBEN at DEC-MARLBORO) Changed BU to keep file-attributes, when moving files to floppy - makes it easier to use NSWEEP to restore. Changed ERASE algorithm to allow to wipe files with attributes. Changed SPACE-routine and added " K left" output to screen to know, how long the specific floppy might last. Added some more "excluded" file-types and VT100 as the "default terminal". - Thanks for a GOOD and FAST Backup-utility! ******************************************************************************* BU.COM is a simple, but effective hard disk backup utility. It will back up most hard disk systems without any need for a modification of the .ASM source code (although it has been provided if you need to change). Location 103H in the .COM file contains a ten byte area that contains your terminal's clear screen control code or escape sequence, if your clear screen/home cursor is something other than a Ctrl-Z (1AH) then you will have to patch this. Location 10DH has the number of file types which you wish to have excluded from backup, the file is currently configured to skip 7 different filetypes which are stored in memory location 10EH: PRN,HEX,SYM,BAK,$$$,TMP,BAD,NAM When you run BU, it will ask you first which drives you wish to backup. Specify these altogether with no spaces, commas or other separating characters as in: "ABC". It will then ask for the floppy drive to backup to. Specify just the drive letter with no colon on the end as in: "D". After displaying this information, you will be asked to verify it before continuing. Next you will be asked if you wish all user areas backed up. Answer 'Y' if you wish user areas 0-15 automatically scanned. If you specify 'N', you will only scan the user area you are currently in. The following question concerns whether or not you wish files with the "F4" (a file attribute bit supported under CP/M) bit to be skipped during backup. This feature can be used so that you will only backup new files (ones that haven't had the F4 bit set by BU or some other utility such as NSWP which can set or reset the F4 attribute bit). The next prompt asks whether you want the F4 bit set after backup (normally yes, but you may not want to set the bit for some reason.) Finally, you are prompted for the current date which you must enter in using the "MM/DD/YY" format. If your system has a realtime clock, you may be able to write a routine to get the date and/or time for display on the reports without prompting you, but this requires modification of the source code, of course. After these preliminary questions, the hard disk directories are scanned, duplicates are eliminated from the list, a report listing sorted by disk/user is printed out and then the user is asked whether or not to begin the backup process. Answer 'Y' to continue and then you will be prompted to enter the first floppy volume for backup and enter a 3 character volume ID. The backup process begins and you will be prompted to change diskettes whenever the disks fill up and/or the hard disk being backed up changes (to facilitate restoring files it is recommended that different drives be backed up on separate floppies). As each file is backed up, its filename is printed on the printer (you DO have to have a printer on-line to use this program or it may hang up) as part of a report listing files backed up by diskette. At each prompt for a new diskette, you can enter "END" to abort the backup process. Provided you are skipping files with the F4 bit set and setting the F4 attribute after backup, you should be able to resume backup later and skip all the files you previously backed up. Before beginning a complete disk backup session, you can either just specify that F4 files are NOT to be skipped or you can clear the F4 bit on all the files you will want to backup before running BU (use NSWP for this purpose). Note that if you are not skipping F4 files, you will not be able to resume backup after aborting, so a "noskip" backup has to be done all at once. (I do a weekly "noskip" backup to get EVERYTHING and a daily or so "skip" backup to get only the new stuff..) After all files selected for backup have been copied to disk, BU will automatically terminate. NOTE: BU will skip files which are too large to be backed up onto a single floppy. Unlike some other backup programs, this is strictly file-oriented, which leaves you large-file people without backup via this program, but the advantage is that it is easy to restore files without doing a complete restore of EVERYTHING like some other PD hard disk backup programs do. Hope you enjoy using BU, oh yeah, P.S. I assume you run this on a CRT or console monitor, as it uses backspaces and overwriting which would look real funny on a printer and may wear holes in the paper during backups!!! (The printer reports which go to the LST: device are OK, of course, just the console displays get a little fancy..) If you find any bugs you want to fix or want to improve this baby, go ahead and feel free, but try to keep the hardware specific stuff out of BU itself, (I will release some RTC routines later which can be included in the .ASM file in the GETDATE area), and try to keep it "universal". Ideas for enhancements: CRC check with CRC displayed on floppy-report and CRC verification of backup file. I would add the code but I don't have time (have to work on MBBS). Of course, the added code would reduce the size of the TPA space available for the sort table, which might be a problem, so maybe it's just as well kept simple, short, sweet and fast.. (A verifying backup program would take more than twice as long to run, but would, of course be nice to have as an OPTIONAL feature.) Try to keep the user interface (prompts and displays) looking clean. Pass along any updates to my RCP/M: MBBS Headquarters RCP/M; (213) 653-6398 (300/1200). If you appreciate this program, I would appreciate a donation of $10 or more to support my public-domain software efforts as well as my RCP/M. Send your donations to: Micro Bulletin Board Systems; 8033 Sunset Blvd., #975; Los Angeles, CA 90046. (Make checks payable to "Micro Bulletin Board Systems".) Thanks -- -- Kim Levitt -- 12/08/84 MBBS HQ RCP/M (213) 653-6398