home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / com / bbs / maximus / convert.prn next >
Encoding:
Text File  |  1991-11-04  |  8.5 KB  |  192 lines
  1.  
  2.  
  3.  
  4.  
  5.                             Maximus 1.02 to 2.0 Conversion
  6.  
  7.           This file contains a list of step-by-step instructions for
  8.           converting a Max 1.02 system to version 2.00.  Please read this
  9.           file in full before attempting to run INSTALL.
  10.  
  11.           When you run INSTALL, it will automatically make several
  12.           modifications to your system control files.  However, your menu
  13.           and event control files must be manually modified after running
  14.           INSTALL.
  15.  
  16.           The INSTALL program was designed in a `safe' manner.  INSTALL
  17.           will never overwrite an existing file; instead, it will simply
  18.           rename the old file with an extension of .102.  (Due to a
  19.           filename conflict, your old MAX.CTL will be renamed to
  20.           MAXCTL.102.)  In addition, INSTALL will create a log of changes
  21.           in INSTALL.LOG.  If you need a file from your old Max 1.02
  22.           system, you can read the log to find out where it went.
  23.  
  24.           To upgrade to version 2.0, you must follow these steps:
  25.  
  26.           I.   MAKE A BACKUP OF YOUR OLD INSTALLATION
  27.  
  28.           II.  RUN THE INSTALLATION PROGRAM
  29.  
  30.                Install is a menu-driven, point-and-shoot installation
  31.                program for Maximus.  INSTALL is capable of using either the
  32.                mouse or the keyboard for input.  When running INSTALL, you
  33.                should:
  34.  
  35.                A.   Have at least 300K of free memory.  INSTALL has a set
  36.                     of internal file decompression routines, so you'll need
  37.                     at least 300K to perform the installation successfully.
  38.  
  39.                B.   Specify the directory structure of your existing
  40.                     Maximus installation.  Please be sure to specify the
  41.                     correct paths for your Max system dir, your misc files
  42.                     and your help files.  By default, all of your
  43.                     executables and your HLP files will be replaced, but
  44.                     your MISC files will not.  (If you need to keep your
  45.                     old help files, you can rename \MAX\HLP\*.102 back to
  46.                     *.MEC after INSTALL finishes.)
  47.  
  48.                C.   Select a path for the language directory.  Max 2.0 now
  49.                     includes multilingual support, so you should use a
  50.                     separate directory to hold all of the language files.
  51.                     If the specified directory does not exist, INSTALL will
  52.                     create it for you.
  53.  
  54.                D.   Use the space bar to select the "Upgrade from Max 1.02"
  55.                     button.  Make sure that this option is selected, or
  56.                     else INSTALL will attempt to create a new Maximus
  57.                     installation.
  58.  
  59.  
  60.  
  61.                E.   Select the "OK" button.  INSTALL will then decompress
  62.                     all of the Max 2.0 files into the appropriate
  63.                     locations.
  64.  
  65.                F.   Specify the path and filename of your base MAX.CTL
  66.                     control file.  If the "Update MAX.CTL" box is checked
  67.                     (as it is by default), INSTALL will add all of the new
  68.                     keywords and sections required to run a Max 2.0 system. 
  69.                     Unless you check the "Update MAX.CTL" box, the
  70.                     conversion must be performed manually.  (This document
  71.                     only covers the steps required for the automatic
  72.                     installation.)
  73.  
  74.           III. EDIT YOUR MENUS
  75.  
  76.                Several new menu commands have been added to Max 2.00. 
  77.                Although your old menu control file will still work, you'll
  78.                be missing out on a lot of features unless you add the new
  79.                commands.
  80.  
  81.                IF YOU ARE USING THE STANDARD MENUS, adding new commands is
  82.                easy.  The installation program created a file called
  83.                MENUS.200; this contains the standard menu layout for Max
  84.                2.0, and all of the commands are already installed.  As long
  85.                as you didn't make any major modifications to your menu
  86.                structure, you can type "copy menus.200 menus.ctl" to
  87.                install the new menus.  If you choose this method, you can
  88.                skip ahead to step IV.
  89.  
  90.                IF YOU ARE USING CUSTOMIZED MENUS, adding the new commands
  91.                is a multistep process:
  92.  
  93.                A.   ADD the following line just before the end of the main
  94.                     menu:
  95.  
  96.                     Display_Menu    Reader     Disgrace "Off-line reader"
  97.  
  98.                B.   ADD the following lines anywhere in the message menu:
  99.  
  100.                     Msg_Browse                 Disgrace "Browse messages"
  101.                     Msg_Current                Disgrace "*ReadCurrent"
  102.                     Msg_Tag                    Disgrace "Tag areas"
  103.                     Msg_Edit_User                 Sysop "@Edit user"
  104.  
  105.                C.   DELETE the following commands from the message menu. 
  106.                     These commands still work, but B)rowse will do
  107.                     everything that these commands do (and more), so
  108.                     there's no reason to keep them around.
  109.  
  110.                     Msg_Scan                   Disgrace "Scan; your msgs"
  111.                     Msg_Inquire                Disgrace "Inquire"
  112.  
  113.  
  114.  
  115.                D.   RENAME the following command in the file areas.  The
  116.                     "T" key is now used by Tag, so we had to rename the
  117.                     command to VIEW:
  118.  
  119.                REPLACE THIS:
  120.  
  121.                     Type                       Disgrace "Type (show)"
  122.  
  123.                WITH THIS:
  124.  
  125.                     Type                       Disgrace "View text file"
  126.  
  127.                E. ADD this to the file menu:
  128.  
  129.                     File_Tag                   Disgrace "Tag (queue) files"
  130.  
  131.                F. RENAME the following command on the CHANGE menu:
  132.  
  133.                REPLACE THIS:
  134.  
  135.                     Chg_Realname                  SysOp "Real name"
  136.  
  137.                WITH THIS:
  138.  
  139.                     Chg_Alias                     SysOp "Alias"
  140.  
  141.                G. ADD these commands to the CHANGE menu:
  142.  
  143.                     Chg_Language               Disgrace "@Language"
  144.                     Chg_Userlist               Disgrace "%ShowInUserlist"
  145.                     Chg_Protocol               Disgrace "$Protocol default"
  146.                     Chg_Archiver               Disgrace "&Archiver default"
  147.                     Chg_FSR                    Disgrace "^FullScrnRead"
  148.  
  149.                H. ADD the following menu to the end of MENUS.CTL:
  150.  
  151.           Menu READER
  152.                 Title           READER
  153.                 Headerfile      Misc\OLR_Hdr
  154.                 
  155.                 % Name of cmd   Optional  Priv.   Command as it
  156.                 % to execute    argument  Level   appears to user
  157.                 % ------------  -------- -------- --------------
  158.                 
  159.                 Msg_Tag                  Disgrace "Tag area"
  160.                 Msg_Browse               Disgrace "Download new msgs" "tnp"
  161.                 Msg_Upload_QWK           Disgrace "Upload replies"
  162.                 Chg_Protocol             Disgrace "Protocol default"
  163.                 Chg_Archiver             Disgrace "Archiver default"
  164.                 Display_Menu    Main         Twit "Main menu"
  165.                 Goodbye                      Twit "Goodbye (log off)"
  166.                 Display_File    Hlp\OLR  Disgrace "?help"
  167.           NoDsp Display_Menu    Main         Twit "|"
  168.  
  169.  
  170.  
  171.           End Menu
  172.  
  173.  
  174.           IV.  Edit the events file in EVENTSxx.BBS to suit your system,
  175.                and make a separate copy of EVENTSxx.BBS for each node.  The
  176.                events file now controls the operation of the Y)ell command
  177.                (n addition to external events for the WFC subsystem)
  178.  
  179.           V.   RECOMPILE YOUR CONTROL FILES
  180.  
  181.                From the Max system directory, type "silt max -u".  This
  182.                will recompile all of the main control files using the Max
  183.                2.0 format.
  184.  
  185.           You are done!  Step back, grab your favourite beverage, and
  186.           enjoy.  You can start version 2.00 by simply typing "max" at the
  187.           command prompt.  However, this conversion procedure only adds the
  188.           essential features to your control files.  For more information
  189.           on all of the new goodies not covered in this document, please
  190.           refer to WHATSNEW.PRN.
  191.  
  192.                                          ###