home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / MAGIC.ZIP / MENUSP.CTL < prev    next >
Text File  |  1993-02-13  |  22KB  |  430 lines

  1. % Updated by INSTALL v2.00 on 01-26-92.
  2. %
  3. %          ----------------------------------------------------
  4. %          MENUS.CTL -- The menus control file for Maximus-CBCS
  5. %          ----------------------------------------------------
  6. %
  7. % This file controls all of the aspects of Max's menus, including
  8. % the actions performed by each option, the overall menu structure,
  9. % and the appearance of each menu.
  10. %
  11. % Each menu definition is started by a "Menu" keyword.  Immediately after
  12. % the word "Menu" should be the filename to use for that menu file.  The
  13. % .MNU extension will be added automatically.
  14. %
  15. % The only two menu names that Maximus requires are "MAIN" and "EDIT".
  16. % The MAIN menu is called as soon as a user has logged on, and the
  17. % EDIT menu is called whenever the user enters the BORED message editor.
  18. % Other than those two, you are completely free to name your menus as
  19. % you wish.  Since you define the links between menus, the names you
  20. % use for your other menus is of no consequence.
  21. %
  22. % Also, you are completely free to put as many items on as many menus
  23. % as you want, although it is recommended that you keep the general menu
  24. % structure the same.  You can have up to a maximum of 127 separate menu
  25. % options on each individual menu.
  26.  
  27. Menu MAIN
  28.         %
  29.         % This option defines what the name of the menu will look like
  30.         % on-screen, to the user.  This doesn't necessarily have to be
  31.         % the same name as you specified above.
  32.  
  33.         Title           MAIN MENU (%t mins left)
  34.  
  35.         % This option is used to specify a "type" for each menu.  These
  36.         % menu types cause Maximus to display certain information before
  37.         % the "Select:" prompt, such as the message area banner, the
  38.         % information screen for the C)hange menu, and so on.  The
  39.         % following MenuHeaders are supported by Maximus:
  40.         %
  41.         %       MenuHeader Message:   Displays a "Msg.area xx .. Description"
  42.         %                             status line before each prompt.
  43.         %
  44.         %       MenuHeader File:      Displays a "File area yy .. Description"
  45.         %                             status line before each prompt.
  46.         %
  47.         %       MenuHeader Change:    Displays the user's current settings,
  48.         %                             which is usually what you'd find at
  49.         %                             the C)hange Setup menu.
  50.  
  51.         MenuHeader      None
  52.  
  53.         % This next option defines a customized *.BBS file to display
  54.         % _instead_ of the canned, Max-generated menu.  The file you
  55.         % specify will be shown to callers who enter this menu whenever
  56.         % the menu options would normally be displayed.  If no
  57.         % file is given, Max will generate the menu on its own.
  58.         %
  59.         % This file can contain any of the special MECCA tokens that
  60.         % you can use in a normal .MEC file.
  61.         %
  62.         % If you specify a MenuFile, it will be enabled for all help
  63.         % levels by default.  However, if you wish to enable the
  64.         % menu for certain help levels only (such as NOVICE and
  65.         % REGULAR), simply add the names of the levels after the
  66.         % filename.  For example, "MenuFile Misc\MenuMain Novice"
  67.         % would show the MenuFle to novice callers only, and
  68.         % the Max-generated menu would be shown to everyone else.
  69.         % See the Max TechRef manual for more information on this
  70.         % option.
  71.         %
  72.         % Maximus can also display a HeaderFile for each menu.
  73.         % Please see the TechRef Manual for more information.
  74.  
  75. %       MenuFile        Misc\MenuMain
  76.  
  77.         % If you are using the customized .BBS MenuFile, then you must
  78.         % tell Maximus how many lines on your screen that your custom
  79.         % file takes.  If this value is not specified, or if it is incorrect,
  80.         % then you will have problems with messages being scrolled off the
  81.         % top of your screen because of your customized menufile.
  82.  
  83. %       MenuLength      14
  84.  
  85.         % This option is also only applicable if you're using a custom
  86.         % *.BBS menufile.  As expected, if a user presses a key in the
  87.         % middle of the menu with HOTFLASH turned on, the menu will abort
  88.         % it's display, and jump to the option selected.  However, if
  89.         % your *.BBS file has a coloured background, this operation may
  90.         % cause the background to bleed into the rest of the screen.  The
  91.         % solution is to specify an AVATAR colour number here, which will
  92.         % be displayed BEFORE printing the key the user selected.  Normally,
  93.         % this colour should have the background set to black, or whatever
  94.         % colour your screen normally is.  An index of the AVATAR colour
  95.         % codes (and their corresponding colours) can be found in the
  96.         % MAX_REF.PRN manual.
  97.  
  98. %       MenuColour      15
  99.  
  100.         % This section of the control file defines the available
  101.         % commands for this menu.
  102.  
  103.         % The name of the COMMAND to perform is in the left column.
  104.         % This tells Maximus what it should do when this option is
  105.         % selected.  Examples of commands are "Goodbye",
  106.         % "Display_File" and "Msg_Browse".
  107.         %
  108.         % Following the command is an optional argument; some
  109.         % commands need arguments, but others don't.  If the argument
  110.         % contains any spaces (such as would a DOS command line),
  111.         % then make sure to replace them with underscores, which will
  112.         % get translated back into spaces when the menu is read back
  113.         % in.  The only common commands which use arguments are
  114.         % Display_File, Display_Menu and Area_Change.
  115.         %
  116.         % After the argument is that command's access level.  This
  117.         % access level consists of a privilege level and an optional
  118.         % set of keys.  A user will only be able to select that
  119.         % option if his/her priv level is equal to or higher than the
  120.         % specified level.  In addition, if you wish to restrict a
  121.         % command to users which carry certain keys, simply place a
  122.         % slash and a list of key numbers/letters after the privilege
  123.         % level.  For example, to restrict a command so that only
  124.         % Normal-level users with keys 1 and C can access a command,
  125.         % use a priv level of "Normal/1C".
  126.         %
  127.         % Following the priv level is the command description.  This
  128.         % description will be used when creating NOVICE-level menus,
  129.         % and the first letter of that command will be used as the
  130.         % selection character, so make sure that each command has a
  131.         % unique first character.
  132.  
  133.         % Name of cmd    Optional arguments      Priv.   Command as it
  134.         % to execute     for cmd, if any         Level   appears to user
  135.         % ------------  --------------------- --------- -----------------
  136.  
  137.         Display_Menu    Message                Disgrace "Message Areas"
  138.         Display_Menu    File                   Disgrace "File Areas"
  139.         Display_Menu    Change                 Disgrace "Change Setup"
  140.  
  141.         % The above three options tell Maximus to chain to a different
  142.         % *.Mnu file, whose name is specified as an argument.  Please
  143.         % make sure NOT to include a path before the name of your menu,
  144.         % since Maximus will add that according to the currently-defined
  145.         % menu path.
  146.  
  147.         Goodbye                                    Twit "Goodbye (log off)"
  148.         Statistics                             Disgrace "Statistics"
  149.         Userlist                               Disgrace "UserList"
  150.         Version                                Disgrace "Version of BBS"
  151.  
  152.         Display_File    Misc\YellReq           Disgrace "Yell for SysOp"
  153. NoDsp   Yell                                   Disgrace "Y"
  154. NoDsp   Download                               Disgrace "D"
  155.         % The above options are fairly generic, and basically do what
  156.         % they appear to do.
  157.  
  158.         % When selected, this option displays a *.BBS file to the user.
  159.         % You can have as many of these custom files as you wish.
  160.  
  161.         Display_File    Misc\Bulletin          Disgrace "Bulletins"
  162.  
  163.         % These commands display the off-line reader and SysOp menus.
  164.  
  165.         Display_Menu    Reader                 Disgrace "Off-line readers"
  166.         Display_Menu    Sysop                     Sysop "#Sysop menu"
  167.  
  168.         % The following is the help file for the main menu.  Unless you
  169.         % specify a help file, such as done below, users will NOT be able
  170.         % to press `?' for help.
  171.  
  172.         Display_File    Hlp\Main               Disgrace "?help"
  173.  
  174. End Menu
  175.  
  176.  
  177. Menu MESSAGE
  178.         Title           MESSAGE MENU (%t mins left)
  179.  
  180.         % To turn off the "Msg.area xxx ... asdf" display, but to still
  181.         % have Max believe that this is a message menu, use
  182.         % "SilentMenuHeader Message" instead of the line below.
  183.  
  184.         MenuHeader      Message
  185.  
  186.         % To display a custom file instead of the canned Max menu, use
  187.         % this:
  188.  
  189. %       MenuFile        Misc\MenuMsg
  190.  
  191.         % Name of cmd    Optional arguments      Priv.   Command as it
  192.         % to execute     for cmd, if any         Level   appears to user
  193.         % ------------  --------------------- --------- -----------------
  194.  
  195.         Area_Change     Message                Disgrace "Area change"
  196.   NoDsp Area_Change     Message                Disgrace "[" "["
  197.   NoDsp Area_Change     Message                Disgrace "]" "]"
  198.         Read_Next                              Disgrace "Next message"
  199.         Read_Previous                          Disgrace "Previous message"
  200.         Enter_Message                          Disgrace "Enter message"
  201.         Msg_Reply                              Disgrace "Reply to a message"
  202.         Msg_Browse                             Disgrace "Browse messages"
  203.         Msg_Change                             Disgrace "Change current msg"
  204.         Read_Nonstop                           Disgrace "=ReadNonStop"
  205.         Read_Original                          Disgrace "-ReadOriginal"
  206.         Read_Reply                             Disgrace "+ReadReply"
  207.         Msg_Current                            Disgrace "*ReadCurrent"
  208.         Msg_List                               Disgrace "List (brief)"
  209.         Msg_Tag                                Disgrace "Tag areas"
  210.         Display_Menu    Main                       Twit "Main menu"
  211.         Display_Menu    File                       Twit "Jump to file areas"
  212.         Goodbye                                    Twit "Goodbye (log off)"
  213.         Msg_Kill                               Disgrace "Kill (delete) msg"
  214.         Msg_Kludges                               Sysop "!Toggle Kludges"
  215.         Msg_Unreceive                             Sysop "#Unreceive Msg"
  216.         Msg_Upload                             Disgrace "Upload a message"
  217.         Forward                                Disgrace "Forward (copy)"
  218.         Msg_Hurl                                  Sysop "Hurl (move)"
  219.         Xport                                     Sysop "Xport to disk"
  220.         Msg_Edit_User                             Sysop "@Edit user"
  221.   NoDsp Same_Direction                         Disgrace "|"
  222.   NoDsp Read_Individual                        Disgrace "0"
  223.   NoDsp Read_Individual                        Disgrace "1"
  224.   NoDsp Read_Individual                        Disgrace "2"
  225.   NoDsp Read_Individual                        Disgrace "3"
  226.   NoDsp Read_Individual                        Disgrace "4"
  227.   NoDsp Read_Individual                        Disgrace "5"
  228.   NoDsp Read_Individual                        Disgrace "6"
  229.   NoDsp Read_Individual                        Disgrace "7"
  230.   NoDsp Read_Individual                        Disgrace "8"
  231.   NoDsp Read_Individual                        Disgrace "9"
  232.   Local Display_File    Hlp\Msg                Disgrace "?help"
  233.  Matrix Display_File    Hlp\Mail               Disgrace "?help"
  234.    Echo Display_File    Hlp\Echo               Disgrace "?help"
  235.         %
  236. End Menu
  237.  
  238. Menu FILE
  239.         Title           FILE MENU (%t mins left)
  240.  
  241.         % To turn off the "File area xxx ... asdf" display, but to still
  242.         % have Max believe that this is a file menu, use
  243.         % "SilentMenuHeader File" instead of the line below.
  244.  
  245.         MenuHeader      File
  246.  
  247.         % To display a custom file instead of the canned Max menu, use
  248.         % this:
  249.  
  250. %       MenuFile        Misc\MenuFile
  251.  
  252.         % Name of cmd    Optional arguments      Priv.   Command as it
  253.         % to execute     for cmd, if any         Level   appears to user
  254.         % ------------  --------------------- --------- -----------------
  255.  
  256.         Area_Change     File                   Disgrace "Area change"
  257.   NoDsp Area_Change     File                   Disgrace "[" "["
  258.   NoDsp Area_Change     File                   Disgrace "]" "]"
  259.         Locate                                 Disgrace "Locate a file"
  260.         File_Titles                            Disgrace "Files listing"
  261.         Type                                   Disgrace "View text file"
  262.         Download                               Disgrace "Download (receive)"
  263.         Upload                                 Disgrace "Upload (send)"
  264.         Statistics                             Disgrace "Statistics"
  265.         Xtern_Run 4os2_/C_peek_38400_%g_%F_%f_%l  Disgrace "Zip/Archive Viewer"
  266.         Contents                               Disgrace "Contents (archive)"
  267.         File_Tag                               Disgrace "Tag (queue) files"
  268.         NewFiles                               Disgrace "New files scan"
  269.         Raw                                       Sysop "Raw directory"
  270.         File_Kill                                 Sysop "Kill file"
  271.         File_Hurl                                 Sysop "Hurl (move)"
  272.         Override_Path                             Sysop "Override path"
  273.         Display_Menu    Main                       Twit "Main menu"
  274.         Display_Menu    Message                    Twit "Jump to msg. areas"
  275.         Goodbye                                    Twit "Goodbye (log off)"
  276.         Display_File    Hlp\FileHelp           Disgrace "?help"
  277.         %
  278. End Menu
  279.  
  280. Menu CHANGE
  281.         Title           CHANGE MENU (%t mins left)
  282.         MenuHeader      Change
  283.  
  284. %       MenuFile        Misc\MenuChg
  285.  
  286.         % Name of cmd    Optional arguments      Priv.   Command as it
  287.         % to execute     for cmd, if any         Level   appears to user
  288.         % ------------  --------------------- --------- -----------------
  289.  
  290.         Chg_Alias                                Hidden "Alias"
  291.         Chg_Phone                              Disgrace "#Telephone no."
  292.         Chg_City                               Disgrace "City"
  293.         Chg_Password                           Disgrace "Password"
  294.         Chg_Help                               Disgrace "Help level"
  295.         Chg_Nulls                              Disgrace "Nulls"
  296.         Chg_Width                              Disgrace "Width"
  297.         Chg_Length                             Disgrace "Length"
  298.         Chg_Tabs                               Disgrace "Tabs"
  299.         Chg_Video                              Disgrace "Video mode"
  300.         Chg_Editor                             Disgrace "FullScrnEdit"
  301.         Chg_Clear                              Disgrace "Screen clear"
  302.         Chg_IBM                                Disgrace "IBM characters"
  303.         Chg_Hotkeys                            Disgrace "!Hotkeys"
  304.         Chg_Language                           Disgrace "@Language"
  305.         Chg_Userlist                           Disgrace "%ShowInUserlist"
  306.         Chg_Protocol                           Disgrace "$Protocol default"
  307.         Chg_Archiver                           Disgrace "&Archiver default"
  308.         Chg_FSR                                Disgrace "^FullScrnRead"
  309.         Chg_More                               Disgrace "*More Prompt"
  310.         Display_Menu    Main                       Twit "Main Menu"
  311.   NoDsp Display_Menu    Main                       Twit "Q"
  312.   NoDsp Display_Menu    Main                       Twit "|"
  313.         Display_File    Hlp\Change             Disgrace "?help"
  314.         %
  315. End Menu
  316.  
  317. Menu EDIT
  318.         Title           EDIT MENU (%t mins left)
  319.  
  320. %       MenuFile        Misc\MenuEdit
  321.  
  322.         % Name of cmd    Optional arguments      Priv.   Command as it
  323.         % to execute     for cmd, if any         Level   appears to user
  324.         % ------------  --------------------- --------- -----------------
  325.  
  326.         Edit_Save                                  Twit "Save Message"
  327.         Edit_Abort                                 Twit "Abort Message"
  328.         Edit_List                                  Twit "List Message"
  329.         Edit_Edit                                  Twit "Edit Line"
  330.         Edit_Insert                                Twit "Insert Line"
  331.         Edit_Delete                                Twit "Delete Line"
  332.         Edit_Quote                                 Twit "Quote message"
  333.         Edit_Continue                              Twit "Continue"
  334.         Edit_To                                    Twit "To"
  335.         Edit_Subj                                  Twit "JsubJect"
  336.         Edit_From                                 Sysop "From"
  337.         Edit_Handling                             Sysop "Handling"
  338.         Read_DiskFile                             Sysop "Read from disk"
  339.         Display_File    Hlp\Editor                 Twit "?help"
  340.         %
  341. End Menu
  342.  
  343. %
  344. %Menu CHAT
  345. %        Title           CHAT MENU (%t mins left)
  346. %
  347. %        MenuHeader      Chat
  348. %%       MenuFile        Misc\MenuChat
  349. %
  350. %        % Name of cmd    Optional arguments      Priv.   Command as it
  351. %        % to execute     for cmd, if any         Level   appears to user
  352. %        % ------------  --------------------- --------- -----------------
  353. %
  354. %        Chat_CB                                Disgrace "CB Chat"
  355. %        Chat_Page                              Disgrace "Page User"
  356. %        Chat_Pvt                               Disgrace "Answer Page"
  357. %        Chat_Toggle                            Disgrace "Toggle Status"
  358. %        Display_Menu    MAIN                   Disgrace "Main Menu"
  359. %        Goodbye                                Disgrace "Goodbye (log off)"
  360. %        Display_File    Misc\ChatHelp          Disgrace "?help"
  361. %End Menu
  362. %
  363.  
  364. Menu READER
  365.         Title           READER MENU (%t mins left)
  366.         HeaderFile      Misc\OLR_Hdr
  367.  
  368.         % Name of cmd    Optional arguments      Priv.   Command as it
  369.         % to execute     for cmd, if any         Level   appears to user
  370.         % ------------  --------------------- --------- -----------------
  371.  
  372.         Xtern_Run 4os2_/C_C:\Max\Xpress        Disgrace "Xpress Mail"
  373.         Xtern_Run 4os2_/C_C:\Max\Bwmail        Disgrace "BlueWave Mail"
  374.         Msg_Tag                                Disgrace "Tag area"
  375.         Msg_Browse                             Disgrace "Download new msgs" "tnp"
  376.         Msg_Browse                             Disgrace "L D/L & Sign Off" "tnp"
  377. NoDsp   Key_Poke gyn;|                         Disgrace "L"
  378.         Msg_Upload_QWK                         Disgrace "Upload replies"
  379.         Chg_Protocol                           Disgrace "Protocol default"
  380.         Chg_Archiver                           Disgrace "Archiver default"
  381.         Display_Menu    Main                       Twit "Quit to Main"
  382. %        Display_Menu    Main                       Twit "Main menu"
  383.         Display_Menu    File                       Twit "File menu"
  384.         Display_Menu    Message                    Twit "Message menu"
  385.         Goodbye                                    Twit "Goodbye (log off)"
  386.         Display_File    Hlp\OLR                    Disgrace "?help"
  387.   NoDsp Display_Menu    Main                       Twit "|"
  388. End Menu
  389.  
  390.  
  391. Menu SYSOP
  392.         Title           SYSOP MENU (%t mins left)
  393.  
  394.         % Name of cmd    Optional arguments      Priv.   Command as it
  395.         % to execute     for cmd, if any         Level   appears to user
  396.         % ------------  --------------------- --------- -----------------
  397.  
  398.         % This command invokes the internal Maximus user editor.
  399.  
  400.         User_Editor                                Sysop "User Editor"
  401.  
  402.         % This tells Maximus that you want to execute an external
  403.         % program (in this case, COMMAND.COM) when the `O' menu option
  404.         % is selected.  Other options are available, such as `Xtern_Dos'
  405.         % (which can run .BAT or .CMD files) and `Xtern_Erlvl'
  406.         % (which completely unloads Maximus from memory).
  407.         %
  408.         % Also, when specifying the command/errorlevel to execute,
  409.         % don't forget to use underscores instead of spaces!
  410.         %
  411.         % Examples:
  412.         %
  413.         %   Xtern_Run   C:\Max\Bonk_/XN       Sysop "Nodelist editor"
  414.         %   Xtern_Dos   D:\Path\Runme.Bat      Twit "Run XYZ program"
  415.         %   Xtern_Erlvl 45_Ongame.Bat      Disgrace "On-line Games"
  416.  
  417.         % If you're running 4DOS, replace the following
  418.         % "Command.Com" with "4Dos.Com".
  419.  
  420. UsrLocal   Xtern_Run    4OS2.EXE                    Sysop "OS/2 Shell"
  421. %UsrRemote  Xtern_Run     MAXPIPE.EXE_%P_CMD          Sysop "OS/2 Shell"
  422. UsrRemote Xtern_Run Os2You.EXE_-l_%%%P_-f_100_-t_ANSI_-e_4OS2.EXE Sysop "Wahlgren OS/2 Shell"
  423. %UsrRemote  Xtern_Dos     Outside.Bat                Sysop "OS/2 Shell"
  424. UsrRemote   Xtern_Run 4OS2_/C_DOORWAY_COM1_/m:32767_/o:t_/v:d^U_/s:*_/c:dos Sysop "Doorway OS/2 Shell"
  425.         Display_Menu    Main                        Sysop "Main menu"
  426.   NoDsp Display_Menu    Main                        Sysop "Q"
  427.   NoDsp Display_Menu    Main                        Sysop "|"
  428. End Menu
  429.