home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / utils / sysutl / egutil53.lbr / BBACK.DZC / BBACK.DOC
Encoding:
Text File  |  1988-07-12  |  10.5 KB  |  236 lines
  1. ;;07-18-85
  2.                         BBACK.DOC v.6.22
  3.                             11/09/85
  4. Eric Gans
  5. French Dep't UCLA
  6. Los Angeles, CA 90024
  7.  
  8. Version 6.22
  9. Versions 6.21 and 6.22 correct bugs in the catalog rewriting rou-
  10. tine in v6.2.  No other bugs have been found recently...
  11.  
  12. Version 6.2
  13. Allows  option of creating/using catalog;  changed syntax to  use 
  14. switches.  Fixed  a  couple of (smaller!) bugs  in  date,  error, 
  15. number-reading routines.
  16.  
  17. Version 6.1
  18. Fixed  a  number  of serious bugs in v6.0 in  reading  the  date, 
  19. rewriting  the  catalog  file to  disk,  checking  for  duplicate 
  20. backups,  etc.  Added output of the catalog  file-name  & changed 
  21. a few messages.  BBACK, like BBCAT, now makes a BAK  file if  the 
  22. catalog is changed.  CAL v1.4 no longer includes specific Kaypro-
  23. 10 graphics commands.  Also updated BBDEF (v1.2).
  24.  
  25. Version 6.0 
  26. Enters  backups/dates  in catalog.  Eliminated LBR dating  option 
  27. because of CRC library directory errors. 
  28.  
  29. [previous  version  information has been eliminated  for  greater 
  30. readability]
  31.  
  32. <<<  NB >>> The COM files in this library are named with  version 
  33. numbers  to  avoid confusion with other versions.  These  numbers 
  34. should be removed from the names before use; BBDEF will work only 
  35. with  files  named BBACK and BBCAT (not BBACK62  etc.),  and  CAL 
  36. rewrites  itself  to  disk  as  CAL.COM  and  will  not  work  as 
  37. CAL14.COM.
  38.                                ***
  39.  
  40.      The  backup program BBACK.COM was inspired by an  inaccuracy 
  41. in Johnson-Laird's "Programmer's CP/M Handbook," p. 26: "the File 
  42. Changed bit (bit 7 of byte 11) is always set to 0 when you  close 
  43. a  file to which you have been writing."  Unfortunately, in  CP/M 
  44. 2.2 it isn't.
  45.  
  46.      Thus to use BBACK correctly, you must first modify your BDOS 
  47. to reset this bit whenever a file is closed. Check the  addresses 
  48. in the included patch ARCH.AZM, assemble it with a Z80 assembler, 
  49. and  load the HEX file with SID, DDT, MLOAD etc. along  with  the 
  50. file  (most often called SYSGEN) that contains a memory image  of 
  51. the  BDOS.  (On the Kaypro-10 this file  is  called  PUTSYS.COM.)  
  52. After patching, execute the file and its contents will be written 
  53. to  the  system tracks of your disk. If you have  CP/M  v.3,  you 
  54. can skip this procedure.
  55.  
  56.                             Commands
  57.  
  58.  Format 1: bback [d1:]fn.ft [>d2] [/nu] (*? ok in fn.ft)
  59.  
  60.  d1  is the drive to back up (default: current drive)
  61.  
  62.  d2 is the drive on which the backup will be made. The default is 
  63. set to C:  (floppy drive on the Kaypro-10);  it can be reset with 
  64. BBDEF.
  65.  
  66.  fn.ft  can (and usually does) contain wildcards
  67.  
  68. Switches:
  69.  
  70. N  =  Don't  catalog backups (for users who  want  to  use  BBACK 
  71. without  its  cataloguing feature,  or for files you  don't  want 
  72. included in your catalog).
  73.  
  74. U  (formerly  "#") = Search all user areas.   If this  option  is 
  75. used,  the  files will be copied to their  repsective  user areas 
  76. on the backup disk;  thus if you have two copies of the same file 
  77. in different user areas they will remain separate.
  78.  
  79.  
  80. Examples:   bback c:*.zap >d /n | bback urk.* | bback  a:*.*   >c      
  81. bback z*.* /u
  82.  
  83.  
  84.  Format 2:   bback [d1][>][d2] [/nu] (the '>' is needed if EITHER 
  85. d1  or d2 is present.)
  86.  
  87. You  will be prompted for filetypes to be backed up.  The  format 
  88. for this entry is: >>ft1;ft2;ft3... (max 127 chars)
  89.  
  90.  Wildcards are permitted; enter a space for blank filetype. 
  91.  
  92. Example: >>zap; ;s*;??z will  back up files:  *.zap |  *.  (blank 
  93. file-type)  |  *.s??   | *.??z  If you used the /u switch in  the 
  94. command line, they will be searched for in all user areas of  the  
  95. selected drive.
  96.  
  97.      After  copying the file,  BBACK will set the archive bit  of 
  98. the  original (not the backup) file.  The next time BBACK is run, 
  99. it will not copy the file if the archive bit is set. If you patch 
  100. your BDOS with ARCH.AZM, CP/M will reset the archive bit whenever 
  101. the file is closed (which presumes it has been written to).  Thus 
  102. BBACK  permits  you to back up sets of files  without  having  to 
  103. recall which ones have been written to since the last backup.  In 
  104. conjunction with BBCAT, it provides an automatic file-dating  and 
  105. cataloguing  system  that requires you only to keep  the  current 
  106. date in CAL.COM. 
  107.  
  108.                           Catalog entry 
  109.  
  110.      This   feature  requires  no  extra input  from  the   user.  
  111. Unless  you use the "N" switch,  BBACK will  look  for a  catalog 
  112. file of form BB*.CAT on the  user  area from  which it is called, 
  113. and will prompt you to create BB0.CAT if it fails  to find   one.  
  114. (This  file  can be renamed as you  please  within   the  BB*.CAT  
  115. filespec.)    The  catalog  requires  disks   to   contain    the 
  116. traditional  -*.nnn  (0  < nnn < 256) number  file,  but  if  you 
  117. haven't  numbered your backup disk BBACK will number it  255  (if 
  118. you  use two disks, the second will be numbered 254,  etc.).  The 
  119. format of the number file is -+RENUM+.nnn; the point of the  name 
  120. is to remind you to renumber the disk. BBCAT can do this and will 
  121. also  renumber  all  affected catalog  entries.  Catalog  entries 
  122. include  the date and the disk number; if you back up a  file  on 
  123. the same disk the catalog entry will be updated (not duplicated). 
  124. When BBACK copies a file it outputs a list of previous backups; a 
  125. backup  on the same disk is indicated by "=".  Since  BBACK  only 
  126. eliminates  old  backups  by overwriting,  you should  keep  your 
  127. catalog current by not backing up the same file in different user 
  128. areas of a diskette.  I suggest you create separate catalogs  for 
  129. groups  of  files  you  back up on different  sets  of  floppies. 
  130.  
  131. Automatic cataloguing makes it much easier to keep track of  your 
  132. backups  and  to  eliminate duplicates.  Aside  from  the  dating 
  133. feature,  BBCAT  allows  greater  user control  over  file  entry 
  134. (including  renumbering of disks and selective entry/deletion  of 
  135. files)  than  other catalog programs.  Please see  BBCAT.DOC  for 
  136. further details.
  137.  
  138.                          Dating feature
  139.  
  140.      BBACK  expects to find CAL.COM in user area A0,  and  copies 
  141. the  date (presumably current) stored in that file.  In order  to 
  142. date  your  files (both the original and the  backup  copy),  two 
  143. formats are used:
  144.  
  145. - For  MBasic files (including ASCII .BAS files) the  first  line 
  146. must begin: 0 REM xxxxxxxx
  147.   I usually put: 0 REM xxxxxxxx <-- last modified
  148.   The date will be entered in the place of the 8 x's.
  149.  
  150. - For text files,  the first two bytes of the file must be ;;  or 
  151.  
  152. WordStar/NewWord  and  will  not  show up in  printouts  or  line 
  153. counts.  You must put a hard <cr> after the date.) The date  will 
  154. occupy  the  next  eight  bytes.  (See this file  itself  for  an 
  155. example.) You should enter eight spaces after the ;;  or ..  (the 
  156. easiest thing is to enter:  ;;xxxxxxxx<cr>);  otherwise the  date 
  157. will replace whatever is in the eight bytes following the ;;.  If 
  158. CAL.COM is not present, BBACK will enter the date 01-01-80.
  159.  
  160. LBR file dating has been eliminated, since NULU and other library 
  161. utilities  interpret changes in the directory as CRC errors.  You 
  162. should still include a date file in all libraries. CAL.COM  makes 
  163. a daily -mm-dd-y.y## file for this purpose. 
  164.  
  165.                   Customizing Default Settings
  166.                          BBDEF.COM v1.2
  167.  
  168. The  original default settings are found in the first  sector  of 
  169. BBACK  and BBCAT. You can use BBDEF to change them; you  will  be 
  170. prompted  for entries. (Warning: DO NOT use BBDEF 1.0 with  BBACK 
  171. 5.1+;  BBDEF  1.1 will work with BBACK 6.2, but will  not  modify 
  172. BBCAT.) BBCAT and BBACK must be renamed as such (not BBCAT12 etc) 
  173. for BBDEF to work.
  174.  
  175. ADDR      Decription         Setting 
  176.  
  177. 102H = Highest drive (a=1)      3   (=C:)
  178. 103H = Default backup drive     3   (=C:)      
  179. [104H = MAXFL                   16  (for a 60K system)]
  180.  
  181. 102H in BBCAT = Def back dr     3   (C:)   
  182.  
  183. MAXFL is no longer used in v6.1+, as the catalog must be  written 
  184. into memory as well.  Figuring 1000 files in the catalog (=16 K), 
  185. plus  8.5 K for BBACK + the operating system,  you will have room 
  186. for  about 1300 new files in a typical 60 K system (12 bytes  per 
  187. file  for  BBACK's file table,  plus 16 more for the new  catalog 
  188. entry).  To  be on the safe side, BBACK now gives  you  an  error 
  189. message if you enter more than 1024 files at one time: not a very 
  190. severe constraint!
  191.  
  192.                               Notes
  193.  
  194. - BBACK uses the entire free memory area as its file buffer.  The 
  195. catalog  file  is  written  into memory above  the  file  buffer; 
  196. catalog  entries take 16 bytes per file.   Even if you have  2000 
  197. entries in your catalog,  there is still room for something  like 
  198. 800 new entries on 60 K systems.
  199.  
  200. - The filetype buffer is 127 bytes long (30+ filetypes).
  201.  
  202. - To  abort  the program while copying,  type any  key.  It  will 
  203. terminate when the current file has been backed up.
  204.  
  205. - If the backup diskette (or its directory) is full,  BBACK  will 
  206. prompt you to insert another diskette to continue its operation.
  207.  
  208. - The  DMA is kept at 80h.  This means a lot of disk activity  if 
  209. you  use BBACK to copy files from one side of a hard disk to  the 
  210. other; but that's not the normal way to make backup files, is it?
  211.  
  212. RDATE.COM v1.1
  213.  
  214. This program reads the date from files backed up with BBACK.  
  215.  
  216. Format:  rdate [d:]fn.ft Wildcards are accepted. If rdate [d:] is 
  217. entered alone,  all files except COM files are included. The file 
  218. table holds a maximum of 69 files (one screen full in 3 columns). 
  219. This  utility  allows  you to examine the  dates  of  your  files 
  220. without having to access them individually.  Although BBACK v6.0+ 
  221. no longer enters the date in LBR files, RDATE will still read the 
  222. date from datefiles that use CAL format (-mm-dd-y.y##).
  223.  
  224. CAL.COM v1.4
  225.  
  226. This  little  calendar  program is  self-explanatory.  You  enter 
  227. "N(ext)" once a day to keep the date current,  "C" to change  the 
  228. date to something other than the next day, and "S" if the date is 
  229. unchanged.  If you change the date, CAL will create a zero-length 
  230. file  -mm-dd-y.y##  (and  erase any previous such file)  for  the 
  231. purpose of dating libraries,  etc.   For use with BBACK, CAL must 
  232. be kept in A0.  The current version of CAL will work for the 20th 
  233. century  only;  an update will be issued in 1999 (if I live  that 
  234. long).  The Kaypro-10 graphics included in previous versions have 
  235. been removed from v1.4 out of sympathy for non-Kaypro users.
  236.