home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / vrac / pw_menu.zip / MENU.DOC < prev    next >
Text File  |  1994-05-18  |  9KB  |  192 lines
  1. About these programs:
  2.  
  3. This is a menuing system PPE.  It will handle EXE, COM, BAT, PPE and
  4. any display files.  It can be used to supplement or replace your
  5. existing DOOR configuration.  It maintains its own menu, and will
  6. build it, and any command lines for EXE COM and BAT files on-the-fly,
  7. using Doorway or not, as you specify.
  8. For running applications that are designed as DOORS, you may either
  9. configure them through here, or use external batch files to call them.
  10. It will accept up to 20 characters of command line switches, allowing
  11. you to specify config files, etc..  It will accept up to 22 entries
  12. (total), but they MUST be listed in order.  For example, you may not
  13. have entries for 1-5, skip 6, and list 7-10.  It will stop displaying
  14. at 5.  If your caller has ANSI capabilities, it will let them use a
  15. high-light bar to select the entry they'd like, and press enter when
  16. the proper entry is highlighted.  It's a little easier (in my opinion)
  17. than installing applications the regular way, because you don't have
  18. to know Doorway command lines, or write any batch files.
  19.  
  20. ===========================================================================
  21.  
  22. Files:
  23.                 MENU.PPE - This is the actual program.  It builds a
  24.                            menu based on the MENU.IDX file (your
  25.                            configuration information).
  26.  
  27.                SETUP.PPE - This is the configuration program.  It
  28.                            should be restricted to only you, or you
  29.                            and trusted callers.  It will allow ANY
  30.                            DOS-text based EXE, COM, BAT or PPE to be
  31.                            installed and run on your system.  Even
  32.                            COMMAND.COM, which would allow a drop to
  33.                            DOS.
  34.  
  35. The .PPS files are the source code for each of the compiled PPEs.
  36. =========================================================================
  37.  
  38. To install:
  39.  
  40.   Create a new subdirectory called \PCB\MENU and unzip the files into
  41.   it.  Go into PCBSetup|File Locations|Configuration Files, to entry
  42.   that says "Name/Loc of Default CMD.LST File" and press F2 to edit
  43.   the file.  You'll see a screen that looks something like this:
  44.  
  45.                               CMD.LST Editor
  46.  
  47.         Command     Security  PPE/MNU File -or- Keystroke Replacement
  48.     ══════════════  ════════  ═══════════════════════════════════════
  49.  1) CLS                 0     C:\PCB\PPE\CLS.PPE
  50.  
  51.  Insert two new lines by pressing Alt+I.  Put new entries in them that
  52.  look like this:
  53.  
  54.  2) APPS                0      C:\PCB\MENU\MENU.PPE
  55.  3) SETUP             110      C:\PCB\MENU\SETUP.PPE
  56.  
  57.   The "Command" entry can be changed to whatever you'd like, for either
  58.   of the PPEs.  Also, you may want to restrict it to certain security
  59.   levels or higher, or to allow the SETUP program to be used by some of
  60.   your more trusted callers.  With this they could configure DOORs on
  61.   your system, but not have to have access to PCBSetup.  Of course, if
  62.   you're using a different drive or subdirectory structure, this should
  63.   also be changed to reflect your system.  In short, the above is for
  64.   example, and isn't restricted by any programming in the PPEs
  65.   themselves.  Once you've done this, you're ready to start installing
  66.   applications.
  67.  
  68. ===========================================================================
  69.  
  70. Configuration:
  71.  
  72.   Log into the board, get to a command prompt and type SETUP (still
  73.   using the example above).  This will start the configuration
  74.   program.  You'll see a screen something like this:
  75.  
  76. The configuration file does not exist.  Create it?
  77.  
  78. Answer yes at this prompt to create the MENU.IDX file (which holds your
  79. configuration information).  Then you'll see this:
  80.  
  81. 1. -
  82. 2. -
  83. 3. -
  84. 4. -
  85. 5. -
  86. 6. -
  87. 7. -
  88. 8. -
  89. 9. -
  90. 10. -
  91. 11. -
  92. 12. -
  93. 13. -
  94. 14. -
  95. 15. -
  96. 16. -
  97. 17. -
  98. 18. -
  99. 19. -
  100. 20. -
  101. 21. -
  102. 22. -
  103. Enter the number you wish to modify (Q = quit)? (  )
  104.  
  105. ****IMPORTANT****
  106.   Always begin your entries with #1 and move up in order from there.  It is
  107.   possible to modify an existing entry, including deleting it.  If you wish
  108.   to delete an entry from the MIDDLE of your file, you MUST replace it with
  109.   something else.  If you leave a "blank" entry, your menu will not operate
  110.   properly, and will abort building the menu at the blank entry.
  111.  
  112.   Enter 1, and you'll see the next questions (in order)
  113.  
  114. Enter new name? (Sample         )
  115. Enter new path/filename up to 60 characters:
  116. ? (c:\pcb\ppe\sample.ppe                                       )
  117. Enter the new description up to 60 characters:
  118. ? (A sample file to show you what the entries should look like )
  119. Requires Doorway? (n)
  120. Enter new command line switches (if any) up to 40 characters:
  121. ? (/test                                   )
  122.  
  123.   As you can see, the first entry is what will display to the caller when
  124.   they execute the APPS command.  The second entry is the complete
  125.   drive/path and file name information.  The third entry is a description
  126.   line that will show to the caller (after the file name).  The fourth
  127.   entry is whether the application will require the use of Doorway.  Any of
  128.   the PCBoard utilities will require Doorway.  DOORWAY.EXE must also be in
  129.   your path.  If the application you're installing uses command line
  130.   switches or parameters (like a configuration file, or /CONF:SYS, in the
  131.   case of PCBFiler) you enter those here. At that point, it will re-display
  132.   the information, and ask you to confirm it before it stores it in the
  133.   configuration file.  If you confirm the information is correct, it will
  134.   store the information and ask if you'd like to enter or modify any other
  135.   entry.
  136.  
  137. You have entered the following information:
  138.  
  139.                Name: Sample
  140.       Path/filename: C:\PCB\PPE\SAMPLE.PPE
  141.         Description: A sample file to show you what the entries should look like
  142.    Requires Doorway: N
  143.          Parameters: /TEST
  144.        Display only: N
  145.  
  146.   Is this correct? (y)
  147.   Add/Modify another? (n)
  148.  
  149.   At this point you can enter or re-enter any entry you'd like.  When
  150.   you're done, either hit "Q" at the main screen, or tell it "No" when it
  151.   asks if you'd like to Add/Modify another.
  152.  
  153. ===========================================================================
  154.  
  155. Running the Menu:
  156.  
  157.   To run the menu, just type APPS as a command at the command prompt.
  158.   PCBoard will build the menu, based on the entries you've put in the SETUP
  159.   program.  This part is where it's important that you don't have blank
  160.   entries in the Setup, since the program will stop building the menu the
  161.   first time it sees a blank entry.  If your caller has ANSI capability,
  162.   (s)he will be able to use the cursor control keys to move a highlight bar
  163.   to select the entry they'd like to run/display.  You can put in
  164.   informational bulletins, applications, PPEs, whatever you'd like.  This
  165.   could supplement your BLT.LST, your DOORS.LST, or about anything else
  166.   you'd like to do.  Since it will call other PPEs, you could make it
  167.   recusively call other installations of itself and build a sub-menu of
  168.   doors, PPEs, or display files.  The source is included, so you could
  169.   modify it to get it's configuration file from the command line, and build
  170.   the sub-menus that way.  Your imagination (and access to the PPL
  171.   Compiler) is the only thing that limits you.
  172.  
  173. As always, The Disclaimer:
  174.  
  175. This isn't guaranteed to do anything.  It also isn't guaranteed to NOT
  176. do anything.  If you install it and green tentacles shoot out of your
  177. floppy disk bays, destroying your entire house and killing your dog,
  178. it's not my fault, and I won't pay for it.  The source code is here, I'm
  179. not a fancy enough programmer to pull any subterfuge, so you can check
  180. it and see for yourself what it does.
  181.  
  182. This is not written by or supported by Clark Development Company, it's
  183. written only by me, and not supported by anyone but you.  I don't have
  184. enough time at work to do what I get paid for, let alone support things
  185. I'm not paid for.  If you call me at home, I promise I'll hang up on
  186. you.  I wrote it because I enjoy doing things like this, and I release the
  187. source code because it's the way I learned to program - by stealing other
  188. people's source code and modifying it to do what I wanted it to do.  I ask
  189. that you not modify the source and upload it for re-distribution.
  190. It *is* my code, after all, and we're all theoretically curteous and
  191. thoughtful people.
  192.