home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / sysutl / egutil53.lbr / BBCAT.DZC / BBCAT.DOC
Encoding:
Text File  |  1988-07-12  |  6.5 KB  |  149 lines
  1. ;;07-18-85
  2.  
  3.                          BBCAT.DOC v1.3
  4.                             11/09/85
  5. Eric Gans
  6. French Dep't UCLA
  7. Los Angeles, CA 90024
  8.  
  9. Version 1.3
  10. More informative command-line prompt.
  11.  
  12. Version 1.2
  13. Allows  command-line entry of catalog name,  asks before creating 
  14. new CAT,  doesn't save empty catalog.   Fixed a couple of bugs in 
  15. BBCAT and BBACK (now v6.2).  We're getting there!
  16.  
  17. Version 1.1
  18. Allows prompt for catalog entry/erase from disk.   Checks for bad 
  19. write of catalog file.  
  20.  
  21.                               *****
  22.  
  23.      BBCAT   is   a   catalog   program   integrated   with    my 
  24. archive/dater/backup utility BBACK (6.22) to provide a convenient 
  25. way  of  keeping  track  of backed up files  and  of  eliminating 
  26. duplicates.   Unlike NCAT,  UCAT et al.,  which are meant chiefly 
  27. for  the floppy-disk user,  BBCAT is designed primarily for those 
  28. with hard disks who only use floppies for back-up and storage.  
  29.  
  30.      The  catalog  entries  created by BBCAT  include  the  date, 
  31. either  as entered by BBACK or as taken from CAL (which should be 
  32. in  A0:  and kept up to date).   When BBACK backs up a  file,  it 
  33. looks for a catalog file of type BB*.CAT in the current user area 
  34. and adds the backups to the catalog,  changing the date for files 
  35. already  backed  up on the same disk.  Both BBACK and BBCAT  will 
  36. allow you to create a catalog file (default name BB0.CAT) if they 
  37. don't find one; you can rename this file as you please within the 
  38. limits  of the BB*.CAT filespec.  BBACK will also remind  you  of 
  39. duplicate backups. 
  40.  
  41.      You  are encouraged to keep different CAT files for types of 
  42. files  that  you back up on different (sets  of)  floppies:  just 
  43. don't keep more than one in the same drive/user area.
  44.  
  45.      BBCAT  will  catalog only floppies inserted in  the  default 
  46. backup  drive (byte at 102H: 3=C: BBDEF 1.2 can change  this  for 
  47. you  at the same time as the equivalent byte in BBACK).  You  are 
  48. asked  for a file mask before cataloguing, and you can choose  to 
  49. be prompted for each entry; in this option, files not entered  in 
  50. the  catalog can if you wish be deleted from the  diskette.   You 
  51. may  also delete files from the catalog (and if you like,  delete 
  52. them from the floppy at the same time). BBCAT also permits you to 
  53. renumber  your  disks; it will change all  the  appropriate  file 
  54. entries. If you use an unnumbered disk with BBACK it will give it 
  55. number  255;  you  will probably want to change this  to  a  more 
  56. reasonable number with BBCAT.
  57.  
  58.      All  these  features make it easy to keep a  record  of  the 
  59. dates  of  all your backups and the disks where they  are  found.  
  60. This  should sharply reduce the number of floppies you need  keep 
  61. active for backup purposes.  
  62.  
  63. Command line: bbcat <BBfn>  or bbcat
  64.  
  65. If  you enter a catalog name (you don't have to enter the  .CAT), 
  66. BBCAT  will search for it & if not found or zero-length,  ask  if 
  67. you want to create it.  If you don't include a name,  BBCAT  will 
  68. search  the current drive/user for BB*.CAT and if it doesn't find 
  69. a CAT file will let you create BB0.CAT.
  70.  
  71. BBCAT Commands
  72.  
  73. C = Catalog
  74.  
  75. You  will be asked to insert a disk and to give a  file-mask  for 
  76. the files you want to catalog.  If you choose to be prompted  for 
  77. individual  file  entries,  you will be asked whether  files  not 
  78. entered in the catalog should be deleted from the disk.  All user 
  79. areas  of  the  floppy will be searched  for  appropriate  files; 
  80. duplicate  entries (same file,  date & disk) will be indicated on 
  81. screen but not entered in the catalog.  The date within the  file 
  82. will be displayed according to BBACK format (mm-dd-yy);  if there 
  83. is  none,  the current date (from CAL.COM) will be entered in the 
  84. catalog.  You  should use this command chiefly to enter your  old 
  85. disks in the system; afterward, it is advisable to let BBACK take 
  86. care of recording new backups in the catalog.
  87.  
  88. L = List
  89.  
  90. All  files  in the catalog that match the  filemask  and/or  disk 
  91. number you enter (default=all) will be listed alphabetically. The 
  92. date and disk number will be shown for each file;  the number  of 
  93. files listed and the total number in the catalog will be given.
  94.  
  95. P = Print
  96.  
  97. This  command will send the results of the "List" command to  the 
  98. printer,  along with a heading giving the catalog name, filemask, 
  99. disk number (if any) and date.
  100.  
  101. E = Erase
  102.  
  103. The  display  is that of the List command.   You  are  given  the 
  104. option  of deleting the files from a diskette at the same time as 
  105. they are removed from the catalog;  otherwise you may search  the 
  106. entire catalog for erasure.  The disk-erase option should be used 
  107. whenever  possible since it keeps your floppies and your  catalog 
  108. in sync.
  109.  
  110. NB  - If you use the disk-erase option it is a good idea to  list 
  111. the  files  from  other  disks as well  so  you  can  check  your 
  112. duplicates.
  113.  
  114. R = Renumber diskette
  115.  
  116. You will be prompted for the (new) number.  A number file will be 
  117. created  on the floppy (any existing number file will be deleted) 
  118. with  format  -[date].num where [date] is the  current  date  and 
  119. "num" is a number between 1 and 255.  Thus for disk #1 on July 4, 
  120. 1985,  BBCAT would create the file -070485.001.   Unlike most CAT 
  121. programs,  BBCAT  will  not make separate entries  for  different 
  122. number  files  with the same last three digits.   This  makes  it 
  123. simple  to  (re)name number files to reflect the contents of  the 
  124. diskette;  just  keep the leading "-" and the three digits  after 
  125. the  "." All relevant catalog entries will be changed to the  new 
  126. number.
  127.  
  128. Q = Quit
  129.  
  130. If changes have been made to the catalog, it will be rewritten to 
  131. disk and a BAK file made of the old catalog.  
  132.  
  133. Since  both BBACK and BBCAT create a (renamable) default  catalog 
  134. BB0.CAT if no catalog is found in the current user area and BBCAT 
  135. allows you to create your own catalog name,  there is no need for 
  136. the user to create BB*.CAT files. If you do so, save a one-sector 
  137. file the first two bytes of which contain binary  zeroes.  (These 
  138. bytes hold the count of files in the catalog.)
  139.  
  140. Catalog entries occupy 16 bytes:  11 for the filename,  2 for the 
  141. date, 1 for the disk number and 2 for a pointer to the next file.  
  142. The entries are not sorted alphabetically but are alphabetized by 
  143. means of a linked list.   To save space, non-ascii characters are 
  144. used, so you should only list or print the catalog with BBCAT.
  145.  
  146.  
  147. As always,  I would appreciate your suggestions for enhancements, 
  148. fixes, etc. 
  149.