home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / CDOR0811.ZIP / DOCS.ZIP / ADDTIMES.DOC next >
Encoding:
Text File  |  1993-08-09  |  6.1 KB  |  134 lines
  1. ADDTIMES - a CDor FMS utility for the Times Downloaded in FMS MASTER.DIR Mod.
  2. Copyright (c) 1993 Daniel T. Drinnon
  3.  
  4. |Recent Changes marked with "|"
  5.  
  6. The sole purpose of ADDTIMES is to add the 5 character field of the Times
  7. Downloaded mod into your FMS MASTER.DIR file.  It can also UPDATE your
  8. MASTER.DIR file as well from an external 'list' file which contains the
  9. |names and the number of times the file to update has been downloaded.
  10.  
  11. ADDTIMES will take a line in the MASTER.DIR file and add a 5 character number
  12. string to represent the number of times a file has been downloaded based on
  13. what you tell it to do.  If it is working on a line that is nothing but an
  14. extended description, then it will put 4 spaces and a period ".".
  15.  
  16. Once ADDTIMES has been used to modify your FMS MASTER.DIR file, you are ready
  17. to use the Times Downloaded option in the CDor mods.  Remember to turn it ON
  18. in CONFIG!
  19.  
  20. ADDTIMES CONFIG FILE:
  21. ---------------------
  22. The config file format is as follows:
  23.  
  24. MASTER.DIR
  25. 46
  26. C:\RBBS\NODE1\DOWNLIST.DAT
  27. OUTFILE.DIR
  28. -------------------------------------------------------------------------------
  29. Line 1 = input file name, your Master FMS list
  30. Line 2 = your description length as set in config (DON'T add the 5 to it!)
  31. Line 3 = sorted list of file names with download times:
  32.          The format of this file must be:
  33.                        FILENAME.EXT,n
  34.          Where filename is the file and n is the number of times downloaded.
  35.          The number of times downloaded cannot exceed 9999!
  36.          * note:
  37.            If you do not have a sorted list, then put the word  NONE in
  38.            line 3
  39. Line 4 = The output where the modified FMS list will be written.
  40.  
  41.  
  42. ADDTIMES is smart enough to know if it is working on a MASTER.DIR that already
  43. has the Times Downloaded 5 character field added.  If the MASTER.DIR file has
  44. already been modified, then ADDTIMES automatically goes into UPDATE mode.
  45.  
  46. Using Addtimes:
  47. ---------------
  48. For first time installation of the Times Downloaded info into your stock style
  49. FMS MASTER.DIR file, you can either specify NONE in line 3 or a data file.  IF
  50. you select NONE, then all files will of course have a 0 for times downloaded.
  51. If you use UPDN, the UPDN3.DAT file format is compatible with ADDTIMES and
  52. ADDTIMES will read this file and put the times downloaded for each file it
  53. can match in your FMS MASTER.DIR.  If you use a data file, you
  54.  
  55.  
  56.                                 MUST!
  57.  
  58. SORT the data file FIRST!  Use QSORT or whatever sorter you want to make this
  59. data file alphabetically sorted.
  60. ADDTIMES does the job, but it can take time for it to run thru a big list of
  61. files, but fortunatly, this only has to be done one time.  If a file is in
  62. the MASTER.DIR and not in the data file, then of course it will get 0 for the
  63. times downloaded.
  64.  
  65. Using Addtimes with the CDor Mods:
  66. ----------------------------------
  67. The Times Downloaded mod can optionally update the times a file has been
  68. downloaded in the FMS MASTER.DIR file either while a caller is on line or after
  69. the caller logs off in an external event file or you RBBS.BAT file.  If your
  70. FMS MASTER.DIR is BIG, you may not want to use the Times Downloaded mod at all
  71. because the of the time involved.  Try it out first and then decide.  On a
  72. 3000 line FMS MASTER.DIR file, it takes a second to let the mod within RBBS
  73. find a file and update the times downloaded.
  74.  
  75. Anyway, ADDTIMES can be used externally to update the times downloaded by
  76. having your RBBS.BAT file or any other "after the caller logs off" batch file
  77. run ADDTIMES and a unique config file.  The mod within RBBS will always make
  78. a file in the NODE work directory called DOWNLIST.DAT.  So, for node 1, you
  79. could have a line in a batch file do this:
  80.  
  81. IF EXIST C:\RBBS\NODE%node%\DOWNLIST.DAT QSORT C:\RBBS\NODE%node%\DOWNLIST.DAT
  82. IF EXIST C:\RBBS\NODE%node%\DOWNLIST.DAT ADDTIMES NODE%node%.CFG
  83. IF EXIST C:\RBBS\NODE%node%\DOWNLIST.DAT DEL C:\RBBS\NODE%node%\DOWNLIST.DAT
  84.  
  85. and of course the NODE%node%.CFG file for node 1 would be NODE1.CFG and the
  86. contents of the NODE1.CFG file would be:
  87.  
  88. MASTER.DIR                       <- your FMS MASTER.DIR File to be updated
  89. 46                               <- description length
  90. C:\RBBS\NODE1\DOWNLIST.DAT       <- list of files to be processed
  91. OUTFILE.DIR                      <- name not used but line can't be empty
  92.  
  93. The file DOWNLIST.DAT would contain the names and number of times files were
  94. downloaded.
  95.  
  96. WARNING!  ADDTIMES should not be used in a MULTI-NODE system!
  97.  
  98. If this is still too slow, you can call ADDTIMES like this once per day as
  99. a BBS maintenance event.  The mod within RBBS will continue to APPEND to the
  100. DOWNLIST.DAT file forever.
  101.  
  102. A disk CACHE will greatly speed things up.
  103.  
  104. |Operational NOTES:
  105. |------------------
  106. |There is a slight difference between the "DOWNLIST.DAT" file created by
  107. |the CDor modified RBBS code depending on whether or not you have your BBS
  108. |configured to do Times Downloaded updates while the caller is ONLINE, or
  109. |after the caller logs off.  First, if you update while the caller is online,
  110. |the DOWNLIST.DAT file is deleted when all files downloaded have been updated
  111. |in your MASTER.DIR file.  The DOWNLIST.DAT file used INTERNALLY only contains
  112. |the filename of the downloaded file.  If ADDTIMES is used for updating the
  113. |number of times a file has been downloaded, the DOWNLIST.DAT file must
  114. |contain the filename, a comma (,) and the number of times downloaded:
  115. |
  116. |FILENAME.EXT,1
  117. |
  118. |Addtimes supports CHAINED FMS directories ONLY when in UPDATE mode.  To do
  119. |an initial modification of CHAINED FMS's with the extra 5 character field,
  120. |you must do each CHAINED FMS one at a time.  After that, ADDTIMES will
  121. |know it is UPDATING a CHAINED FMS system and handle it all from there.
  122.  
  123.  
  124. That's It!
  125. ----------
  126. Hope this doc is understandable.  In summary, you can make ADDTIMES add
  127. an all 0 times downloaded field to a stock RBBS MASTER.DIR, or you can
  128. have it add times downloaded from a previously created data file such as
  129. the one made by UPDN, and finally it is a utility to constantly keep your
  130. FMS updated with the times downloaded in conjunction with the CDor mod it
  131. was written for.
  132.  
  133. DAN DRINNON
  134.