home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / CHEKV103.ZIP / CHEKDATE.DOC < prev    next >
Encoding:
Text File  |  1994-02-13  |  8.3 KB  |  260 lines
  1.  
  2.                        ________
  3.                    ____|__     |               
  4.                 --|       |    |-------------------
  5.                   |   ----|--  |  Association of
  6.                   |  |       |_|  Shareware
  7.                   |__|   o   |    Professionals
  8.                 -----|   |   |---------------------
  9.                      |___|___|    
  10.                         
  11.                              V1.03     
  12.     
  13.     
  14.     ********** CHECKDATE - File and/or FILES.BBS Manager **************
  15.  
  16.                  Written by Antonio  . Ortiz
  17.                  Concept by Rob Echler and Edward Tushar
  18.  
  19.                  C o p y r i g h t  (c)   1 9 9 4
  20.                         
  21.                                v1.02 
  22.  
  23. CheckDate, Copyright (c) 1994 by Antonio Ortiz, is being distributed 
  24. as Shareware. Under this concept you may use the SHAREWARE (unregistered) 
  25. version for a reasonable period of time for evaluation after which you 
  26. must either register your copy or discontinue  usage.
  27.  
  28. ===============================================================================
  29.                      
  30. Disclaimer:
  31.  
  32.      This program and other files associated with it are not 
  33.      guaranteed to be bug free or virus free.  We are not
  34.      responsible for any damages of any kind, including
  35.      profit losses and data loss, that relate directly or
  36.      indirectly to this program and files.  You may distribute 
  37.      this program, as long as it is in unmodified with all the 
  38.      files originally included.
  39.  
  40. ===============================================================================
  41.  
  42. What is Checkdate?
  43.  
  44.   Simply put, Checkdate will read user defined directories, check the file
  45. date to your system date, and delete those files that are so many days old.
  46. It will also remove that filename and description from your FILES.BBS 
  47. listing.  If a file is not in the specified directory, it will simply remove
  48. the listing from the FILES.BBS.  
  49.  
  50. It will also add files that are found in the directory but not listed in 
  51. the FILES.BBS file and add them for you.
  52.  
  53. A switch has been added to allow the users of Maximus BBS software to read
  54. the directories and number of days to delete directly from the "filearea.ctl"
  55. file.
  56. ===============================================================================
  57.  
  58. Why was it created?
  59.  
  60.   Two Sysops, Rob Echler and Edward Tushar, sat down and said they needed
  61. a program that could look at a certain directory and delete files that were
  62. so many days old.  This small beginning led to some minor improvements such
  63. as a configuration file to define the directory list, a log file so you know
  64. what was deleted and any other status messages, the ability to set the 
  65. number of days back to delete files, and the ability to remove the file and
  66. description from the FILES.BBS to keep it up to date!  
  67.  
  68. ===============================================================================
  69.  
  70. Requirements:
  71.  
  72.  * A computer
  73.  
  74.  * Files that need to be deleted
  75.  
  76. Simple!  You don't even need to have a BBS to use this program or a FILES.BBS!
  77.  
  78. ===============================================================================
  79.  
  80. Files Needed:
  81.  
  82.  * CHEKDATE.EXE  -  The executable program
  83.  
  84.  * CHEKDATE.CFG  -  The configuration file
  85.  
  86. ==============================================================================
  87. ======================NON-MAXIMUS BBS SETUP===================================
  88. The following configuration is for people that don't use MAXIMUS BBS software
  89. in the field "MAXI!" you must place a "N", then list the directories in the
  90. configuration file. This will also work on Maximus BBS software.
  91.  
  92. [SEE SAMPLE CONFIGURATION FILE]
  93.  
  94. NAME!(USE ALL CAPS WITH NO BLANK SPACES AT THE END)
  95. REGS!(USE ALL CAPS WITH NO BLANK SPACES AT THE END)
  96. LOGG!B:\ZBBS\LOG\CHEKDATE.LOG
  97. FILE!FILES.BBS
  98. MAXI!N
  99. DAYS DIRECTORIES...
  100. 10   B:\ZBBS\BBS1
  101. 15   B:\ZBBS\BBS1\BBS11
  102. 20   B:\ZBBS\BBS1\BBS12
  103. 25   B:\ZBBS\BBS2
  104. 30   B:\ZBBS\BBS2\BBS21
  105. 35   B:\ZBBS\BBS3
  106. 40   B:\ZBBS\BBS3\BBS31
  107. 45   B:\ZBBS\BBS3\BBS32
  108. 50   B:\ZBBS\BBS3\BBS33
  109.  
  110. Note there are NO spaces after the exclamation point (!) and the information
  111. following it!
  112.  
  113.  
  114. There has been a new feature added to the configuration file
  115. place the keyword [noadd] at the bottom of the file with a
  116. list of files you DO NOT want the /a (add) switch to add to
  117. the files.bbs file. A sample follows plus there is an example
  118. in the sample *.cfg files that come in this archive. 
  119.  
  120. [NOADD]
  121. FILES.IDX
  122. FILES.DMP
  123. FILES.DAT
  124.  
  125. ===========================MAXIMUS BBS SETUP==================================
  126.  
  127. The following setup is for users of MAXIMUS BBS software.
  128.  
  129. NAME!JOE SYSOP (USE ALL CAPS)
  130. REG!Your registration number
  131. LOGG!The complete path and name of your log file
  132. FILE!FILES.BBS <-- Do not change!
  133. MAXI!C:\MAXIMUS\FILEAREA.CTL (PATH AND NAME OF YOUR FILEAREA.CTL FILE)
  134. DAYS DIRECTORY 
  135.  
  136. You will need to make a entry in each area of your filearea.ctl file
  137. to tell CHEKDATE how many days old you wish the files in that directory
  138. to be. Here is an example of a filearea.ctl entry.
  139.  
  140. Area 1
  141.         FileAccess Disgrace
  142.         FileInfo Family Type Games
  143.         Download c:\max\file\games
  144.         Upload c:\max\file\uncheck
  145.         %%Days 45 <- this is the number of days you want.
  146. End Area
  147.  
  148. REMEMBER TO PUT TWO (%%) PERCENT SIGNS IN FRONT OF THE DAYS ENTRY.
  149.  
  150. The number of days old to delete the file THIS MUST BE IN EVERY AREA
  151. REGARDLESS OF HOW MANY DAYS YOU PLACE BEHIND IT.  
  152.  
  153. The default is 30 and can only be changed in the registered version.
  154.  
  155. Note there are NO spaces after the exclamation point (!) and the information
  156. following it!
  157.  
  158. Simple!  Now you are ready to run!
  159.  
  160. ===============================================================================
  161.  
  162. CHEKDATE can be ran with no command line parameters.  
  163.  
  164.  
  165. SWITCHES:
  166.  
  167.  
  168.  
  169.  /N OR /n 
  170.  
  171.  This will cause CHEKDATE to run through the directories without deleting any files.  Then you can check the created
  172. log file to see what files are going to be deleted, what problems are found
  173. in your FILES.BBS, and any files that are listed in your FILES.BBS but were
  174. not found in the directory.  
  175.  
  176. /Q OR /q
  177.  
  178.  This will cause CHEKDATE to run in quiet mode, nothing will be seen on 
  179.  your screen. 
  180.  
  181. /P or /p
  182.  
  183.  This will send all output to your printer.
  184.  
  185. /A or /a
  186.  
  187.  This will allow you to add files to the files.bbs that are in the directory
  188.  but not listed in the files.bbs file, it will append a description as
  189.  (NO DESCRIPTION GIVEN). Any files entered with this switch will have the file 
  190.  date reset to the current date, and will not be deleted until the number of days
  191.  listed in the filearea.ctl or chekdate.cfg.
  192.  
  193.  
  194. A sample batch file might be:
  195.  
  196. CLS
  197. CD\BBS
  198. CHEKDATE 
  199. RUNFB (To rebuild the File Database after changes are made to the FILES.BBS
  200. CD\MAILER
  201. MAILER
  202.  
  203. ===============================================================================
  204.  
  205. Now, about registering!
  206.  
  207. Simple, the registration cost for this program is $10.  The $10 will allow you
  208. to change the number of days you wish to delete files.  It will also give you
  209. a nice feeling inside.  
  210.  
  211. ===============================================================================
  212.  
  213. Future improvements:
  214.  
  215.  + Ability to read several different type BBS file listing formats
  216.  
  217. Really not much left to improve upon.  Suggestions are welcome!
  218.  
  219. ===============================================================================
  220.  
  221. Credits:
  222.  
  223. Rob Echler and Edward Tushar - their idea, my work!
  224.  
  225. Send suggestions or complaints to the address listed in the REGISTER.DOC
  226. that came with this program!
  227.  
  228. Thanks!
  229.  
  230. Antonio Ortiz
  231.  
  232.  
  233. ==============================================================================
  234. BUG FIXES and ADDITIONS
  235.  
  236. v1.01
  237.  
  238.    Added the support for the use of Maximus BBS Filearea.ctl file.
  239.    
  240.    Fixed attempting to delete files from a CDROM.
  241.    
  242.    Added the /A switch to allow adding of files that are already
  243.    in the directory to the files.bbs.
  244.  
  245. v1.02
  246.  
  247.    Fixed the bug allowing Maximus Users to use the backslash on the end
  248.    of the path line.
  249.  
  250.    Fixed the bug of using all comment lines in the filearea.ctl file.
  251.  
  252.  
  253. v1.03
  254.  
  255.    Fixed a small bug that made reading the filearea.ctl file impossable.
  256.    Added the feature to not add specified files to the files.bbs file.
  257.  
  258.  
  259.  
  260. ============================================================================