home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-386-Vol-2of3.iso / c / config15.zip / MCFG.DOC next >
Text File  |  1992-08-14  |  16KB  |  382 lines
  1.  
  2.  
  3.                             Multi-Config ver. 1.05
  4.          Copyright (c) 1991 by Olympic Systems. All Rights Reserved.
  5.  
  6.                              === User's Guide ===
  7.  
  8.  
  9.     ----------------------  WHAT IS MULTI-CONFIG?  ----------------------
  10.  
  11.     Normally, when DOS loads the CONFIG.SYS file during the boot process,
  12.     all lines in the file are unconditionally loaded.  Until now, if you
  13.     wanted to customize your system for different hardware, software, or
  14.     memory-management combinations, you had to juggle or swap several
  15.     CONFIG.SYS and AUTOEXEC.BAT files.  Multi-Config is a program which
  16.     takes control of the boot process and allows you to customize your
  17.     system from a "configuration" menu choice at boot-time, all with a
  18.     single CONFIG.SYS file.  Multi-Config allows CONFIG.SYS lines to be
  19.     conditionally loaded based upon your boot-time choice.  If desired,
  20.     Multi-Config can use a default configuration if you do not choose one.
  21.     Your configuration choice can be passed to AUTOEXEC.BAT so portions
  22.     of the batch file also may be conditionally loaded or ignored.
  23.  
  24.     Multi-Config is not a TSR.  It occupies NO memory after it has
  25.     performed its functions, nor does it alter any files.  Multi-Config
  26.     consists of 3 files:  MCFG.SYS, MCFG.EXE, and MCFG.DOC (this file).
  27.     Multi-Config requires MS-DOS 3.0 or higher.  For a complete
  28.     description of Multi-Config features and applications, refer to the
  29.     USAGE and APPLICATIONS sections later in this User's Guide.
  30.  
  31.     -----------------------  LICENSING AGREEMENT  -----------------------
  32.  
  33.     This program is not public domain. Multi-Config was written by Olympic
  34.     Systems which retains the copyright. Multi-Config is being distributed
  35.     through shareware marketing.  If you use Multi-Config, you MUST
  36.     register a license for its use on a per-computer basis and remit the
  37.     appropriate license fee as follows:
  38.  
  39.     1 computer. . . . . . . . . . . . . . . . . . . . . . . . . . . .$15
  40.     Each group of 10 computers. . . . . . . . . . . . . . . . . . . $100
  41.     Each group of 100 computers . . . . . . . . . . . . . . . . . . $500
  42.     Each group of 1000 computers. . . . . . . . . . . . . . . . . .$1000
  43.  
  44.     Make checks (drawn on U.S. bank in U.S. dollars) payable to Olympic
  45.     Systems.  Corporate Purchase Orders are accepted.  The last 2 pages of
  46.     this User's Guide may be printed and used as a Registration Form and
  47.     Mailer for registering your use-license of Multi-Config.  If you do
  48.     not use the Registration Form and Mailer, mail the fee and the
  49.     information requested on the Registration Form to:
  50.  
  51.                                 Olympic Systems
  52.                               4231 King Cotton Ln.
  53.                             Missouri City, TX  77459
  54.  
  55.     You are encouraged to freely distribute unmodified copies of Multi-
  56.     Config in accordance with recognized Users Group guidelines (e.g.,
  57.     Assoc. of Shareware Professionals) for the distribution of shareware.
  58.  
  59.  
  60.     -------------------------  USAGE: MCFG.SYS  -------------------------
  61.  
  62.     MCFG.SYS allows lines in the CONFIG.SYS file to be loaded or ignored
  63.     based upon your configuration menu choice at boot-time.  MCFG.SYS is
  64.     a transient device driver which is loaded by CONFIG.SYS and removes
  65.     itself immediately after performing its functions. MCFG.SYS is loaded
  66.     by a line in CONFIG.SYS like the following:
  67.  
  68.          DEVICE = [path]MCFG.SYS
  69.  
  70.     where [path] is an optional path name (required if MCFG.SYS is not in
  71.     the root directory of the boot drive).  Unlike traditional device
  72.     drivers, MCFG.SYS has 2 special rules which MUST be observed:
  73.  
  74.          - MCFG.SYS must be loaded on the FIRST line of CONFIG.SYS
  75.          - MCFG.SYS must be reloaded on the LAST line of CONFIG.SYS
  76.  
  77.     If MCFG.SYS is not loaded twice as the first and last lines of
  78.     CONFIG.SYS, MCFG.SYS will not work.
  79.  
  80.     Once loaded, MCFG.SYS scans CONFIG.SYS for Configuration Names which
  81.     you have added to lines in your CONFIG.SYS file.  MCFG.SYS will then
  82.     present a list of all of the Configuration Names and wait for your
  83.     selection.  Those lines having a Configuration Name which matches
  84.     your selection will be loaded; those lines having different
  85.     Configuration Names will be ignored. For example, the line
  86.  
  87.          device = <MY_SETUP>mouse.sys
  88.  
  89.     contains the Configuration Name MY_SETUP.  MOUSE.SYS will only be
  90.     loaded if you choose the MY_SETUP configuration at boot-time.
  91.  
  92.     Configuration Names may be placed on ANY line in CONFIG.SYS other
  93.     than the FIRST or LAST lines which load MCFG.SYS.  Lines without
  94.     Configuration Names will always be loaded.  Configuration Names are
  95.     delimited by '<' and '>' characters (eg: <name>).  MCFG.SYS is case
  96.     insensitive (Configuration Names are converted to upper case).
  97.  
  98.     There are certain rules which must be observed when creating
  99.     Configuration Names:
  100.  
  101.          - they must be the first text after the '=' on any line
  102.          - they must start with the '<' character and end with the '>'
  103.            character
  104.          - they must be 30 characters or less (excluding '<' and '>')    
  105.          - they CANNOT contain any white space characters (space, tab, etc.)
  106.          - white space between the '=' and the Configuration Name is allowed
  107.            (like normal CONFIG.SYS lines) but white space between the
  108.            Configuration Name and the remainder of line is NOT allowed
  109.          - a maximum of 46 unique Configuration Names are allowed
  110.  
  111.     Multiple Configuration Names may be placed on any line.  For example:
  112.  
  113.          device = <MY_SETUP><BOB>ansi.sys
  114.  
  115.     will load the ANSI.SYS driver if either the MY_SETUP or the BOB
  116.     configuration is selected.  Note that there can be no space between
  117.     multiple Configuration Names.
  118.  
  119.  
  120.     There is one predefined Configuration Name of "<?>" which can be used
  121.     to force a boot-time prompt whether to load a particular line. This
  122.     may be useful for lines which don't belong in a permanent configuration
  123.     or which require user intervention.  The prompt will display the
  124.     original line contents (excluding the "<?>") and ask if this line is to
  125.     be loaded. If "<?>" is used on a line with multiple Configuration Names,
  126.     your response can be used to override preceding Configuration Names.
  127.     As a reminder of this overriding characteristic, the Configuration
  128.     Names preceding the "<?>" are not displayed in the prompt.
  129.  
  130.     MCFG.SYS has the following optional command line arguments:
  131.  
  132.          DEFAULT=CONFIG_NAME
  133.               This argument instructs MCFG.SYS to automatically select
  134.               CONFIG_NAME after a delay (waiting for your choice) has
  135.               expired.  There can be no spaces between "DEFAULT=" and the
  136.               Configuration Name.  If this argument is not specified,
  137.               MCFG.SYS will wait indefinitely for your choice.
  138.  
  139.          DELAY=4
  140.               If DEFAULT has been specified, this argument sets the delay
  141.               (in seconds) before the DEFAULT configuration is selected; if
  142.               DEFAULT is specified with no DELAY, DELAY is 5. DELAY must be
  143.               a single digit from 0 to 9 (where 0 causes immediate loading
  144.               of the DEFAULT configuration). There can be no spaces between
  145.               "DELAY=" and the digit. If any key is pressed during the
  146.               delay, automatic loading of the default configuration is
  147.               canceled and MCFG.SYS will wait indefinitely for your choice.
  148.  
  149.          PASS
  150.               This argument tells MCFG.SYS to pass the configuration choice
  151.               to MCFG.EXE program so that AUTOEXEC.BAT can use the choice
  152.               for conditional loading of batch file lines.  DO NOT use this
  153.               option unless MCFG.EXE is the first line in AUTOEXEC.BAT (see
  154.               below).
  155.  
  156.     Command line arguments are only needed on the first MCFG.SYS line
  157.     (arguments on the last MCFG.SYS line are ignored).  Command line
  158.     arguments are case insensitive.
  159.  
  160.     -------------------------  USAGE: MCFG.EXE  -------------------------
  161.  
  162.     MCFG.EXE is a program which, if used, must be run as the first command
  163.     in AUTOEXEC.BAT to receive the configuration choice from MCFG.SYS.  If
  164.     PASS was specified on the MCFG.SYS command line, MCFG.EXE will receive
  165.     the choice and create an environment variable ("MCFG=CONFIG_NAME")
  166.     which can be used in batch language "GOTO" or "IF" statements. MCFG.EXE
  167.     must be the FIRST line in your AUTOEXEC.BAT file and cannot have its
  168.     output redirected to the NUL device.
  169.  
  170.     If MCFG.EXE reports that no configuration information was passed from
  171.     MCFG.SYS, either (1) MCFG.SYS was not successfully loaded in the
  172.     CONFIG.SYS file, (2) no Configuration Names were specified in the
  173.     CONFIG.SYS file, (3) the PASS argument was not specified on the
  174.     MCFG.SYS command line, or (4) MCFG.EXE was run previously and has
  175.     retrieved the information.
  176.  
  177.  
  178.     ---------------------------  APPLICATIONS  --------------------------
  179.  
  180.     MCFG.SYS and MCFG.EXE are useful for setting up and optimizing your
  181.     system for unique configurations.  Multi-Config eliminates the need for
  182.     the cumbersome "multiple CONFIG.SYS and AUTOEXEC.BAT" approach which
  183.     was required to work around the restrictive way MS-DOS handles the
  184.     CONFIG.SYS file.  A typical (but brief) CONFIG.SYS file might contain:
  185.  
  186.          device = c:\mcfg.sys DEFAULT=network DELAY=4 PASS
  187.          device = <network>c:\lan\netdrive.sys
  188.          device = mouse.sys
  189.          device = <standard><network>ansi.sys
  190.          device = <windows>c:\windows\smartdrv.sys
  191.          device = <standard><network>ramdrive.sys
  192.          break = on
  193.          device = c:\mcfg.sys
  194.  
  195.     Note that the first and last lines load the MCFG.SYS driver.  At boot-
  196.     time, MCFG.SYS will present a list of configuration choices which
  197.     contains (1) NETWORK, (2) STANDARD, and (3) WINDOWS configurations.
  198.     The DEFAULT and DELAY arguments specify that the NETWORK configuration
  199.     should be used if the user does not press a key within 4 seconds.  The
  200.     PASS argument tells MCFG.SYS to pass the final configuration choice to
  201.     MCFG.EXE which will run in AUTOEXEC.BAT.  This CONFIG.SYS example will
  202.     cause the following:
  203.  
  204.          - netdrive.sys will be loaded only if the NETWORK configuration is
  205.            selected
  206.          - ansi.sys and ramdrive.sys will be loaded if either the STANDARD
  207.            or NETWORK configurations are selected
  208.          - smartdrv.sys will be loaded only if the WINDOWS configuration
  209.            is selected
  210.          - all other lines will be loaded or performed regardless of the
  211.            configuration selection
  212.  
  213.     Additionally, when "test-loading" new drivers or TSRs, you can reserve
  214.     a Configuration Name (such as SAFE_BOOT) which will load a "safe"
  215.     configuration.  This will eliminate the need to boot from floppy disk
  216.     if a new device driver locks up your system while booting.
  217.  
  218.     To continue the preceding example, a typical AUTOEXEC.BAT file might
  219.     contain:
  220.  
  221.          c:\mcfg
  222.          goto %MCFG%
  223.  
  224.          :NETWORK
  225.          c:\lan\netstart 
  226.          path=c:\util;c\lan;
  227.          goto END
  228.  
  229.          :WINDOWS
  230.          path=c:\util;c:\windows;
  231.          goto END
  232.  
  233.          :STANDARD
  234.          path=c:\util;
  235.          goto END
  236.  
  237.          :END
  238.          if %MCFG%==NET netshell
  239.          if %MCFG%==WINDOWS win
  240.  
  241.  
  242.     Note that the first line ran the MCFG.EXE program and put the
  243.     configuration choice into the MCFG environment variable.  The MCFG
  244.     environment variable then can be used in the AUTOEXEC.BAT file through
  245.     batch language substitution for "%MCFG%".
  246.  
  247.     This example uses a "GOTO" to execute the section of AUTOEXEC.BAT
  248.     which is specific to the selected configuration. "IF" is also used to
  249.     conditionally run single commands.
  250.  
  251.     The MCFG environment variable which is set by MCFG.EXE may be used by
  252.     later programs if those programs need to know which configuration you
  253.     selected at boot-time. Conversely, you may clear the MCFG environment
  254.     variable by using the DOS command "set MCFG=".
  255.  
  256.     ----------------------------  DISCLAIMER  ---------------------------
  257.  
  258.     Due to the nature of shareware software distribution and electronic
  259.     media transfer, this product is distributed AS IS.  In no event shall
  260.     the authors be liable for any loss of profit or any other damage
  261.     resulting from its use.  Olympic Systems makes no warranty of any kind,
  262.     expressed or implied, including without limitation, any warranties of
  263.     merchantability and/or fitness for a particular purpose.
  264.  
  265.     ----------------------  FEATURES NEW TO v1.05  ----------------------
  266.  
  267.     - Multi-Config now allows up to 46 unique Configuration Names.
  268.       Previously, only 20 Configuration Names were permitted.
  269.  
  270.     - Multi-Config now allows multiple Configuration Names on each line
  271.       in CONFIG.SYS.  A line with multiple Configuration Names will be
  272.       loaded if any of its Names is selected from the choice menu.
  273.  
  274.     - The prompt displayed when Multi-Config encounters the "<?>"
  275.       Configuration Name has been expanded to show the entire CONFIG.SYS
  276.       line.
  277.  
  278.  
  279.  
  280.          ====  MULTI-CONFIG v1.05 REGISTRATION FORM AND MAILER  ====
  281.  
  282.  
  283.  
  284. Remit To:                      Olympic Systems
  285.                              4231 King Cotton Ln.
  286.                           Missouri City, TX  77459
  287.  
  288.  
  289.  
  290.          Qty                                               Total
  291.  
  292.        _______  1-computer registration      @ $15       $_______
  293.  
  294.        _______  10-computer registration     @ $100      $_______
  295.  
  296.        _______  100-computer registration    @ $500      $_______
  297.  
  298.        _______  1000-computer registration   @ $1000     $_______
  299.  
  300.  
  301.                           Registration Total ------>      $_______
  302.  
  303.  
  304.  
  305.  
  306. Payment by:  [ ]check (U.S. bank)  [ ]purchase order #_____________________
  307.  
  308.  
  309.  
  310.  
  311. Name: _____________________________________________________________________
  312.  
  313. Company: __________________________________________________________________
  314.  
  315. Address: __________________________________________________________________
  316.  
  317.          __________________________________________________________________
  318.  
  319.          __________________________________________________________________
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.                         ====  MAILER INSTRUCTIONS  ====
  333.     Fold at the page break below with the printing facing out.  Then fold
  334.     letter style at the "fold here" lines, exposing the mailing address and
  335.     hiding your Registration Form.  Place check in the mailer, then tape
  336.     sides and top to seal the mailer.
  337.  
  338.  
  339. _________________________________                                     Place
  340.  
  341. _________________________________                                     Stamp
  342.  
  343. _________________________________                                     Here
  344.  
  345.  
  346.  
  347.  
  348.  
  349.                                     Olympic Systems
  350.                                     4231 King Cotton Ln.
  351.                                     Missouri City, TX  77459
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359. ------------------------------- (2) fold here -------------------------------
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381. ------------------------------- (1) fold here -------------------------------
  382.