home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / VRAC / CW_PPP10.ZIP / MSGQUEST.DOC < prev    next >
Text File  |  1993-09-09  |  12KB  |  213 lines
  1.  
  2.     MsgQuest v1.5  Shareware PCBoard 15.0 PPE Script to Message Base Utility
  3.  
  4. What does MsgQuest do?
  5.      This PCBoard 15.0 PPE utility will take the answer file from a PCBoard
  6.      questionnaire and insert it into your message base. It is configurable
  7.      as far as who you want it addressed to,  whether you want it public or
  8.      private, echoed or not echoed, the subject line, which message base to
  9.      insert it into and even answer logging. MsgQuest can handle up to five
  10.      script questionnaires,  each one with different configuration options.
  11.  
  12. MsgQuest Installation.
  13.      Installation of MsgQuest is now finally simple!  MsgQuest comes with a
  14.      companion utility called MSGSTUFF.PPE, which I'll explain in a moment.
  15.      First, install MsgQuest as a command in CMD.LST (preferably MSGQUEST).
  16.      Then, change your PCBTEXT prompt number 103 to look like this:
  17. %E:\PCB\MAIN\PCBTEXT.103
  18.      or whatever path you would like to use. Next, you should edit the file
  19.      PCBTEXT.103 to match your file path (a sample has been included and is
  20.      shown below). Here's my PCBTEXT.103 file with an explanation following:
  21. @INCONF@Questionnaire (@OPTEXT@) info saved.
  22. !E:\PPE\MQ\MSGSTUFF.PPE
  23.      The first line in PCBTEXT.103 replaces the prompt now missing from the
  24.      PCBTEXT file.  The second, the one calling the MSGSTUFF.PPE, takes the
  25.      contents of the file MSGSTUFF.TXT (which contains the string MSGQUEST)
  26.      and once the questionnaire is saved,  MSGSTUFF stuffs the MSGQUEST cmd
  27.      into the keyboard buffer thus running MsgQuest immediately *after* the
  28.      questionnaire is saved. It is a patch at best, and may be confusing to
  29.      some of you not familiar with PCBoard or PPE's but due to the "timing"
  30.      of how PCBoard processes scripts this is necessary. Otherwise MsgQuest
  31.      will try to process the script answer file before it is actually saved
  32.      by PCBoard (figure that one out!). But it's working fine on my system!
  33.  
  34. MsgQuest Config File.
  35. ┌──────────────────────────────────────────────┐
  36. │ Your BBS Name                                │
  37. │ 00000 (or your registration Number)          │
  38. │ Validation Code (assigned Upon Registration) │
  39. │ ************************                     │
  40. │ 0                                            │
  41. │ E:\PPE\SCRIPT\PENAPP.ANS                     │
  42. │ E:\PPE\SCRIPT\PENAPP.LOG                     │
  43. │ PEN Application                              │
  44. │ SYSOP                                        │
  45. │ MSGQUEST                                     │
  46. │ R                                            │
  47. │ 1                                            │
  48. │ *************************                    │
  49. │ 0                                            │
  50. │ E:\PPE\SCRIPT\INTELEC.ANS                    │
  51. │ E:\PPE\SCRIPT\INTELEC.LOG                    │
  52. │ Intelec Application                          │
  53. │ SYSOP                                        │
  54. │ MSGQUEST                                     │
  55. │ R                                            │
  56. │ 1                                            │
  57. └──────────────────────────────────────────────┘
  58.      Every script questionnaire that you want configured is to have 8 lines
  59.      in the config file.  Replace the lines in the sample config file  with
  60.      appropriate paths, file names  and options  for your particular needs.
  61.      Line 1 = Your Board name here
  62.      Line 2 = Registration Number       | Both are assigned when
  63.      Line 3 = Validation Code           | you register MsgQuest
  64.      Line 4 = Any string you want (like *****) to use as a script separator
  65.      Line 5 = Message base number to insert this answer file into
  66.      Line 6 = Path and Filename of answer file "as defined in PCBSetup"
  67.      Line 7 = Name of the "log file" you desire (blank if none) (See NOTES)
  68.      Line 8 = Subject line for the message inserted from this script
  69.      Line 9 = Msg To (addressed to you or SYSOP or whatever name) (IN CAPS)
  70.     Line 10 = Msg From (SYSOP or MSGQUEST) (IN CAPS) (And See History Sect)
  71.     Line 11 = Message security (either R for R/O or N for public)
  72.     Line 12 = Echoed or not (1 for echoed or 0 for not echoed)
  73.  
  74.      Repeat the lines for script 1 (lines 4-12) for script 2 (lines 13-21),
  75.      script 3 (lines 22-30), script 4 (lines 31-39), script 5 (lines 40-48)
  76.      up to 138 lines in the config file  for up to 15 scripts.  (15 scripts
  77.      in the registered version only,  MsgQuest processes just one script in
  78.      the unregistered version). If you only use this for 3 scripts then the
  79.      config file should only be 30 lines long. Here is my two script sample
  80.      config file but if you use it REMOVE the comments and comment markers.
  81.  
  82. Intelec Online                 ; Your BBS Name Here
  83. 1                              ; 00000 or # assigned when registering
  84. Validation Code                ; Validation Code  "       "       "
  85. *********************          ; Script Separator (for ease in viewing)
  86. 201                            ; Insert script 1 answers into conf # 201
  87. E:\PCB\PPE\PENAPP.ANS          ; Script answers (same as in your PCBSetup)
  88. E:\PCB\PPE\PENAPP.LOG          ; Your desired log file (See NOTES below)
  89. PEN Application                ; Subject line for this script file message
  90. CLIFF WATKINS                  ; Who you want it addressed to (IN CAPS)
  91. SYSOP                          ; Who you want it addressed from (IN CAPS)
  92. R                              ; R for R/O or N for public
  93. 1                              ; 1 for echoed or 0 for non-echoed
  94. **********************       ;
  95. 0                            ;
  96. E:\PCB\PPE\INTELEC.ANS       ;
  97. E:\PCB\PPE\INTELEC.LOG       ; Same as above but for script # 2
  98. Intelec Application          ;
  99. CLIFF WATKINS                ;
  100. SYSOP                        ;              Etc...
  101. R                            ;
  102. 0                            ;
  103.  
  104.                              ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  105.                              Remember to remove this stuff from config file
  106.  
  107. Notes
  108.      MsgQuest will insert the script answer file  into the message base you
  109.      configured it to, then it deletes the script answer file so that it is
  110.      not re-inserting the same answer file over and over again. That is why
  111.      we strongly recommend that you use the logging option!!!  Also, we are
  112.      concerned about message security,  we urge you to use SYSOP or another
  113.      "secure name" in the "Msg From" line(s) of the config file. Please see
  114.      the history sect. for detailed explanation of this added config entry.
  115.  
  116. MsgQuest History
  117.      v1.0 on 08-02-93
  118.      Initial release and looking good right out of the gate!
  119.  
  120.      v1.1 on 08-05-93
  121.      Config File Change! (A simple one but w/ verbose explanation)
  122.      Renamed MSGQUEST.CNF to SAMPLE.CNF so those upgrading do not overwrite
  123.      theirs.     Also...
  124.      Added 1 line between lines 5/6 (or between 5th and 6th line of each group)
  125.      so instead of lines going from: (Msg To)        to        (Msg Security)
  126.      lines now go from:              (Msg To) to (Msg From) to (Msg Security)
  127.      In other words, we added a "Message From" entry right after the "Message
  128.      To" entry in the config file. Now this is not just inserted as line 6 but
  129.      also as the 6th line in each and every group of scripts in your config
  130.      file. I hope this is clear, I'm not real great with docs.
  131.  
  132.      Now the verbose reasons why this was added to MsgQuest v1.1...
  133.      If you  do not  want an entry on this line then it must be a "blank line".
  134.      If MsgQuest spots a blank line then it's addressed from the "current user"
  135.      but in doing so there is a bit of a "security risk"  although it is only
  136.      remotely possible. If 2 users save scripts at the "exact same moment" then
  137.      it's theoretically possible for one users script to be "messaged" with the
  138.      other users script appended to it. We recommend the "Msg From" be either
  139.      SYSOP (or SysOp's Name) or MSGQUEST or other unique name, as long as the
  140.      name MSGQUEST or whatever name you use is protected your security should
  141.      be maintained. If you use MsgQuest for entry of credit card info then I
  142.      strongly recommend that you not echo it and use SYSOP (or any other name
  143.      that you feel is secure).
  144.  
  145.      v1.2 on 08-16-93
  146.      Config File Change! (Another simple one)
  147.      Added 4 lines at the top of the config file and 1 line between each of the
  148.      "script sections". These first 4 additional lines at the top of the config
  149.      file are 1) Your BBS  2) Your Registration number (0000 if unregistered)
  150.      3) your validation code (given when registered)  4) an "any type string"
  151.      separator to separate each script section in the config file for better
  152.      viewing. Also place this string between each subsequent script section in
  153.      your config file. See the docs for samples of this new format. MsgQuest
  154.      will now add a small tag to the messages to show a reg number or to show
  155.      UNREGISTERED. (Registration is only $10, a bargain for shareware of this
  156.      quality.
  157.  
  158.      v1.3 on 08-16-93
  159.      Sorry folks, we changed the PCBTEXT entry from 103 to 396 (main prompt) as
  160.      the only questionnaires being saved before the "script saved" prompt (103)
  161.      were those generated by PPE's and not "normal" PCB script answer files. By
  162.      using the #396 PCBTEXT entry this problem is eliminated and is seamless if
  163.      no script answer files exist.
  164.  
  165.      v1.4 on 09-01-93
  166.      OK folks, we nailed a "solution" to having MsgQuest installed as a PCBTEXT
  167.      replacement of the main board prompt (on slow machines this can be pesky).
  168.      A companion PPE utility handles this work for you now,  see changes in the
  169.      installation section of this document.
  170.  
  171.      v1.5 on 09-09-93
  172.      Released as part of the PCBoard PPE Powerpack!
  173.  
  174. Shareware
  175.      MsgQuest is not free,  versions prior to 1.3 are no longer supported.
  176.      You have 30 days to evaluate it, then you must register or remove it.
  177.      You use MsgQuest at your own risk. I will not be responsible for lost
  178.      data or any damage that the use or misuse of MsgQuest may cause. It's
  179.      been thoroughly tested on my system and works flawlessly here but I'm
  180.      just covering my assets. If you have any ideas & suggestions that can
  181.      improve on MsgQuest,  let me know in the Intelec Network's PPL forum.
  182.      Registration will remove the UNREGISTERED notice as well as enables a
  183.      full *15* questionnaires! Please help support shareware.
  184.  
  185. To Register
  186.      Registration grants you a license to use MsgQuest on the (1) BBS that
  187.      it is being registered to and licenses may not be transferred.  Plus,
  188.      registration is only $10 U.S.  Send checks or money orders payable to
  189.      Cliff Watkins  at the address shown below.  If you are outside the US
  190.      please only use Postal Money Orders in US $. Non-U.S. personal checks
  191.      cannot be accepted, please don't send cash!  If in the U.S. include a
  192.      voice number and best time to reach you  and I will call you with the
  193.      registration number and validation code. If outside the U.S. then you
  194.      must call my BBS for this info.  There is no "online registration" at
  195.      this time, sorry.  Thanks for evaluating  MsgQuest!  Look for my many
  196.      other fine PCBoard PPE utilities!
  197.  
  198.      And check out the Planet Earth Network! 21 conferences devoted to the
  199.      issues that matter most today!  Look for PEN-yymm.ZIP where yy is the
  200.      current year  and mm is the current month.  It is a great addition to
  201.      the networks you may be carrying now! Interested in a network that is
  202.      wider in focus?  Check out Intelec Network, the best general interest
  203.      network anywhere! Look for IN-yymm.ZIP on a BBS near you...
  204.  
  205.                                                  Cliff Watkins
  206.                                                  P.O. Box 212
  207.                                                  Baldwin, NY 11510
  208.  
  209.                                                  Intelec Online
  210.                                                  (516)868-0662 D/S 16.8
  211.                                                  Public from 09:30-22:30
  212.  
  213.