home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / bbs_opus / util170.arj / OFARE.DOC < prev    next >
Text File  |  1991-07-11  |  4KB  |  91 lines
  1.     OFARE
  2.  
  3. Opus 1.70 File Area REindexer
  4.  
  5. The purpose of this program is to re-index the database. When Opus
  6. adds new files to an area, the information for that file is added
  7. to the "overflow area" of the database. When a file is deleted, the
  8. entry in the database is not physically purged, it is just marked
  9. as deleted. Opus doesn't even expand wildcard names that occur in
  10. a file area anymore, because you can't put wildcard names in a file
  11. index.
  12.  
  13. In order to purge deleted files from the database, combine the
  14. information from the "overflow area", and to re-expand wildcard
  15. names, OFARE should be part of your regular maintenance. Of course
  16. Opus-FAM will also re-index the database.
  17.  
  18. If your filesbbs.ndx or filesbbs.adx files are grunged or lost, ofare
  19. has the capability of re-creating them. If you loose the filesbbs.dat
  20. file, too bad, you're in for a painful process. Backup frequently!
  21.  
  22.       allowable command line switches are:
  23.         /o  include orphan files
  24.         /m  exclude missing files
  25.         /q  quick mode (don't update file date/time/size)
  26.  
  27. Since Opus 1.70 allows the system dat files and the user file to be
  28. located in other than the Opus home directory, support has been added
  29. to look up these paths in the Opus prm file.
  30.  
  31. Set up an environment variable labelled OPUS, and specify
  32. the full pathname of the prm file, i.e.
  33. SET OPUS=H:\OP170\BBS.PRM (if your environment space is cramped,
  34. you may leave off the .PRM suffix, the program will add it).
  35. BTW, Doug and I are making the OPUS environment variable
  36. a standard for all the OPUS utilities. If you want the C source,
  37. just ask.
  38.  
  39. If the OPUS environment variable is not set, the program will look
  40. in the current working directory for USER.DAT and SYSMSG.DAT. If
  41. either file is not found, it will then look for BBS.PRM and look
  42. up the paths in there. If none of the above are found, the program
  43. will fail.
  44.  
  45. HOW TO CHANGE AREA NUMBERS (without losing a thing)
  46. ==========================
  47. What do you do when you want to move a file area to a different area
  48. number? For example you want to make your current games files area
  49. which is currently area 15 into area 88. First run uncon to take all
  50. the file descriptions for area 15 from the database and create an
  51. old style files.bbs file. Then edit your bbs.ctl file, changing file
  52. area 15 to file area 88. Run nacl which will create a new sysfile.dat.
  53. Then run ofare, which will see that area 15 has been deleted, and that
  54. area 88 is a new area, so it will merge the files.bbs for area 88 back
  55. into the database.
  56.  
  57.     John Valentyn 1:114/5@fidonet.org
  58.  
  59. Revision history:
  60. ver 9 2-27-91
  61. Added code to detect bad ptr left by Opus when it aborts while
  62. adding new files.
  63.  
  64. ver 10 3-17-91
  65. Fixed problem handing deleted record ptrs in overflow area.
  66. Changed logic so that the new database is built as temp files, leaving
  67. the old database and backup files intact in case Ofare aborts.
  68.  
  69. ver 11 3-26-91
  70. Supports new _numb_idx structure.
  71. Carries uploader name/date and download counts forward on wildcard files.
  72.  
  73. ver 14 5-4-91
  74. Fixes some minor problems when adding new area(s).
  75.  
  76. ver 15  6-16-91
  77. Fixes problem when the file areas in sysfile.dat are not in ascending
  78. numerical sequence.
  79. Somewhat speeded up disk i/o.
  80.  
  81. ver 16  7-4-91
  82. Some more fine tuning to speed it up.
  83. Fixed problem with priv levs in filesbbs.adx.
  84.  
  85. ver 17  7-9-91
  86. Fixed problem that reported FILESBBS.NDX not found, and aborting, instead
  87. of automatically rebuilding the file.
  88. Added code that will set the upload date/time to the file date/time if
  89. the file date/time is later than the upload date/time.
  90.  
  91.