home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / MT_MNU10.ZIP / PPEMENU.DOC < prev    next >
Text File  |  1993-08-18  |  12KB  |  267 lines
  1.      ---------------------------------------------------------------
  2.      PPEMENU (v1.0) - Another Modern Technology Program written with
  3.      PPL for PCBoard v15.0 or above.  Written and released: 08/18/93
  4.      ---------------------------------------------------------------
  5.  
  6.          Modern Technology-PPE Menu Interface Version 1.0 [PPE]
  7.                         for PCBoard v15.0
  8.                      08/18/93 by Fred Barra
  9.  
  10.                            Intro:
  11.  
  12.         This PPE was written because some sysops prefer
  13.         to have all their existing & available PPE programs
  14.         available in one menu.   This  PPE Menu works in the
  15.         same manner as the PCBoard  DOORS menu, except it
  16.         will be a place to show a List of all your PPE programs
  17.         and also allow a caller to directly execute the prefered
  18.         PPE while in this menu.  <note that you may also place
  19.         DOOR commands from within this menu, or for that matter
  20.         any other PCBoard command, for more details see the
  21.         appropriate section in this Doc file Labeled:  Running
  22.         PCBoard Commands & DOORS directly from PPEMENU Interface>
  23.  
  24.  
  25.  
  26.                  PPEMENU PCBOARD INSTALLATION
  27.                  ----------------------------
  28.  
  29.   ALL THE STEPS LISTED IN THIS DOCUMENT REGARDING INSTALLATION ASSUME YOU
  30.   HAVE A COPY OF PCBOARD V15.0 (OR ABOVE) ALREADY CONFIGURED AND RUNNING!
  31.  
  32.   Unzip the contents of MT-MNU10.ZIP into it's own directory.  Suggested
  33.   path is -> DRIVE:\PCB\PPE\MENU  but you can place it anywhere you
  34.   you would like, just as long as the correct path and PPE names are
  35.   assigned within PCBoard <Next Step>
  36.  
  37.   Adding this program within PCBoard is very simple. Load PCBsetup and
  38.   choose option [B]  File Locations Once in this PCBsetup Submenu choose
  39.   (once again)  option [B]  Configuration files.  Scroll down until you see
  40.   -> Name/Loc of Default CMD.LST File  : D:\PCB\MAIN\CMD.LST
  41.   Now use the F2 key to edit the CMD.LST file "NOTE that the location shown
  42.   above is the default as supplied by PCBoard"  Your location might be
  43.   different you might also have individual CMD.LST files for different
  44.   conferences, the above is assuming you have a standard PCBoard setup.
  45.  
  46.   Next will see a screen resembling the one below, just choose a name/command
  47.   that you would like your callers to access the lottery program with.
  48.  
  49.                                File Locations
  50.  
  51.          Command     Security  PPE/MNU File -or- Keystroke Replacement
  52.      ══════════════  ════════  ═══════════════════════════════════════
  53.   1) PPEMENU             0     D:\PCB\PPE\PPEMENU\PPEMENU.PPE
  54.   2) MORE                0     D:\PCB\PPE\PPEMENU\PPEMENU.PPE
  55.  
  56.  
  57.   (Recommended NAME choices are either MORE <for MORE features Menu>, or
  58.   PPEMENU  (or if you with to custumize it even further you could even use
  59.   it to replace your DOOR and OPEN original PCBoard commands, so all
  60.   existing installed within pcboard doors, and ppe programs would all be
  61.   neatly arranged in one menu <a menu that most or all of your callers
  62.   already know where to look for extra system features!>
  63.   You  may name it whatever you want, just be sure that the path pointing
  64.   to the PEMENU.PPE in the PCBoard CMD.LST file is correct <after all
  65.   PCBoard must find the PPE file in order to execute it!>
  66.  
  67.  
  68.  
  69.   That's about it, if you added the above then PPEMENU should now be ready
  70.   so you can continue on to the part of the installation which will
  71.   involve telling PPEMENU where your actual PPE programs reside...
  72.  
  73.  
  74.        Configuring PPEMENU to run YOUR selected programs (PPE's)
  75.        ---------------------------------------------------------
  76.  
  77.   Configuring PPEMENU is very simple...  There are two configuration
  78.   files that are used to control the way PPEMENU behaves the are;
  79.  
  80.                 PPEMENU.CNF   /    PPEMENU.LST
  81.  
  82.         PPEMENU.CNF is a 3 Line file which allows specifiying
  83.                     BBSName, SysOp Name, and PPEMENU main prompt.
  84.                     Edit this file/prompts to your liking.
  85.  
  86.  
  87.         PPEMENU.LST is where you tell PPEMENU where your PPE files
  88.                     are located, a sample is included below of the
  89.                     format you should follow for each entry.
  90.                     NOTE that each entry occupies 2 lines, and each
  91.                     2 lines is considered 1 PPE entry command, for
  92.                     example in the following example lines 1 and 2
  93.                     are PPEMENU option 1, or it may also be called
  94.                     by name;
  95.  
  96.                     ;Sample PPEMENU.LST file
  97.  
  98.                     BBSLIST                 ;Line 1 <-|
  99.                     D:\PCB\PPE\BBSLIST\     ;Line 2 <-|
  100.                                                       |_ these 2 lines
  101.         NOTE there in line 1 there is no                 are the PPEMENU
  102.         extention needed <nor should you add one>        command (1), or
  103.         this is because PPEMENU will automatically       also can be invoked
  104.         add it in for you, this is done in this          using the keyword
  105.         manner so that your PPE keyword command          (BBSLIST)  NOTE!
  106.         can also be used by PPEMENU as an option         NO extention on
  107.         command, and if a caller at the menu             line 1!  It will
  108.         types either a (1) or (BBSLIST) then the         automatically
  109.         BBSLIST.PPE located in D:\PCB\PPE\BBSLIST\       default to PPE.
  110.         will be executed....  NOTE be sure to add
  111.         '\' at the very end of the path!  ALSO BE
  112.         sure to add all configuration options in
  113.         UPPER case to the PPEMENU.LST file!  Or else PPEMENU will NOT
  114.         be capable to translate the new PPEMENU commands properly....
  115.         (if you ever want or need to disable a PPEMENU interface command
  116.         temporarily {or otherwise} simply edit the PPEMENU.LST file and
  117.         change the proper command to lower case.....
  118.  
  119.         FOR MORE INFO ON INSTALLING OPTIONS TO PPEMENU INTERFACE PLEASE
  120.         SEE THE NOTES INCLUDED AT THE END OF THE PPEMENU.LST FILE!
  121.  
  122.  
  123.         REMEMBER That options added within PPEMENU.LST DO NOT have to be
  124.         added to the PCBoard CMD.LST file <only PPEMENU.PPE must be added
  125.         there so PCBoard can properly locate it>.   However if you do not
  126.         add a PPE to the <ie BBSLIST> to the CMD.LST file, then a caller
  127.         would ONLY be able to execute BBSLIST while at the PPEMENU interface
  128.         prompt...  Therefore it is recommended that you add them both as
  129.         commands in the PCBoard CMD.LST file, and to the PPEMENU.LST file
  130.         as well....
  131.  
  132.  
  133.    Running existing PCBoard Commands and DOORS from the PPEMENU interface
  134.    ----------------------------------------------------------------------
  135.  
  136.           If you wish you could also place your door selections in
  137.           this menu and run both  PPE and DOORS from within your
  138.           PPEMENU.  The same goes for *any* PCBoard Command...
  139.  
  140.           To add a PCBoard command to this menu is very simple, I
  141.           will provide a sample below...
  142.  
  143.           Sample script/PPE to run any DOOR or any PCBoard Command
  144.           from within the PPEMENU interface....
  145.  
  146.  
  147.           The sample provided below will assume you want
  148.           to list and make the PCBoard QWK command available
  149.           right from within the PPEMENU interface
  150.  
  151.           ; QWK - PPEMENU command script/PPS (PPE) file
  152.  
  153.           STRING command                      ;line 1
  154.           command = TOKENSTR()                ;line 2
  155.           KBDSTUFF "QWK "+cmdline+chr(13)     ;line 3
  156.           END                                 ;line 4
  157.  
  158.           ; Line 1: variable to hold the actual cmd
  159.           ; Line 2: returns cmd variable as stored above
  160.           ; Line 3: Stuff the Keyboard with a "QWK" and
  161.           ;         then a Carriage return so PCBoard will
  162.           ;         execute the command
  163.           ; Line 4: END of QWK.PPS/Script
  164.  
  165.           Compile the above 4 lines of PPL source code and that's
  166.           all it takes, the QWK command will now run from within
  167.           your PPEMENU interface along with all other PPE files
  168.           you may have...  NOTE that for each PCBoard command or
  169.           DOOR that you add to the PPEMENU via a script/PPE you
  170.           will still have to add it to the PPEMENU.LST file, follow
  171.           the same format as described within that file in order
  172.           to install your command into the PPEMENU interface, the
  173.           way you add it there, is exactly the same as any other
  174.           PPE since after all, the above script is exactly that;
  175.           <a PPE / smart command>
  176.  
  177.  
  178.      For more info on running DOORS and other PCBoard command please
  179.      also at;  CB.PPE  /  QWK.PPE  /  ARCADE.PPE  /  DAYSCOPE.PPE
  180.      The respective .PPS files for the above PPE scripts are included
  181.      with the archive PPS.ZIP which is also found within this archive.
  182.  
  183.  
  184.      CB.PPE        Is a PPE which will allow callers to see the
  185.                    CB command from the PPEMENU interface, really
  186.                    all it does is use the above scripting/PPE
  187.                    format and stuff a "CHAT G" into the PCBoard's
  188.                    keyboard Buffer.
  189.  
  190.      QWK.PPE       Does basically the same as the above but it
  191.                    stuffs "QWK" instead.
  192.  
  193.      ARCADE.PPE    Lets caller Join a particular conference from
  194.                    within the PPEMENU interface, the example
  195.                    provided on my bbs is used so callers can Join
  196.                    conference #6 where all my door games are located
  197.                    therefore it basically stuffs a "J 6" into the
  198.                    PCBoard keyboard buffer.
  199.  
  200.      DAYSCOPE.PPE  Let's callers Joing the daily horoscope door
  201.                    at Modern Technology BBS, right from the PPEMENU
  202.                    interface, all it does is stuff the PCBoard
  203.                    command with; "DOOR 11"  Substitute this for
  204.                    whatever door number or name you wish it to run
  205.                    on your system.
  206.  
  207.   All the source code for the example script/PPE files is included with
  208.   this archive and is listed as PPS.ZIP  please unzip it if you
  209.   you wish to see the sample source code for the PPE commands listed
  210.   above, or you can also use them and modify them so you can run some
  211.   other commands you might wish to make available in the PPEMENU interface,
  212.   or perhaps some doors.   If you really wanted to you could even make
  213.   the PPEMENU interface equal to DOOR or OPEN <via the PCBoard CMD.LST file>
  214.   and then install all your PPE files and DOOR programs in the PPEMENU
  215.   interface, and your callers would just use the command DOOR or DO
  216.   and then would get a listing of all your available options, listed as
  217.   DOORS {even though some might not actually be a DOOR program} the caller
  218.   would probally never know that, until he ran the program....
  219.  
  220.  
  221.                              DISCLAIMER
  222.                              ==========
  223.  
  224.    In no event will I "or anyone else" be liable to you for any damages,
  225.    including any lost profits, lost savings or other incidental or
  226.    consequential damages arising out of your use or inability to use
  227.    this program, or for any claim by any other party.
  228.  
  229.  
  230.      This is a FREE program!
  231.  
  232.      If you have any questions, bugs, or suggestions, please contact
  233.      me at:
  234.  
  235.      Modern Technology
  236.      Post Office Box 6531
  237.      Providence RI 02940-6531
  238.  
  239.      Or you may call my BBS where the latest version is always available
  240.      as a FREE download.
  241.  
  242.      BBS/DATA LINES:  401-333-1638 [HST DS 16.8]  * 401-333-3451 [HAYES 96]
  243.  
  244.      You may also leave me mail at Salt Air.
  245.  
  246.      Enjoy!     Fred Barra
  247.                 Author and Sysop Modern Technology BBS
  248.  
  249.  
  250.      History
  251.      -------
  252.  
  253.      08-18-93  (v1.0)
  254.  
  255.      Initial coding and release.
  256.  
  257.  
  258. A big THANK YOU goes out to:
  259.  
  260.   -  CDC, for creating the BEST BBS software in the world.
  261.      <As without it this PPE MENU would not exist>
  262.   -  To ALL the Sysops which have spend endless hours and big money
  263.      on making their systems available for our enjoyment!  Same goes
  264.      for shareware programers.
  265.  
  266. <eof>
  267.