home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / d / dlcnt11.zip / DLCOUNT.DOC < prev    next >
Text File  |  1993-01-09  |  10KB  |  188 lines
  1. DLcount 1.1a - Download counter for Remote Access 1.11
  2.                (C) 1992,93  William J. Dykstra
  3.  
  4.  
  5. This is a download counter for Remote Access BBSes.  This program should
  6. work fine with RA 1.11 and any other compatable versions.  DLcount supports
  7. the standard FILES.BBS, where the FILES.BBS is located in the same directory
  8. as the files are for each area.   The program reads your FILES.RA file to
  9. locate each directory.  The program will ALSO work with BBSes that use the
  10. Alternate File List path.  This information is read from CONFIG.RA.
  11.  
  12. Many BBSes that use CD-ROM drives use the alternate file list path, and they
  13. store all FILES.BBS files in one directory (as FILES.xxx, where xxx represents
  14. each file area number).   I could not find any download counter programs that
  15. would work with this setup, so I made one.   If you use the Alternate file 
  16. list path, then the program will FIRST look for a FILES.xxx for the proper
  17. area in this directory.  If it cannot find the proper FILES.xxx file, then
  18. it will look for FILES.BBS in the normal file area directory.  If it can't
  19. find one there either, it will indicate this with an error message in the log
  20. file.
  21.  
  22. All actions are logged to DLCOUNT.LOG, so you can track if a file could not
  23. be located, or if a file area was not found.
  24.  
  25.  
  26. Standard FILES.BBS style files are supported.  For example:
  27.  
  28. (sample FILES.BBS)----------------------------------------------------------
  29. TESTFILE.ZIP This is a test file.
  30. WHATEVER.ZIP This is another test file.  This is a testfile file
  31.                description, and I think you should stop reading it...
  32. ANOTHER1.ZIP This is just another test.
  33. ----------------------------------------------------------------------------
  34.  
  35.  
  36. The file description starts in column 14 in this format.  If you have extra
  37. spaces, don't worry about it.  The number will be inserted at position 14.
  38.  
  39.  
  40. Sample, after running the program, assuming each file was downloaded:
  41. ----------------------------------------------------------------------------
  42. TESTFILE.ZIP [01] This is a test file.
  43. WHATEVER.ZIP [01] This is another test file.  This is a testfile file 
  44.                description, and I think you should stop reading it...
  45. ANOTHER1.ZIP [01] This is just another test.
  46. ----------------------------------------------------------------------------
  47.  
  48. This should work for just about every FILES.BBS out there.. if you have a 
  49. non-standard format, and it won't work properly, either go with the standard
  50. format, or get in touch with me.. maybe I can make a patch for you.
  51.  
  52. The program reads your RA.LOG file, and gets the download stats from there.
  53. NOTE that the RA.LOG will be modified!  A 'Last Read Pointer' is placed at
  54. the end of the file after the program reads it.  Do NOT remove this pointer, 
  55. or the entire log will be re-read the next time the program is run, and you
  56. the download stats will become inaccurate.   You may, of course, delete the
  57. log file if you choose, but you should be sure to run DLcount before deleting
  58. it, to be sure the stats are recorded.
  59.  
  60.  
  61. =============================================================================
  62. Utility Files:  SETCOUNT.EXE and COMBINE.EXE.
  63. --------------------------------------------
  64. COMBINE.EXE is a program that will allow you to combine several FILES.RA
  65. files into one FILES.ALL file.
  66.  
  67. Some BBSes have several different copies of FILES.RA, for various reasons.  One
  68. good reason for doing this is in a case similar to mine.  I am running a 
  69. CD-ROM drive, but I have four (4) CDs, and only one drive, so I can only
  70. keep one disk online at a time.  Thus, I have 4 different FILES.RA files (I 
  71. call them FILES.CD1, FILES.CD2, FILES.CD3, and FILES.CD4) to keep track of the
  72. file areas on each disk.   The problem with this is, only some of the file
  73. areas 'exist' at one given time, but a RA.LOG file may contain downloads from
  74. several different CD-ROM disks.  If you run DLcount, it reads FILES.RA to
  75. find the file areas to match the downloads in your RA.LOG, and it won't be
  76. able to find any file areas for a disk that is not currently online!
  77.  
  78. For example:  On MONDAY, Disk #1 is online, and someone downloads from, say,
  79. the PASCAL file area.  On TUESDAY, I put disk 2 online, and copy the FILES.CD2
  80. file over FILES.RA, to show the proper file areas.  Later on Tuesday I run
  81. the DLcount program.  DLcount searches RA.LOG, finds that a file was downloaded
  82. from the PASCAL directory, and searches FILES.RA for this area.  The problem
  83. is, the PASCAL area no longer exists, because a different FILES.RA is now in
  84. use.  DLcount would then log an error message, and would not be able to
  85. increment the counter for this file.
  86.  
  87. The solution to the above problem is simple:  You need a FILES.RA that lists
  88. ALL your file areas.  The problem with this is, nobody wants to re-enter all
  89. these file areas in RACONFIG.  That's where COMBINE.EXE comes in.  It will
  90. allow you to supply all the filenames of the FILES.RA files you use, and it
  91. will combine them into one complete FILES.ALL file (in the same format as
  92. FILES.RA).  You can then tell DLcount to read FILES.ALL, rather than FILES.RA,
  93. and it will be able to track down all the file areas!
  94.  
  95. Note that even though you use several different FILES.RA files, you cannot
  96. use the same area twice IF you use the alternate file list path, because a
  97. FILES.xxx is stored for each file area, and you can't have two FILES.xxx 
  98. files with the same area number (xxx).   There may be duplication in your
  99. various FILES.RA files of course, as your hard drive will probably have file
  100. areas on it that are always available, while only the CD-ROM areas may change.
  101.  
  102. There may be reused areas if you don't use the alternate file list path, as
  103. each FILES.BBS is stored in a separate directory.  This is the method that MOST
  104. BBSes use.  If you DO have reused file areas (but not duplicated, in other 
  105. words, they are totally different file areas, depending on which copy of 
  106. FILES.RA you use) then do NOT use COMBINE.EXE.
  107.  
  108. COMBINE will only use the FIRST occurence of the file area it finds, and will 
  109. ignore all other file areas using the same area number.
  110.  
  111. I hope I made this clear to you.  If you use several FILES.RA files then
  112. you should understand what I said.  If you DON'T use several FILES.RA files,
  113. then you don't need to understand it because you don't need to use it!
  114.  
  115. COMBINE.EXE will prompt you for the name(s) of the different FILES.RA files
  116. that you want to combine into FILES.ALL.  ALL of these files must be in the
  117. current directory.  FILES.ALL will be generated in the current directory as
  118. well.
  119.  
  120.  
  121. SETCOUNT.EXE
  122.  
  123. This program will scan all the file areas in FILES.RA (or you may specify
  124. a different filename, such as FILES.ALL if you ran COMBINE.EXE) and will
  125. place a download counter in front of every file description for every file
  126. in your FILES.BBS files.  [00] will be used.  If a download counter already
  127. exists, it will be ignored and no changes will be made to that file's
  128. description, unless the download counter is a single digit.  If a single
  129. digit download counter, such as [0] or [2] is found, a leading zero will be
  130. added, to make it a two digit counter.  [0] would become [00], and [2] would
  131. become [02].  Download counters that are already two digits (or larger) will
  132. be left unchanged.
  133.  
  134. I recommend that you run this program to setup all your files with a initial
  135. download counter.  DLcount will run fine without this, but it makes your 
  136. file area lists look nicer if you have the proper download counters in every
  137. file, rather than in only the ones that have been downloaded.
  138.  
  139. This program also supports the alternate file list path.  It will search for
  140. FILES.xxx in your alternate file list directory, if you have specified one.
  141. If the program cannot find FILES.xxx in the alternate directory, then it will
  142. look for FILES.BBS in the directory where the files for this area are stored.
  143. If it cannot find a file here either, it will skip this area.
  144.  
  145. =============================================================================
  146.  
  147. Now that you understand why there may be a FILES.ALL file, or a file other
  148. that FILES.RA that you might want to read instead of FILES.RA, I can explain
  149. the optional parameters that this program can use.
  150.  
  151. You may specify two filenames on the command line.  The first filename will
  152. be the name of the log file that DLcount will read (in case you don't use
  153. RA.LOG).  The second optional filename will be the name of the FILES.RA file
  154. to use, if you don't want it to read your current FILES.RA.
  155.  
  156. Samples:        DLCOUNT MYLOG.LOG
  157.  
  158.         The above example would read MYLOG.LOG instead of RA.LOG.  FILES.RA
  159.         would still be used.
  160.  
  161.                 DLCOUNT MYLOG.LOG FILES.ALL
  162.  
  163.         The above example would read MYLOG.LOG instead of RA.LOG, and it would
  164.         read FILES.ALL instead of FILES.RA.
  165.  
  166.  
  167. USE THESE PROGRAMS AT YOUR OWN RISK!  I ASSUME NO RESPOSIBILITY FOR ANY DAMAGE
  168. THAT MAY IN ANY WAY BE CAUSED BY YOUR USE OF ANY OF THESE (FINE) PROGRAMS!
  169.  
  170. I have tested them very extensively, so there should be no problems.  You might
  171. want to backup your FILES.BBS files before running DLcount though, to see if
  172. it works properly with your system.
  173.  
  174.         This program is FREEWARE.  For comments or suggestions, I can be
  175.         reached on:
  176.  
  177.         The BillBoard BBS
  178.         (416) 898-2443
  179.         Newmarket, Ontario.  Canada.
  180.         14.4k v.32bis/v.42bis
  181.  
  182.         or on Canada Remote Systems (CRS), in the IBM or Pascal conferences.
  183.         I may also be reached via NANET mail, in the above two conferences.
  184.  
  185.         Address all mail to BILL DYKSTRA.
  186.  
  187.  
  188.