
         OS/2 DOCKING SUPPORT FOR THE IBM THINKPAD DOCK II

The initial release of OS/2 Docking Support provides basic warm-docking and
hot-swapping support for the IBM ThinkPad 755CE, 755CSE, 755CD, 755CV, 755CDV,
and 755CX computers that have the Dock II desktop docking station.
This software package consists of 6 device drivers and a graphical user
interface (GUI) for controlling docking operations.

The Docking Support package is being distributed on various computer
network bulletin boards and as part of the pre-installed OS/2 software on
new IBM ThinkPad computers.

This README file is formatted for viewing on your screen.  You can:

-  Use the Table of Contents to help you locate specific topics.
-  Use the Find option in the Edit menu of the OS/2 System Editor to help
   you locate specific information.
-  Print the entire file.


IMPORTANT

PLEASE READ THE FOLLOWING TERMS AND CONDITIONS.  YOUR USE OF THE OS/2
DOCKING SUPPORT FOR THE IBM DOCK II INDICATES YOUR ACCEPTANCE OF THE
FOLLOWING TERMS AND CONDITIONS:

o  YOU MUST BE A LICENSEE OF OS/2.
o  YOU MAY MAKE COPIES OF THE OS/2 DOCKING SUPPORT FOR THE IBM DOCK II
   EQUAL TO THE NUMBER OF LICENSED COPIES OF OS/2 YOU POSSESS.
o  ALL OTHER TERMS AND CONDITIONS OF YOUR OS/2 LICENSE AGREEMENT APPLY TO
   THIS OS/2 DOCKING SUPPORT FOR THE IBM DOCK II; HOWEVER, THIS DOES NOT
   EXTEND ANY WARRANTY OUTLINED IN SUCH AGREEMENT.

CONTENTS
________


     1.0 Supported Features
     1.1 Warm-Docking Operations
     1.2 Hot-Swapping Operations
     1.3 Diskette Support
     1.4 CD-ROM Support
     1.5 SCSI Support

     2.0 Installation Instructions
     2.1  CID Installation

     3.0 Compatibility

     4.0 Functional Restrictions

     5.0 Trademarks







    1.0 SUPPORTED FEATURES

    1.1 WARM-DOCKING OPERATIONS

Supported IBM ThinkPad computers can be inserted into ("docked") or removed
from ("undocked") the Dock II without being powered down or restarted.
During docking operations the user can select either "pass-thru" or
"full-dock" docking mode.

The GUI distributed with this package includes detailed online help to
describe user actions and options presented during docking and undocking
operations.  For information about mechanical docking and undocking
procedures, refer to the IBM ThinkPad Dock II Users Guide (Part #84G9682).

In pass-thru docking mode, the ThinkPad video, serial, parallel, keyboard,
and mouse ports are connected to corresponding ports on the Dock II.  If
the Dock II has externally connected devices (keyboard, mouse, or display),
the ThinkPad will use these devices in parallel with its own devices.
While docked in pass-thru mode, the ThinkPad uses external power from the
Dock II, and its internal battery is charged, if needed.

In full-dock mode, the system performs all pass-thru functions, and also
provides access to any recognized SCSI and PCMCIA peripherals installed in
the Dock II.

With this release of OS/2 Docking Support, any IDE devices installed in the
Dock II, or any controllers installed in Dock II ISA slots, will be
recognized only after a system cold start with the ThinkPad fully docked.


    1.2 HOT-SWAPPING OPERATIONS

With OS/2 Docking Support, the ThinkPad 755CD user can swap the under-
keyboard CD-ROM drive for the under-keyboard diskette drive
and attach an external diskette drive to the clam-shell adapter,
without powering down or restarting the system.

Configurations possible with hot-swapping are:

  Configuration:               755-CE   755-CSE   755-CD
    1 diskette drive             x        x         x
    1 CD                                            x
    1 diskette drive, 1 CD                          x
    2 diskette drives            x        x         x


    1.3  DISKETTE-DRIVE SUPPORT

The DOC1FLPY.ADD driver has all of the CONFIG.SYS options currently
documented for IBM1FLPY.ADD.  In addition, it includes a new /FORCE:n
parameter, which indicates that the driver will force (emulate) n number of
diskette drives.  The allowable values for the /FORCE parameter are 1 or 2.
Also, the existing /F:x parameter must be specified in conjunction with the
new /FORCE:  parameter to define the drive capacity of the emulated
diskette drives.  The allowable values for the /F: parameter, when used
with the /FORCE: parameter are 1.44MB or 2.88MB.  (Note:  These are the
only sizes of IBM diskette drives supported by the ThinkPad.)

In the following example, the CONFIG.SYS statement specifies that a single
1.44MB diskette drive is to be emulated when the drive is not physically
present:

         BASEDEV=DOC1FLPY.ADD /A:0 /FORCE:1 /U:0 /F:1.44MB

If /FORCE:2 is specified, two diskette drives (drives A and B) will be

         BASEDEV=DOC1FLPY.ADD /A:0 /FORCE:2 /U:0 /F:1.44MB /U:1 /F:2.88MB

emulated, even though neither drive is physically present.  Drive A will
always be under the ThinkPad keyboard, and drive B will be treated as an
external diskette drive attached to the clam-shell adapter.  This means
that if the CD-ROM is currently installed under the keyboard, all diskette-
drive operations must be directed to drive B.  Drive A operations will
fail, and a device-not-ready message will be returned.


    1.4  CD-ROM SUPPORT

Two Drivers (DOC1S506.ADD and DOCIDECD.FLT) provide IDE CD-ROM support.
These drivers support all of the CONFIG.SYS options currently documented
for the standard IBM IDE device drivers:

         DOC1S506.ADD ->IBM1S506.ADD
         DOCIDECD.FLT ->IBMIDECD.FLT

The DOCIDECD.FLT driver includes a new /F parameter.  This parameter
indicates that the filter driver must emulate the presence of any ATAPI
devices supported by the DOC1S506.ADD driver, even when the hardware is not
physically present.  In addition, the DOC1S506.ADD driver's existing /A:x,
/U:y, and /ATAPI parameters must be specified in conjunction with the new
/F parameter of the DOCIDECD.FLT driver to define the ATAPI device's
physical adapter number and unit number.

In the following example, the CONFIG.SYS statements specify CD-ROM
emulation for the ThinkPad 755CD:

         BASEDEV=DOC1S506.ADD /A:1 /U:0 /ATAPI
         BASEDEV=DOCIDECD.FLT /F

Elements of the preceding CONFIG.SYS examples can be combined to form an
example showing device swapping (diskette drive and CD-ROM drive) for the
ThinkPad 755CD:

         BASEDEV=DOC1S506.ADD /A:1 /U:0 /ATAPI
         BASEDEV=DOCIDECD.FLT /F
         BASEDEV=DOC1FLPY.ADD /A:0 /FORCE:1 /U:0 /F:1.44MB


    1.5  SCSI SUPPORT

Two Drivers (DOCSCSI.DMD and DOC152X.ADD) provide SCSI support for the
Adaptec AIC-6360 system board SCSI adapter.  These drivers support all
of the CONFIG.SYS options currently documented for the standard IBM SCSI
device drivers:

         DOCSCSI.DMD   -> OS2SCSI.DMD
         DOC152X.ADD   -> AHA152X.ADD

The DOC152X.ADD driver includes a new /F parameter.  This parameter
indicates that the adapter driver must emulate the presence of all SCSI
devices for the adapter identified in the option string, even when the
hardware is not physically present.

In the following example, the CONFIG.SYS statements specify emulation
of all 7 SCSI devices on the first SCSI adapter:

         BASEDEV=DOC152X.ADD /A:0 /F:0,1,2,3,4,5,6
         BASEDEV=DOCSCSI.DMD


    2.0 INSTALLATION INSTRUCTIONS


To install:

1) Open a OS2 window or full screen

2) Go to the directory or diskette that contains the dock manager files

3) Type INSTALL and press Enter
    The Dock Manager Install Options screen appears.

4) Select the options you want and click the INSTALL button.
   The Dock Manager Install panel appears.

5) Click OK

6) Shutdown the system and restart for changes to take affect.


    2.1  CID INSTALLATION

1) Open a OS2 window or full screen

2) Go to the directory or diskette that contains the dock manager files

3) Type  INSTALL <target drive letter> [/d /o /s /a /b]

     and press ENTER

          where:

         target drive letter is the drive that the target machine boots from

         /d - install Device Swapping Support
         /o - install DockII Support
         /s - install SCSI Device Support (also installs DockII support)
         /a - install Floppy Device Support for machines with
              only 'A' drive present (also installs DockII support)
         /b - install Floppy Device Support for machines with
              'A' and 'B' drives present (also installs DockII support)

   For example, to install DockII Support and Floppy Device Support
   to the 'R' drive for a machine with only a single floppy drive,
   type the following:

          INSTALL R: /o /a


    3.0  COMPATIBILITY

OS/2 Docking Support is compatible with OS/2 Warp Version 3 and later
versions of OS/2. This warm docking program only works on
the IBM ThinkPad 755CE, 755CSE, 755CD, 755CV, 755CDV,
and 755CX computers.


    4.0  FUNCTIONAL RESTRICTIONS


1.  Warm docking support requires your OS/2 system to be installed in
    a FAT partition.  HPFS formatted data partitions are supported.

2.  IDE devices in the Dock II are not supported after warm-docking
    operations.  The ThinkPad must be fully docked, and a system cold start
    must be performed.

3.  Currently, the system will recognize no more than 4 SCSI devices after
    a warm docking.

4.  If disk partitions are removed or changed, or physical drives are
    removed, the FAUXDASD.FLT and FAUXREM.FLT device drivers must be
    returned to their initial, as-shipped states.
    The original versions of these files may be obtained from this package's
    distribution disk. Copy them to OS2\BOOT before restarting the system
    after removing or changing disk partitions.
    If disk drives are being removed, copy these
    files to OS2\BOOT before shutting down and removing the drives.

5.  Dock II ISA slots are not recognized after a warm docking.

6.  If you are unable to undock your ThinkPad while in the Full Dock
    mode, verify that the Hot Dock/Undock option is enabled.

    If it is enabled, save all open applications and shutdown and
    undock using the EJECT button.

    If it is disabled, select Hot Dock/Undock and click OK to enable.
    You should now be able to undock.

7.  Multimedia for Presentation Manager (MMPM) does not currently respond
    to Advanced Power Management (APM) requests for suspend and resume.
    Undocking causes a system suspension, resulting in a loss of system
    sounds. Restarting the ThinkPad will restore system sounds on the
    undocked ThinkPad.
    Before doing a dock or undock operation, all audio and video
    applications must be closed and all system sounds must be completed.

8.  Error messages may refer to files that have been renamed as shown
    below:

       IBM1FLPY.ADD  ->  DOC1FLPY.ADD
       IBM1S506.ADD  ->  DOC1S506.ADD
       IBMIDECD.FLT  ->  DOCIDECD.FLT
       AHA152X.ADD   ->  DOC152X.ADD
       OS2SCSI.ADD   ->  DOCSCSI.DMD

9.  Currently, there is no keyboard sequence recognized by the GUI to cause
    the system to shift from pass-thru docking mode to full-dock mode. This
    operation requires a mouse.



    5.0 TRADEMARKS

The following terms are trademarks of the IBM Corporation in the United
States or other countries:

    Dock II
    IBM
    OS/2
    Presentation Manager
    ThinkPad

Other company, product, and service names may be trademarks or service
marks of others.

