    Multi Mouse Mode Utility
    Copyright (C) 1998 Compaq Computer Corporation. All rights reserved.

    Usage: MMODE       : Show current MMMODE nv/cmos setting
           MMODE  ON   : Enable  multiple mouse mode (default)
           MMODE  OFF  : Disable multiple mouse mode
           MMODE  ?    : Display usage / help info

           MMODE  D    : Manually Disable internal mouse
           MMODE  E    : Manually Enable internal mouse

    

    1.  Operation of the MMMODE.COM utility
    ---------------------------------------

        ON          :   Turns the Multi-Mouse Mode ON. This is the
                        default state of all shipping machines.
                        
                        The internal mouse, and all attached PS2
                        mice will be active at the same time.

                        Some machines may need to be rebooted for
                        this setting to take effect.

        OFF         :   Turns the Multi-Mouse Mode OFF.

                        The internal mouse *OR* all attached PS2
                        mice will be active at one time. If there
                        are external mice attached, the internal
                        mouse will be disabled.

                        Some machines may need to be rebooted for
                        this setting to take effect.

        D           :   Manually force the internal mouse off.

                        This command takes effect immediately, but
                        is not remembered across a reboot.

        E           :   Manually force the internal mouse on.

                        This command takes effect immediately, but
                        is not remembered across a reboot.

        <none>      :   If no command-line parameter is given,
                        the utility will report the current state
                        of the multi-mouse mode settings, and will
                        also report whether the internal mouse is
                        currently active or not.

        ?           :   Displays a short usage screen.



    2.  Basic Information:
    ----------------------

    On certain Compaq portable products (including the Armada line 
    of portable computers), Compaq has included a feature called
    "multi-mouse" support. This feature allows multiple PS2 pointing
    devices to be active on the computer simultaneously; for
    example the internal trackpad and an external PS2 mouse might
    be used and active at the same time.

    Some users have requested that they be able to disable the
    internal pointing device when an external mouse is attached to
    the computer. Compaq has agreed to implement this feature in
    its future products, and is in the process of updating the 
    system BIOS for certain current models.
    
    For future products, Compaq will add a new F10/Setup option to
    allow the user to enable or disable the default multi-mouse
    mode. The default state will remain the same as today (ON), 
    but the user will be able to set the mode OFF if they wish.

    For some current products, which do not have a provision in
    F10/Setup to enable/disable multi-mouse mode, Compaq will
    supply a new DOS command-line utility called MMMODE.COM. This
    utility will set the mode, and save the proper flags in the
    computer nonvolatile memory, so that the setting is remembered
    across reboots.

    This document is a description of the MMMODE.COM utility,
    its options, and its limitations.


    3.  Why would I want to disable the default Multi-Mouse Mode?
    -------------------------------------------------------------
    
    Some users do not wish the internal mouse on their portable
    computer to be active when an external mouse is present. Some
    users have found that they occasionally "hit" the internal
    mouse when using the internal keyboard, and wish to avoid
    this when an external mouse is available.


    4.  How does the feature actually work?
    ---------------------------------------

    With multi-mouse mode ON (the default state):

        When the computer system first boots up, it enables all
        PS2 ports, and enables all PS2 mice found. If a mouse
        driver is loaded, all PS2 pointing devices will be
        enabled and active at the same time.

        As you add or remove PS2 mice (while in suspend, or
        due to a dock or undock change), the system properly
        enables/disables the PS2 ports.

    With multi-mouse mode OFF:

        When the computer system first boots up, it checks all
        PS2 ports for external mice. If no external mice are 
        detected, then the internal mouse remains active. If any 
        external mice are detected, then the internal mouse is 
        disabled. 
        
        Note: with some Compaq portable computers, you can plug
        in more than one external PS2 mouse at the same time,
        using both the "Mouse" and "Keyboard" PS2 ports. All
        external mice will be active; only the internal mouse
        will be disabled.

        The computer system will perform the mouse detection
        described above at the following times: 
        
            1.) Reboot
            2.) Resume (from suspend or hibernation)
            3.) Warm-Dock into a docking base
            4.) Warm-Undock out of a docking base
            5.) Hot-Dck into a docking base

            Note that check will NOT be done during a Hot-Undock.

        Some examples of behaviour follow:

        If you hot-plug an external PS2 mouse, the system will
        attempt to enable it, and will NOT disable the internal
        mouse. The internal mouse will remain enabled until
        the next reboot, suspend/resume, or dock event. This
        is done because in some cases PS2 mice do not respond
        properly when "hot" plugged, so we leave the internal
        mouse active to ensure a pointing device is active.

        If you hot-unplug an PS2 external mouse, the system will
        disable the PS2 port, but it will NOT enable the
        internal mouse. The internal mouse will remain in the
        same state (disabled or enabled) that it was in
        prior to hot-unplugging the internal mouse. So, if
        you hot-unplug all your external PS2 mice, you will
        have no pointing devices until the next reboot,
        suspend/resume, or dock event.

        If you dock into a base with an external PS2 mouse, the
        external mouse will become active, and the internal
        mouse will be disabled.

        If you remove an external PS2 mouse while the unit is in a 
        suspend mode, the system will enable the internal mouse
        when you resume.

        If you add an external PS2 mouse while the unit is in a
        suspend mode, the system will disable the internal mouse
        when you resume.
        

    5.  What about Serial mice?
    ---------------------------

        The Multi-Mouse Mode function only works with PS2 mouse.
        This is because the system BIOS cannot detect serial
        mouse devices and manage them in the same way as the 
        built-in PS2 ports.

        However, since some users prefer to use serial mice,
        and still want to disable the internal mouse on some
        occasions, an additional option has been added to the
        MMMODE.COM utility, to allow the user to "manually"
        force the internal mouse On or Off. These are the 
        "E"nable and "D"isable commands.

        NOTES: 

            1.  The "E" and "D" commands are manual commands
                which take effect immediately to enable or 
                disable the internal mouse, irregardless of 
                the multi-mouse mode settings.

            2.  The "E" and "D" commands are not remembered
                across a reboot, nor a suspend/resume cycle.
                After a reboot or resume, the "E" or "D"
                commands must be used again to reset the
                desired state.

            3.  The "E" and "D" commands are supplied as a
                convenience to the user only, and are not
                an officially supported function of the
                MMMODE.COM utility. They may be removed in
                a future release of the MMMOED.COM utility.


    
