Single Mouse README
Version 1.1
Support for OS/2
July 30, 2003


Contents
========
1. Overview
2. Prerequisite support
3. Installation instructions
4. Uninstall instructions
5. Notes on supported hardware compatibility
6. Copyright and Trademark Information


1. Overview
=============

This INSTALL.EXE driver package provides you with IBM's most current support
for Mouse and TrackPoint devices on the OS/2 Operating System.

In the past there were two separate drivers - generic mouse driver MOUSE.SYS
(automatically installed during OS/2 installation) and optional TrackPoint
driver MOUSE2.SYS (located in the \OPTIONS\TP4\ directory on your OS/2
installation CD-ROM).

The Single Mouse package combines the functionality of both these drivers into one.
Now all mouse and TrackPoint related preferences can be changed in the Mouse object
in [OS/2 System]-[System Setup] folder.


2. Prerequisite support
=========================

Single Mouse will not work with Warp3 or older systems. On Warp4 systems, you must
install XR_M005 (revision 9.029) or later fixpak before you can proceed
with Single Mouse installation.

ThinkPad T30 users should install the Single Mouse package to fix suspend/resume problem
with mouse drivers in Convenience Package for OS/2 Warp 4 or Convenience Package for
OS/2 Warp Server for e-business.


3. Single Mouse installation instructions
==========================================

Create a temporary directory and copy the self extracting package to the directory.
Run executable to extract the installation files to your temporary directory. Package
contains following files:

  - INSTALL.EXE   Executable that installs the Single Mouse support
  - MOUSE.SYS     Universal mouse and TrackPoint driver
  - MOUSE2.SYS    Same as MOUSE.SYS
  - MULTIPT.EXE   Magnifying glass and scrolling support application
  - README.TXT    This file that you are reading
  - SMOUSE.HLP    Help file for Single Mouse specific functions
  - SMOUSE.MSG    Messages for installation application
  - SMOUSE.RSP    Response file for unattended installation
  - USBMOUSE.SYS  USB mice driver
  - WPCONFIG.DLL  WorkPlace Shell functional DLL
  - WPCONMRI.DLL  WorkPlace Shell informational DLL
  - WPSTKMOU.DLL  WorkPlace Shell functional DLL
  - WPSTKMRI.DLL  WorkPlace Shell informational DLL 

Run the installer INSTALL.EXE which will verify that all files required for
installation are present and automatically upgrade installed files to the
latest version.

If the file in Single Mouse package is older than file already installed the
user will be asked whether to use file from package or leave original file
unchanged. Unattended installation can be performed by providing the response file
SMOUSE.RSP. When INSTALL.EXE is run with /X command line parameter, the installer
will perform an unattended installation of the mouse driver.

A list of files copied/replaced/backed-up is created in the file \OS2\SMOUSE.LOG
on your system drive. This file is updated each time you run the mouse installer. 
For changes to become effective a system reboot is required.

Step-by-step instructions:

  1. Open an OS/2 command prompt (window or full screen) and go to the directory
     containing the self extracting package.
  2. Type SMOUSExx.EXE at the command prompt (where xx is your language abbreviation).
  3. Type INSTALL.EXE at the command prompt.
  4. Installer will compare already installed files with files from package, to make sure
     that you are not overwriting them with an older version. If newer file is already
     installed on your machine it will ask whether to overwrite it. In most cases you
     should not - press 'N'.
  5. When all files are verified the program will ask whether to continue. Press 'Y'.
  6. After 'Installation completed' message, reboot the system.


4. Uninstall instructions
===========================

The installation program creates a log file SMOUSE.LOG in x:\OS2\ directory (where x is
our boot drive.) This file contains information about which files have been changed and
where the original files have been backed up.
To perform the uninstall, you should run INSTALL.EXE with the /a:d
command line parameter.


5. Notes on supported hardware compatibility
==============================================

The Single Mouse package is designed to support both an external mouse and the 
built-in TrackPoint mouse on IBM ThinkPads. When the Mouse Properties is opened, the 
"Mouse information" section on the "Information" page will indicate what was 
detected (TrackPoint, TrackPoint and Mouse, or Mouse). 
In some situations, the driver may apply some limitations on functionality to allow these
two devices to coexist on the same machine.  
For example, Microsoft IntelliMouse compatible devices with scrolling wheel or 
mice with a joystick are not hardware compatible with TrackPoint and as a result the
TrackPoint will be automatically disabled in favor of the external mouse on these
configurations.  This is necessary in order to use the scrolling wheel or joystick features
of the external mouse. The TrackPoint is automatically enabled once the incompatible 
mouse is detached.  If the TrackPoint is disabled after booting the system with a 
compatible (simple two or three button ) mouse attached, you may be able to change the
TrackPoint BIOS setting from "AutoDisable" to "Enabled" to correct this behavior.


The Single Mouse Hot-Plug feature may not work for all hardware configurations.  Device 
specific hardware compatibility may cause incorrect device detection or extended mouse
features may not be enabled. If Hot-Plug detection fails, the following sequence may
enable detection:
  1. Suspend the system.
  2. Attach the external mouse.
  3. Resume the system. 

Failure of the external mouse following this sequence indicates Hot-Plug is not supported
for your hardware configuration. 


If the external mouse is detected as a generic PS/2 pointing device there is no way to
determine whether it has two or three buttons. In that case it will be reported to the
operating system that you have three button mouse. As a result some options in the property
pages that are relevant only for three button pointing devices might be displayed even if
your hardware does not support them. If you do not have a three button mouse then the Scrolling
page should be ignored.

There are some mice that are not able to work in combination with TrackPoint even in
compatibility mode. For example, some Kensington mice may only be used when the
TrackPoint is disabled in BIOS.


6. Copyright and Trademark Information
========================================

The following terms are trademarks of International Business Machines
Corporation in the United States and/or other countries:
        IBM             TrackPoint
        OS/2
Other company, product, and service names may be trademarks or service
marks of others.

THE INFORMATION PROVIDED IN THIS README IS PROVIDED "AS IS" WITHOUT 
WARRANTY OF ANY KIND.  IBM DISCLAIMS ALL WARRANTIES, WHETHER 
EXPRESSED OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED 
WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY 
WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING
THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS.

(C) Copyright IBM Corporation, 2001, 2003. All rights reserved.
U.S. Government Users Restricted Rights -- Use, duplication or 
disclosure restricted by GSA ADP Schedule Contract with IBM Corp.