home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / sigm / vol111 / backup.doc < prev    next >
Encoding:
Text File  |  1984-04-29  |  6.3 KB  |  106 lines
  1.             BACKUP.ASM   USED TO BACKUP HARD DISKS
  2.         WRITTEN BY G. YOUNG, PO BOX 3218, NO. HOLLYWOOD, CA 91609
  3.  
  4.     The Winchester hard disk offers file storage approaching mainframe
  5. performance on microcomputers.  The problem of backing up the data is
  6. a serious drawback, however.  The only option currently available is to
  7. use PIP to copy one file at a time.  To PIP an entire file type would
  8. quickly fill a floppy and not copy the rest of the files.  To PIP one
  9. file at a time would be unbearably time consuming.  Another alternative
  10. is obviously necessary. 
  11.      BACKUP is used to copy files from large volume hard disks to low
  12. volume floppy disks for backup and recovery purposes.  It is intended
  13. for CP/M files where the entire file will fit on one floppy disk. 
  14.       There are three phases in BACKUP.  The first phase reads the
  15. directories of all the hard disks, sorts the file names into alphabetical
  16. order within file type, and prints a master directory by type on the list
  17. device.  The program assumes drives A:, B:, and C:.  If there are more
  18. drives than this, change NODRV to the number of drives, change DRIVE
  19. to add in the extra drive letters, and reassemble. 
  20.      Next the program attempts to restrict the files it backs up.  Since
  21. a twentysix megabyte disk could take up to forty four double density
  22. floppy disks to completely back up, only essential files are saved.
  23. Duplicate files are eliminated saving only the file on the lowest
  24. drive (A: is saved if the file also exists on B: or C:).  The file
  25. is considered duplicate if the names are the same, the actual contents
  26. are not compared.  Certain file types are considered unnecessary and
  27. are not saved.  PRN, BAK, SYM, HEX, and TMP  are eliminated from the
  28. backup list.  To change this list of skipped file types, simply change
  29. the variable NOSKIP and SKIPFILES within the program and reassemble.
  30. Each file type will then be displayed on the console and the program will
  31. ask if you want to back up all of the files of this type (enter Y), skip
  32. all of the files of this type (enter N), or select certain files within
  33. this type (enter S).  If you enter S, each file name within the current
  34. type will be displayed on the console and the program will ask if you
  35. want to backup this particular file (enter Y), skip this file (enter N),
  36. or continue to backup all the rest of the files within this type without
  37. listing each name (enter C).  This feature is used to restart the backup
  38. if it was terminated before it completed during a previous run.  At
  39. this time you can also skip any files that will not fit entirely on  
  40. one disk.  The program will skip this file also if it encounters it, but
  41. it will prompt for a blank diskette to try the backup before it discovers
  42. that it cannot be backed up with this program.  When the list of files
  43. to backup has been reduced, the list will be printed and the program will
  44. ask if it should begin the copy procedure or abort.  This allows you to
  45. rerun if the list of files to backup is not correct. 
  46.      Finally, the backup procedure will begin.  The program uses all of
  47. RAM from the end of the file list table to the end of the TPA as the
  48. buffer for copying files.  As the files are finished being copied, the
  49. tabled is decreased and the buffer area is increased thereby speeding up
  50. the copy process.  The program will display a message asking to mount
  51. a floppy in the first drive (assumed to be D: but changable with the
  52. program) and enter a three digit disk id or "END" to terminate
  53. prematurely.  This may happen if you run out of diskettes!!!
  54. The first file that BACKUP writes on the floppy is a null file.  It
  55. has zero length so it only takes up one directory entry and no space on
  56. the disk.  This null file has the name equal to the eight character date
  57. listed on the reports and the file type is the three character disk id.
  58. The purpose of this file is to identify the disk against the directory
  59. listing and to automatically mark the date.  The
  60. heading line for an index report will then be printed on the list
  61. device showing the disk id and current date.  As the files are copied,
  62. the index report is created showing the files copied to each floppy.
  63. While the file is being copied, the file name will be displayed on the
  64. console.  When the file has been completely copied, the file name will
  65. be added to the index report.  If the file will not fit completely on
  66. the floppy, the file name will be deleted from the floppy directory, a
  67. new floppy requested, and the file recopied to the new floppy.  This
  68. process continues until the entire file name table has been processed
  69. using as many floppy disks as required. 
  70.      Restoring or recovering can be done with PIP.  You can PIP the
  71. entire floppy disk to the hard disk, or using the disk id/file name index,
  72. restore only certain files.
  73. When using PIP to copy any REL files back to the hard disk, be sure to
  74. use the OV option in PIP. 
  75.      The source code is provided in file BACKUP.ASM for your convenience
  76. in changing certain parameters for your installation.  The variables that
  77. may need to be changed are all on the first page of the source and are
  78. the following:  
  79. NODRV      This is the number of hard disk drives.  Set to 3 if you have
  80.            one hard disk named A: B: C:
  81. DRIVES     This is the letters for the drives to search.  Set to ABC if
  82.            you have one hard disk, and the hard disk is addressed before
  83.            any floppy disks.
  84. BACKUPDRV  This is the floppy drive letter that the backup will be copied
  85.            to.  Set to D if you have hard disk drives A B and C.
  86. NOSKIP     This is the number of file types in the file skip list.
  87. SKIPTYPE   This is the list of file types to skip.  It is normally set
  88.            to PRNHEXSYMBAK$$$TMP to skip those six file types.
  89. LINESPAGE  This is the number of lines per page and is used to print the
  90.            various directories.
  91. RECLINE    This is the number of file names that will appear on one line
  92.            in the directories.
  93.  
  94.  
  95.     The program uses the COMPUTIME board to get the date, but the code
  96. is in the program to request the date from the console.  Just remove
  97. the * in the columns to convert the code from comments if you do not have
  98. a clock board.
  99.      
  100. 6/23/82...RESTART CAPABILITY ADDED
  101. BY ENTERING BACKUP FILENAME.TYP THE PROGRAM WILL SKIP THE CROSSREFERENCE
  102. REPORT AND POSITION THE LIST TO FILENAME.TYP AND REPROMPT FOR FILES TO
  103. BACKUP FROM THAT POINT.
  104.     EXAMPLE A>BACKUP LOAD.COM
  105.  
  106.