home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / BBS_UTIL / CHEKV104.ZIP / CHEKDATE.DOC < prev    next >
Text File  |  1994-04-03  |  10KB  |  332 lines
  1.  
  2.                        ________
  3.                    ____|__     |               
  4.                 --|       |    |-------------------
  5.                   |   ----|--  |  Association of
  6.                   |  |       |_|  Shareware
  7.                   |__|   o   |    Professionals
  8.                 -----|   |   |---------------------
  9.                      |___|___|    
  10.                         
  11.                              V1.04     
  12.     
  13.     
  14.     **************** CHECKDATE - File 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.04 
  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. ===============================================================================
  77.  
  78. Files Needed:
  79.  
  80.  * CHEKDATE.EXE  -  The executable program
  81.  
  82.  * CHEKDATE.CFG  -  The configuration file
  83.  
  84. ======================NON-MAXIMUS BBS SETUP===================================
  85. The following configuration is for people that don't use MAXIMUS BBS software
  86. list the directories in the configuration file. This will also work on 
  87. Maximus BBS software.
  88.  
  89. [SEE SAMPLE CONFIGURATION FILE]
  90.  
  91. [CONFIG]
  92. NAME=(NAME HERE IN ALL CAPS
  93. REGS=(REGISTRATION NUMBER
  94. LOGG=C:\BBS\BBS\LOG\CHEKDATE.LOG
  95. FILE=FILES.BBS
  96. [DAYS/DIRS]
  97. 10   C:\BBS\ZBBS\BBS1\
  98. 15   C:\BBS\ZBBS\BBS1\BBS11\
  99. 20   C:\BBS\ZBBS\BBS1\BBS12
  100. 25   C:\BBS\ZBBS\BBS2\
  101. 30   C:\BBS\ZBBS\BBS2\BBS21
  102. 35   C:\BBS\ZBBS\BBS3\
  103. 40   C:\BBS\ZBBS\BBS3\BBS31
  104. 45   C:\BBS\ZBBS\BBS3\BBS32
  105. 50   C:\BBS\ZBBS\BBS3\BBS33
  106. [NOADD]
  107. FILES.DAT
  108. FILES.DMP
  109. FILES.IDX
  110. [REMARKS]
  111. THIS MUST BE PLACED JUST PRIOR TO THE [END] STATEMENT.
  112. [END]
  113.  
  114.  
  115. Note MAY MAY EMPTY spaces after the equals sign (=) and the information
  116. following it!
  117.  
  118.  
  119. There has been a couple new features added to the configuration file
  120. place the keyword [noadd] at the bottom of the file with a
  121. list of files you DO NOT want the /a (add) switch to add files to
  122. the files.bbs file that are in the directory, but not in your
  123. file.bbs file. A sample follows plus there is an example
  124. in the sample *.cfg files that come in this archive. 
  125.  
  126. [NOADD]
  127. FILES.IDX
  128. FILES.DMP
  129. FILES.DAT
  130.  
  131. ========================= SPITFIRE SETUP ===============================
  132. The following configuration is for people that use SPITFIRE BBS software
  133. list the directories in the configuration file. 
  134.  
  135. [SEE SAMPLE CONFIGURATION FILE]
  136.  
  137. [CONFIG]
  138. NAME=(NAME HERE IN ALL CAPS
  139. REGS=(REGISTRATION NUMBER
  140. LOGG=C:\BBS\BBS\LOG\CHEKDATE.LOG
  141. FILE=SFFILES.BBS
  142. [DAYS/DIRS]
  143. 10   C:\BBS\ZBBS\BBS1\
  144. 15   C:\BBS\ZBBS\BBS1\BBS11\
  145. 20   C:\BBS\ZBBS\BBS1\BBS12
  146. 25   C:\BBS\ZBBS\BBS2\
  147. 30   C:\BBS\ZBBS\BBS2\BBS21
  148. 35   C:\BBS\ZBBS\BBS3\
  149. 40   C:\BBS\ZBBS\BBS3\BBS31
  150. 45   C:\BBS\ZBBS\BBS3\BBS32
  151. 50   C:\BBS\ZBBS\BBS3\BBS33
  152. [NOADD]
  153. FILES.DAT
  154. FILES.DMP
  155. FILES.IDX
  156. [REMARKS]
  157. THIS MUST BE PLACED JUST PRIOR TO THE [END] STATEMENT.
  158. [END]
  159.  
  160.  
  161. Note MAY MAY EMPTY spaces after the equals sign (=) and the information
  162. following it!
  163.  
  164.  
  165. There has been a couple new features added to the configuration file
  166. place the keyword [noadd] at the bottom of the file with a
  167. list of files you DO NOT want the /a (add) switch to add files to
  168. the files.bbs file that are in the directory, but not in your
  169. file.bbs file. A sample follows plus there is an example
  170. in the sample *.cfg files that come in this archive. 
  171.  
  172. [NOADD]
  173. FILES.IDX
  174. FILES.DMP
  175. FILES.DAT
  176.  
  177.  
  178. ===========================MAXIMUS BBS SETUP==================================
  179.  
  180. The following setup is for users of MAXIMUS BBS software.
  181.  
  182. [CONFIG]
  183. NAME=
  184. REGS=
  185. LOGG=C:\BBS\ZBBS\LOG\CHEKDATE.LOG
  186. FILE=FILES.BBS
  187. MAXI=C:\BBS\ZBBS\FILEAREA.CTL <-- THIS LINE MUST BE ADDED. 
  188. [NOADD]
  189. FILES.DAT
  190. FILES.DMP
  191. FILES.IDX
  192. [REMARKS]
  193. This must come just before the [END] statement.
  194. [END]
  195.  
  196. You will need to make a entry in each area of your filearea.ctl file
  197. to tell CHEKDATE how many days old you wish the files in that directory
  198. to be. Here is an example of a filearea.ctl entry.
  199.  
  200. Area 1
  201.         FileAccess Disgrace
  202.         FileInfo Family Type Games
  203.         Download c:\max\file\games
  204.         Upload c:\max\file\uncheck
  205.         %%Days 45 <- this is the number of days you want.
  206. End Area
  207.  
  208. REMEMBER TO PUT TWO (%%) PERCENT SIGNS IN FRONT OF THE DAYS ENTRY.
  209.  
  210. The number of days old to delete the file THIS MUST BE IN EVERY AREA
  211. REGARDLESS OF HOW MANY DAYS YOU PLACE BEHIND IT.  
  212.  
  213. The default is 30 and can only be changed in the registered version.
  214.  
  215. Note MAY BE SPACES after the EQUAL SIGN (=) and the information
  216. following it!
  217.  
  218. Simple!  Now you are ready to run!
  219.  
  220. ===============================================================================
  221.  
  222. CHEKDATE can be ran with no command line parameters.  
  223.  
  224.  
  225. SWITCHES:
  226.  
  227.  
  228. /Q OR /q
  229.  
  230.  This will cause CHEKDATE to run in quiet mode, nothing will be seen on 
  231.  your screen. 
  232.  
  233. /P or /p
  234.  
  235.  This will send all output to your printer.
  236.  
  237. /A or /a
  238.  
  239.  This will allow you to add files to the files.bbs that are in the directory
  240.  but not listed in the files.bbs file, it will append a description as
  241.  (NO DESCRIPTION GIVEN). Any files entered with this switch will have the file 
  242.  date reset to the current date, and will not be deleted until the number of days
  243.  listed in the filearea.ctl or chekdate.cfg.
  244.  
  245. /N
  246.  
  247. The addition of the /N switch allows you to NOT DELETE files from your 
  248. files.bbs file, use this in conjunction with the /A switch if you want to 
  249. add files but not delete any.
  250.  
  251. /W
  252.  
  253. The switch was added to allow for word wrapping when using the /A switch
  254. this allows for file descriptions of 255 characters in length.
  255.  
  256. /T
  257.  
  258. This is the TEST mode, before running CHEKDATE on you actual directories we
  259. suggest you use this switch, it will show you all the files it wants to delete 
  260. but will only place them in you log file. In this mode it will NOT delete 
  261. any files.
  262.  
  263. A sample batch file might be:
  264.  
  265. CLS
  266. CD\BBS
  267. CHEKDATE 
  268. RUNFB (To rebuild the File Database after changes are made to the FILES.BBS
  269. CD\MAILER
  270. MAILER
  271.  
  272. ===============================================================================
  273.  
  274. Now, about registering!
  275.  
  276. Simple, the registration cost for this program is $10.  The $10 will allow you
  277. to change the number of days you wish to delete files.  It will also give you
  278. a nice feeling inside.  
  279.  
  280. ===============================================================================
  281.  
  282. Credits:
  283.  
  284. Rob Echler and Edward Tushar - their idea, my work!
  285.  
  286. Send suggestions or complaints to the address listed in the REGISTER.DOC
  287. that came with this program!
  288.  
  289. Thanks!
  290.  
  291. Antonio Ortiz
  292.  
  293.  
  294. ==============================================================================
  295. BUG FIXES and ADDITIONS
  296.  
  297. v1.01
  298.  
  299.    Added the support for the use of Maximus BBS Filearea.ctl file.
  300.    
  301.    Fixed attempting to delete files from a CDROM.
  302.    
  303.    Added the /A switch to allow adding of files that are already
  304.    in the directory to the files.bbs.
  305.  
  306. v1.02
  307.  
  308.    Fixed the bug allowing Maximus Users to use the backslash on the end
  309.    of the path line.
  310.  
  311.    Fixed the bug of using all comment lines in the filearea.ctl file.
  312.  
  313.  
  314. v1.03
  315.  
  316.    Fixed a small bug that made reading the filearea.ctl file impossable.
  317.    Added the feature to not add specified files to the files.bbs file.
  318.  
  319.  
  320. v1.04
  321.    Added the /W /w switch for word wrap.
  322.    Added the /T /t switch for TESTING.
  323.    Added the /N /n switch for no delete.
  324.    Made the configuration file less restrictive.
  325.    Fixed a problem using the [NOADD] feature with non Maximus
  326.    configuration.
  327.    Added the [REMARKS] feature to be added to the configuration file
  328.    just prior to the [end] label
  329.  
  330.  
  331. ============================================================================   
  332.