home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / MT_SCN11.ZIP / MT-SCAN.DOC < prev    next >
Encoding:
Text File  |  1993-08-02  |  8.2 KB  |  204 lines
  1. MT-Scan (v1.1)- Another "Modern Technology" PPE for PCBoard v15.0
  2. -----------------------------------------------------------------
  3.  
  4. Welcome to the "MT-SCAN TEXT FILE SEARCH" PPE program!
  5.  
  6. Note that this is a generic "text search" program, and it can be
  7. applied to just about any text file.  For example, you could customize
  8. the messages and use it to search a big BBS listing <such as the RIME
  9. Node List etc..>  for specific matches as provided by the user or to
  10. check a master cross-file listing to find which boards have a specific
  11. file.
  12.  
  13.  
  14. This program  has been packaged and is being distributed and customized
  15. with menus and intro text files appropriated to use for a search your
  16. DOWNLOAD.TXT file for matched entries <such as ProWho - WHO UPLOADED WHAT
  17. FILE door written with ProKit by Sam Smith>   The idea for this program
  18. originated from Sam's program!  Thanks Sam!
  19.  
  20. Here's a sample of the intro files included with this package;
  21.  
  22. INTRO  (INTROG for Ansi  INTROR for Rip Graphics)
  23. -----
  24.  
  25. Welcome @FIRST@ to the "WHO UPLOADED THAT FILE" Door!
  26. This program will scan the system download/upload log
  27. and list all entries that mention a specific name.
  28.  
  29.  
  30. WELCOME (WELCOMEG for Ansi WELCOMER for Rip graphics)
  31. -------
  32.  
  33. You may select any full filename for scanning.
  34. The search is done based on matching keywords.
  35. (like the Zippy scan function)
  36.  
  37. You may do searches like this;
  38.  
  39. [MT-SCN.ZIP]   All access to this file
  40. [Fred Barra]   All activity by this user
  41. [08-02-1993]   All activity on this date
  42.  
  43. Type (H) for Help or (I) for Info file at search prompt
  44. Searches can take a few moments... so please be patient!
  45.  
  46.  
  47. There are two additional files which can be modified by the sysop at will;
  48.  
  49. HELP
  50. ----
  51. HELP file (for MONO)  /  HELPG (for ANSI)  / HELPR (for RIP)
  52.  
  53. Help is included here so you may provide the caller with additional help.
  54. Should you use this door to search a specific file and wish to pass along
  55. any special instructions about it's use etc.. then you may edit the file
  56. to suit your needs.
  57.  
  58. INFO
  59. ____
  60.  
  61. INFO file (for MONO)  / INFOG (for ANSI)  /  INFOR (for RIP)
  62.  
  63. Again included here should the need arrise for some special info to be
  64. shown to the caller.   Please feel free to edit the included INFO file
  65. to suit your needs.
  66.  
  67.  
  68. Here is a sample configuration file:
  69.  
  70.   D:\PCB\MAIN\DOWNLOAD.TXT
  71.   [File Xfers Info]
  72.   @X0A(@TIMELEFT@ min left) -> Filename or Text to Search for? (Q)=quit
  73.   MENU
  74.   INTRO
  75.   @X0FLoading FileInfo
  76.  
  77. ---------------------[Quick Description of Config Lines]-----------------------
  78. Line 1: Path and Filename of the File to Search for Text entries
  79. Line 2: Purpose of door [ie if used to search a bbs list change appropriately]
  80.         <This is displayed to your callers> and has no other purpose except
  81.         to inform them what the door will do.
  82. Line 3: Door Prompt.
  83. Line 4: Menu file name NOTE! => menuG for ANSI version menuR for RIP version
  84. Line 5: Intro file (shown to caller just prior to entering door) "see above!"
  85. Line 6: Message shown to caller prior to loading the door.  (0)=Disable
  86. -------------------------------------------------------------------------------
  87.  
  88.  
  89.                            !!!  NOTE  !!!
  90.  
  91. MT-SCAN.CNF <this file> MUST EXIST in current Path for this door work properly!
  92.  
  93.  
  94.                * Detailed configuration option lines *
  95.  
  96. Line 1:  Location of the Text File to Scan/Search for Text entries.
  97.          (The most popular use for this door would be to scan the
  98.          DOWNLOAD.TXT file to search for matched entries such as how
  99.          many times a file has been downloaded, or how many files a
  100.          user has download etc...  However this a GENERIC Text search
  101.          door and you can have it search any text file <such as a bbs
  102.          listing etc...>  Provide the correct file in this field that
  103.          you wish to scan for text>
  104.  
  105. Line 2:  Title Feature - If using this PPE to search ul/dl then the above
  106.          sample is okay, however  you could use this to search bbs listings
  107.          etc...  If this was the case you should change this title
  108.          appropriately.  This message is displayed to the caller each time
  109.          they load this program to identify the feature they are about to
  110.          perform.  This message should be changed accordingly if using this
  111.          door for other uses, ie if you were using it to Text Search the
  112.          RIME bbs Node Listing then this message could be something like
  113.          [Search for RIME Nodes Listing]
  114.  
  115. Line 3:  Prompt shown to caller each and everytime they use this door.
  116.          Again modify it accordingly to whatever you might use this door
  117.          for.
  118.  
  119. Line 4:  MENU  file name  (NOTE add a G for ANSI and R for Rip)
  120.          This file is displayed to the caller just before the door Prompt.
  121.          The sample included mentions the correct way to search for entries
  122.          in the DOWNLOAD.TXT file.  However this is a GENERIC text search
  123.          door and if used for other purposes you should change this message
  124.          appropriately.
  125.  
  126. Line 5:  INTRO file name  ( "              "               "  )
  127.          Shown to caller prior to  Entering this door.  This should be
  128.          a message explaining the purpose of this door.  One is included
  129.          which mentions it will scan the DOWNLOAD.TXT file for matched
  130.          entries.  However this is a GENERIC text search/scan door and
  131.          if used for other purposes then you should change this message
  132.          appropriately
  133.  
  134. Line 6:  Message which shows just prior to loading the door.  (0)=Disable
  135.          On my bbs I use this door to search filelistings (such as the
  136.          DOWNLOAD.TXT) for File Info and Summaries.  I also use it to
  137.          let callers search bbs lists for keywords.  If you use this door
  138.          to search nothing but the DOWNLOAD.TXT files then the above
  139.          example is fine.  If you use it to Scan for Text in other files
  140.          <such as a big bbs listing>  then you should chance the message
  141.          appropriately.  To DISABLE this message from showing prior to
  142.          loading the door put a 0 "numeral Zero" in this line.
  143.  
  144.  
  145.  
  146.  
  147.                              DISCLAIMER
  148.                              ==========
  149.  
  150.      In no event will I "or anyone else" be liable to you for any damages,
  151.      including any lost profits, lost savings or other incidental or
  152.      consequential damages arising out of your use or inability to use
  153.      this program, or for any claim by any other party.
  154.  
  155.  
  156.      This is a FREE program!
  157.  
  158.      If you have any questions, bugs, or suggestions, please contact
  159.      me at:
  160.  
  161.      Modern Technology
  162.      Post Office Box 6531
  163.      Providence RI 02940-6531
  164.  
  165.      Or you may call my BBS where the latest version is always available
  166.      as a FREE download.
  167.  
  168.      BBS/DATA LINES:  401-333-1638 [HST DS 16.8]  * 401-333-3451 [HAYES 96]
  169.  
  170.      You may also leave mail at Salt Air.
  171.  
  172.      Enjoy!     Fred Barra
  173.                 Author and Sysop Modern Technology BBS
  174.  
  175.  
  176.      History
  177.      -------
  178.  
  179.      7-8-93  (v1.0)
  180.  
  181.      Initial coding and release.
  182.  
  183.  
  184.      8-02-93 (v1.1)
  185.  
  186.      - Minor corrections in the code, also optimized the search routines
  187.        they are now not only a bit smaller but the door should now run up
  188.        to %25 faster then the the previous release.
  189.      - Fixed some cosmetic oops!
  190.      - Compiled with the latest PPL compiler. <7-19-93 release>
  191.      - Added a Help file.  Typing (H) at prompt will now show the caller
  192.        a HELP file.  <This was requested by some sysops> which needed
  193.        to provide the user with special information, when or IF this
  194.        door was being used for a special purpose.  The Help filename
  195.        should be named HELP (for MONO) / HELPG (for ANSI) / HELPR (for RIP)
  196.      - Added an INFO file which is displayed to the caller.  The Info Filename
  197.        is ; INFO (for MONO) / INFOG (for ANSI) / INFOR (for RIP)
  198.      - Fixed a bug in which if a searched item was longer then one page, and
  199.        the caller used the NS option at the prompt to display the found matches
  200.        in non-stop mode, the NS would be saved to memory and any searches which
  201.        followed during that session in the door would automatically display in
  202.        NonStop mode regardless weather the caller specified it or not. Fixed!
  203.  
  204.