home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / BBS_UTIL / BM0406_A.ZIP / DOCS.ZIP / WILDCARD.DOC < prev    next >
Text File  |  1994-04-01  |  5KB  |  125 lines
  1.  
  2.                        BusiMods (tm) Wildcard File Downloading
  3.                                   Implementation
  4.                                       BMxxxx
  5.  
  6. 03/26/94
  7.  
  8.  
  9. The original Wildcard download for RBBS was written by Richard Todd as an
  10. enhancement to the Maple modified RBBS.  In the BusiMod (tm) version, the
  11. original code has undergone extensive changes which give it additional features.
  12.  
  13.  
  14. In order to implement wildcard downloading in the BusiMod (tm) version of
  15. RBBS, you must create a configuration file located in the same directory
  16. that you told CONFG that your FIDX.DEF file is located (param. #267).  The
  17. name of the configuration file is the same prefix as your file index file
  18. (the FIDX file) plus the extension .CFG.  So, the naming convention would
  19. be as follows:
  20.  
  21. If you told CONFIG that the <path>\<name> of your file index file (param #267)
  22. is:  C:\RBBS\DIR\FIDX.DEF
  23.  
  24. then the <path>\<name> of your wildcard configuration file would be:
  25.      C:\RBBS\DIR\FIDX.CFG
  26.  
  27.  
  28. RBBS/BM will look for this file, and, if found, permit wildcard searches for
  29. downloading.  The contents of this configuration file is as follows:
  30.  
  31. Line 1 : Maximim files to display , number of valid directories in your LIDX.DEF
  32.  
  33. The maximum files to display to the user will default to 100 if you set it
  34. higher than 100.  You can set lower.
  35.  
  36. The number of valid directories in your LIDX.DEF file refers to ALL directoies
  37. that can be downloaded from.  Since you can also have pointers to macros to
  38. be displayed when certain files are selected, we don't want to display these
  39. files.  When creating you LIDX.DEF file, be certain to have all downloadable
  40. directories listed first, then the macros.  In my FIDX.CFG file the first
  41. line contains the following:
  42.  
  43. 100,21
  44.  
  45. My system will show the first 100 matches to the input search string, and
  46. the first 21 lines of my LIDX.DEF file are vaild downloadable directories.
  47.  
  48. Line 2 on down in the FIDX.CFG file contains the following:
  49.  
  50. <security leve> , <drive>\<path>
  51.  
  52. The security level is the minimum security level that can search the directory
  53. for matching files.  The <drive>\<path> is a directory to search.  You can have
  54. as many lines, one after the other, as you want directories searched.  If you're
  55. running a Fast File Search (FFS) system, you really don't need any entries here
  56. other than your upload directory (if you allow uploads to be downloaded) since
  57. all files will be listed in your FIDX.DEF/LIDX.DEF FFS system files.  If you
  58. are not running the FFS, then you would list all the directories you have
  59. listed in CONFIG param #208 as download directories, plus any others you may
  60. want to list.  Use caution here...the directory will be physically searched
  61. if the user has the security level to search it.
  62.  
  63. So a sample FIDX.CFG file for a fast file search system would look something
  64. like the following:
  65.  
  66. 100,21
  67. 5,K:\RBBS\FILES\UPLOAD
  68.  
  69. A sample FIDX.CFG file for a non fast file search system might look something
  70. like this:
  71.  
  72. 100,10
  73. 5,K:\RBBS\FILES\UPLOAD
  74. 5,J:\RBBS\FILES\MISC
  75. 5,J:\RBBS\FILES\UTIL
  76. 5,I:\RBBS\FILES\OS2
  77. 5,I:\RBBS\FILES\WINDOWS
  78. 5,H:\RBBS\FILES\GAMES
  79. 5,G:\RBBS\FILES\BBS
  80. 5,G:\RBBS\FILES\BBS\DOORS
  81. 5,G:\RBBS\FILES\BBS\MERGES
  82.  
  83.  
  84. How the fast file search works is like this.  The user can stack files and
  85. search strings in any order at the RBBS files system prompt.  When RBBS/BM
  86. comes to the wildcard string (which has the "*" character at the end or
  87. beginning), and wildcards are permitted, it will then process that request.
  88.  
  89. All matching files to the string, found thru searching the listed directories
  90. and/or the fast file system, up to the maximum allowed by the SysOp, will be
  91. displayed to the user.  The user can then mark the files from the list by
  92. entering the corresponding number to the file or a sequential group of numbers
  93. by placing a hyphen between two numbers (ie: 1-5  3-10  1-10  etc).
  94.  
  95. After marking the files for download, RBBS/BM will then continue on to process
  96. all the other files/wildards in the list.  The user also can add files already
  97. marked for download to the list and can stack the protocol and request to
  98. auto-logoff as with stock RBBS.
  99.  
  100. An example would be:
  101.  
  102. FILE Command: D ALLFILES.ZIP BM0306* ECHO.ZIP #1BS* TIDY.ZIP Z /G
  103.  
  104.  
  105. This would process the request for a file named ALLFILES.ZIP, then process
  106. the wildcard search for all files matching the search string "BM0306", add
  107. all the files that the user selects from the files matching the wildcard
  108. search string, then process the request for the file ECHO.ZIP, then process
  109. the wildcard search for all files matching the search string "#1BS", add all
  110. the files that the user selects from the files matching the wildcard search
  111. string, proecess the file TIDY.ZIP and send all files (including those files
  112. selected from the wildcards) using Zmodem (batch) and auto-logoff upon
  113. successful completion.
  114.  
  115.  
  116. When in non-expert mode, or when the "H" or "?" command is issued while at
  117. the wildcard prompt, the WILD.MNU (located in your main RBBS directory) will
  118. be shown to your users to assist them.
  119.  
  120.  
  121.  
  122. Richie
  123.  
  124.  
  125.