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