home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 4 Drivers / 04-Drivers.zip / warmdock.zip / README.TXT < prev    next >
Text File  |  1995-06-30  |  12KB  |  318 lines
  1.  
  2.          OS/2 DOCKING SUPPORT FOR THE IBM THINKPAD DOCK II
  3.  
  4. The initial release of OS/2 Docking Support provides basic warm-docking and
  5. hot-swapping support for the IBM ThinkPad 755CE, 755CSE, 755CD, 755CV, 755CDV,
  6. and 755CX computers that have the Dock II desktop docking station.
  7. This software package consists of 6 device drivers and a graphical user
  8. interface (GUI) for controlling docking operations.
  9.  
  10. The Docking Support package is being distributed on various computer
  11. network bulletin boards and as part of the pre-installed OS/2 software on
  12. new IBM ThinkPad computers.
  13.  
  14. This README file is formatted for viewing on your screen.  You can:
  15.  
  16. -  Use the Table of Contents to help you locate specific topics.
  17. -  Use the Find option in the Edit menu of the OS/2 System Editor to help
  18.    you locate specific information.
  19. -  Print the entire file.
  20.  
  21.  
  22. IMPORTANT
  23.  
  24. PLEASE READ THE FOLLOWING TERMS AND CONDITIONS.  YOUR USE OF THE OS/2
  25. DOCKING SUPPORT FOR THE IBM DOCK II INDICATES YOUR ACCEPTANCE OF THE
  26. FOLLOWING TERMS AND CONDITIONS:
  27.  
  28. o  YOU MUST BE A LICENSEE OF OS/2.
  29. o  YOU MAY MAKE COPIES OF THE OS/2 DOCKING SUPPORT FOR THE IBM DOCK II
  30.    EQUAL TO THE NUMBER OF LICENSED COPIES OF OS/2 YOU POSSESS.
  31. o  ALL OTHER TERMS AND CONDITIONS OF YOUR OS/2 LICENSE AGREEMENT APPLY TO
  32.    THIS OS/2 DOCKING SUPPORT FOR THE IBM DOCK II; HOWEVER, THIS DOES NOT
  33.    EXTEND ANY WARRANTY OUTLINED IN SUCH AGREEMENT.
  34.  
  35. CONTENTS
  36. ________
  37.  
  38.  
  39.      1.0 Supported Features
  40.      1.1 Warm-Docking Operations
  41.      1.2 Hot-Swapping Operations
  42.      1.3 Diskette Support
  43.      1.4 CD-ROM Support
  44.      1.5 SCSI Support
  45.  
  46.      2.0 Installation Instructions
  47.      2.1  CID Installation
  48.  
  49.      3.0 Compatibility
  50.  
  51.      4.0 Functional Restrictions
  52.  
  53.      5.0 Trademarks
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.     1.0 SUPPORTED FEATURES
  62.  
  63.     1.1 WARM-DOCKING OPERATIONS
  64.  
  65. Supported IBM ThinkPad computers can be inserted into ("docked") or removed
  66. from ("undocked") the Dock II without being powered down or restarted.
  67. During docking operations the user can select either "pass-thru" or
  68. "full-dock" docking mode.
  69.  
  70. The GUI distributed with this package includes detailed online help to
  71. describe user actions and options presented during docking and undocking
  72. operations.  For information about mechanical docking and undocking
  73. procedures, refer to the IBM ThinkPad Dock II Users Guide (Part #84G9682).
  74.  
  75. In pass-thru docking mode, the ThinkPad video, serial, parallel, keyboard,
  76. and mouse ports are connected to corresponding ports on the Dock II.  If
  77. the Dock II has externally connected devices (keyboard, mouse, or display),
  78. the ThinkPad will use these devices in parallel with its own devices.
  79. While docked in pass-thru mode, the ThinkPad uses external power from the
  80. Dock II, and its internal battery is charged, if needed.
  81.  
  82. In full-dock mode, the system performs all pass-thru functions, and also
  83. provides access to any recognized SCSI and PCMCIA peripherals installed in
  84. the Dock II.
  85.  
  86. With this release of OS/2 Docking Support, any IDE devices installed in the
  87. Dock II, or any controllers installed in Dock II ISA slots, will be
  88. recognized only after a system cold start with the ThinkPad fully docked.
  89.  
  90.  
  91.     1.2 HOT-SWAPPING OPERATIONS
  92.  
  93. With OS/2 Docking Support, the ThinkPad 755CD user can swap the under-
  94. keyboard CD-ROM drive for the under-keyboard diskette drive
  95. and attach an external diskette drive to the clam-shell adapter,
  96. without powering down or restarting the system.
  97.  
  98. Configurations possible with hot-swapping are:
  99.  
  100.   Configuration:               755-CE   755-CSE   755-CD
  101.     1 diskette drive             x        x         x
  102.     1 CD                                            x
  103.     1 diskette drive, 1 CD                          x
  104.     2 diskette drives            x        x         x
  105.  
  106.  
  107.     1.3  DISKETTE-DRIVE SUPPORT
  108.  
  109. The DOC1FLPY.ADD driver has all of the CONFIG.SYS options currently
  110. documented for IBM1FLPY.ADD.  In addition, it includes a new /FORCE:n
  111. parameter, which indicates that the driver will force (emulate) n number of
  112. diskette drives.  The allowable values for the /FORCE parameter are 1 or 2.
  113. Also, the existing /F:x parameter must be specified in conjunction with the
  114. new /FORCE:  parameter to define the drive capacity of the emulated
  115. diskette drives.  The allowable values for the /F: parameter, when used
  116. with the /FORCE: parameter are 1.44MB or 2.88MB.  (Note:  These are the
  117. only sizes of IBM diskette drives supported by the ThinkPad.)
  118.  
  119. In the following example, the CONFIG.SYS statement specifies that a single
  120. 1.44MB diskette drive is to be emulated when the drive is not physically
  121. present:
  122.  
  123.          BASEDEV=DOC1FLPY.ADD /A:0 /FORCE:1 /U:0 /F:1.44MB
  124.  
  125. If /FORCE:2 is specified, two diskette drives (drives A and B) will be
  126.  
  127.          BASEDEV=DOC1FLPY.ADD /A:0 /FORCE:2 /U:0 /F:1.44MB /U:1 /F:2.88MB
  128.  
  129. emulated, even though neither drive is physically present.  Drive A will
  130. always be under the ThinkPad keyboard, and drive B will be treated as an
  131. external diskette drive attached to the clam-shell adapter.  This means
  132. that if the CD-ROM is currently installed under the keyboard, all diskette-
  133. drive operations must be directed to drive B.  Drive A operations will
  134. fail, and a device-not-ready message will be returned.
  135.  
  136.  
  137.     1.4  CD-ROM SUPPORT
  138.  
  139. Two Drivers (DOC1S506.ADD and DOCIDECD.FLT) provide IDE CD-ROM support.
  140. These drivers support all of the CONFIG.SYS options currently documented
  141. for the standard IBM IDE device drivers:
  142.  
  143.          DOC1S506.ADD ->IBM1S506.ADD
  144.          DOCIDECD.FLT ->IBMIDECD.FLT
  145.  
  146. The DOCIDECD.FLT driver includes a new /F parameter.  This parameter
  147. indicates that the filter driver must emulate the presence of any ATAPI
  148. devices supported by the DOC1S506.ADD driver, even when the hardware is not
  149. physically present.  In addition, the DOC1S506.ADD driver's existing /A:x,
  150. /U:y, and /ATAPI parameters must be specified in conjunction with the new
  151. /F parameter of the DOCIDECD.FLT driver to define the ATAPI device's
  152. physical adapter number and unit number.
  153.  
  154. In the following example, the CONFIG.SYS statements specify CD-ROM
  155. emulation for the ThinkPad 755CD:
  156.  
  157.          BASEDEV=DOC1S506.ADD /A:1 /U:0 /ATAPI
  158.          BASEDEV=DOCIDECD.FLT /F
  159.  
  160. Elements of the preceding CONFIG.SYS examples can be combined to form an
  161. example showing device swapping (diskette drive and CD-ROM drive) for the
  162. ThinkPad 755CD:
  163.  
  164.          BASEDEV=DOC1S506.ADD /A:1 /U:0 /ATAPI
  165.          BASEDEV=DOCIDECD.FLT /F
  166.          BASEDEV=DOC1FLPY.ADD /A:0 /FORCE:1 /U:0 /F:1.44MB
  167.  
  168.  
  169.     1.5  SCSI SUPPORT
  170.  
  171. Two Drivers (DOCSCSI.DMD and DOC152X.ADD) provide SCSI support for the
  172. Adaptec AIC-6360 system board SCSI adapter.  These drivers support all
  173. of the CONFIG.SYS options currently documented for the standard IBM SCSI
  174. device drivers:
  175.  
  176.          DOCSCSI.DMD   -> OS2SCSI.DMD
  177.          DOC152X.ADD   -> AHA152X.ADD
  178.  
  179. The DOC152X.ADD driver includes a new /F parameter.  This parameter
  180. indicates that the adapter driver must emulate the presence of all SCSI
  181. devices for the adapter identified in the option string, even when the
  182. hardware is not physically present.
  183.  
  184. In the following example, the CONFIG.SYS statements specify emulation
  185. of all 7 SCSI devices on the first SCSI adapter:
  186.  
  187.          BASEDEV=DOC152X.ADD /A:0 /F:0,1,2,3,4,5,6
  188.          BASEDEV=DOCSCSI.DMD
  189.  
  190.  
  191.     2.0 INSTALLATION INSTRUCTIONS
  192.  
  193.  
  194. To install:
  195.  
  196. 1) Open a OS2 window or full screen
  197.  
  198. 2) Go to the directory or diskette that contains the dock manager files
  199.  
  200. 3) Type INSTALL and press Enter
  201.     The Dock Manager Install Options screen appears.
  202.  
  203. 4) Select the options you want and click the INSTALL button.
  204.    The Dock Manager Install panel appears.
  205.  
  206. 5) Click OK
  207.  
  208. 6) Shutdown the system and restart for changes to take affect.
  209.  
  210.  
  211.     2.1  CID INSTALLATION
  212.  
  213. 1) Open a OS2 window or full screen
  214.  
  215. 2) Go to the directory or diskette that contains the dock manager files
  216.  
  217. 3) Type  INSTALL <target drive letter> [/d /o /s /a /b]
  218.  
  219.      and press ENTER
  220.  
  221.           where:
  222.  
  223.          target drive letter is the drive that the target machine boots from
  224.  
  225.          /d - install Device Swapping Support
  226.          /o - install DockII Support
  227.          /s - install SCSI Device Support (also installs DockII support)
  228.          /a - install Floppy Device Support for machines with
  229.               only 'A' drive present (also installs DockII support)
  230.          /b - install Floppy Device Support for machines with
  231.               'A' and 'B' drives present (also installs DockII support)
  232.  
  233.    For example, to install DockII Support and Floppy Device Support
  234.    to the 'R' drive for a machine with only a single floppy drive,
  235.    type the following:
  236.  
  237.           INSTALL R: /o /a
  238.  
  239.  
  240.     3.0  COMPATIBILITY
  241.  
  242. OS/2 Docking Support is compatible with OS/2 Warp Version 3 and later
  243. versions of OS/2. This warm docking program only works on
  244. the IBM ThinkPad 755CE, 755CSE, 755CD, 755CV, 755CDV,
  245. and 755CX computers.
  246.  
  247.  
  248.     4.0  FUNCTIONAL RESTRICTIONS
  249.  
  250.  
  251. 1.  Warm docking support requires your OS/2 system to be installed in
  252.     a FAT partition.  HPFS formatted data partitions are supported.
  253.  
  254. 2.  IDE devices in the Dock II are not supported after warm-docking
  255.     operations.  The ThinkPad must be fully docked, and a system cold start
  256.     must be performed.
  257.  
  258. 3.  Currently, the system will recognize no more than 4 SCSI devices after
  259.     a warm docking.
  260.  
  261. 4.  If disk partitions are removed or changed, or physical drives are
  262.     removed, the FAUXDASD.FLT and FAUXREM.FLT device drivers must be
  263.     returned to their initial, as-shipped states.
  264.     The original versions of these files may be obtained from this package's
  265.     distribution disk. Copy them to OS2\BOOT before restarting the system
  266.     after removing or changing disk partitions.
  267.     If disk drives are being removed, copy these
  268.     files to OS2\BOOT before shutting down and removing the drives.
  269.  
  270. 5.  Dock II ISA slots are not recognized after a warm docking.
  271.  
  272. 6.  If you are unable to undock your ThinkPad while in the Full Dock
  273.     mode, verify that the Hot Dock/Undock option is enabled.
  274.  
  275.     If it is enabled, save all open applications and shutdown and
  276.     undock using the EJECT button.
  277.  
  278.     If it is disabled, select Hot Dock/Undock and click OK to enable.
  279.     You should now be able to undock.
  280.  
  281. 7.  Multimedia for Presentation Manager (MMPM) does not currently respond
  282.     to Advanced Power Management (APM) requests for suspend and resume.
  283.     Undocking causes a system suspension, resulting in a loss of system
  284.     sounds. Restarting the ThinkPad will restore system sounds on the
  285.     undocked ThinkPad.
  286.     Before doing a dock or undock operation, all audio and video
  287.     applications must be closed and all system sounds must be completed.
  288.  
  289. 8.  Error messages may refer to files that have been renamed as shown
  290.     below:
  291.  
  292.        IBM1FLPY.ADD  ->  DOC1FLPY.ADD
  293.        IBM1S506.ADD  ->  DOC1S506.ADD
  294.        IBMIDECD.FLT  ->  DOCIDECD.FLT
  295.        AHA152X.ADD   ->  DOC152X.ADD
  296.        OS2SCSI.ADD   ->  DOCSCSI.DMD
  297.  
  298. 9.  Currently, there is no keyboard sequence recognized by the GUI to cause
  299.     the system to shift from pass-thru docking mode to full-dock mode. This
  300.     operation requires a mouse.
  301.  
  302.  
  303.  
  304.     5.0 TRADEMARKS
  305.  
  306. The following terms are trademarks of the IBM Corporation in the United
  307. States or other countries:
  308.  
  309.     Dock II
  310.     IBM
  311.     OS/2
  312.     Presentation Manager
  313.     ThinkPad
  314.  
  315. Other company, product, and service names may be trademarks or service
  316. marks of others.
  317.  
  318.