USB Removable Media and CDROM Device Driver README
Version 1.0
Support for OS/2
July 19, 2001
(c) Copyright International Business Machines Corporation, 1998-2001.
    All rights Reserved.


Contents
========
1.0  Overview
2.0  USB-Removable Media and CDROM Driver Installation Instructions
3.0  USB-Removable Media and CDROM Driver Un-Install Instructions
4.0  Requirements
5.0  Configuration parameters
6.0  OS/2 Warp 4 boot from diskettes through USB floppy drive
   6.1 Introduction
   6.2 Modifying the Diskette 1
   6.3 Modifying the Diskette 2   
   6.4 OS/2 Warp 4 boot from diskettes through USB floppy drive
7.0  Copyright and Trademark Information

1.0  Overview
=============

This USBSTOR.EXE driver package provides you with IBM's most current support
for Universal Serial Bus (USB) Removable Media and CDROM devices on the OS/2
Operating System.

1.1  The USBSTOR.EXE file that you received contains the following 5 USB
     files in a self-extracting compressed format.

        -  README.TXT    This file that you are reading
        -  USBMSD.ADD    USB Removable Media Device Driver
        -  USBCDROM.ADD  USB CDROM Device Driver (placeholder)
        -  USBMSD.DDP    Device driver profile file
        -  TSTUSBD.EXE   Tests USB Stack

2.0  USB-Removable and CROM Media Installation Instructions
===========================================================

2.1  To use these USB driver files, you must expand the USBSTOR.EXE file into
     its 5 component files by
        (a.) opening an OS/2 window and
        (b.) typing USBSTOR at the OS/2 command prompt.
     Once the USBSTOR.EXE file is expanded, please continue with the
     USB Installation Instructions.

2.2  Device Driver Install
      o   (Warp 3, Warp Server) Open the Device Driver Install program
          in the OS/2 System Folder/System Setup Folder.

      o   (Warp 4, Warp Server for e-business) Open the Device Driver
          Install program in the OS/2 System/System Setup/Install-Remove
          Folder.

2.3 Change Source directory to current (where component files reside) by pressing
    "Change..." button.

2.4 Press "Install..." button to perform actual installation and "Exit" button
    installtion utility.

2.5 This completes the installation procedure. You must now REBOOT you system
    to initialize the USB removable media / CDROM device driver support.


3.0  USB-Removable Media / CDROM Un-Install Instructions
========================================================

3.1  Delete from CONFIG.SYS file lines configuring USBMSD.ADD and USBCDROM.ADD
     (lines starting with BASEDEV=USBMSD.ADD and BASEDEV=USBCDROM.ADD) and files
     USBMSD.ADD, USBCDROM.ADD from \os2\boot directory.

3.2  Safely shut down and then re-boot your system in order to remove the
     USB Removable Media/CDROM drivers from the system configuration.

4.0  Requirements
=================

4.1  Hardware
     Removable media/CDROM drivers are designed to work with all devices manufactured
     according USB mass storage device specifications. Tests are performed for
     following devices:
     VST and Newer Technology USB Floppy Drives
     Imation or Winstation SuperDisk (LS-120) drives
     IOMega 100MB and 250MB portable USB ZIP drives
     HP USB CDWriter 8200
     USB Sony Supressa CD-RW

4.2  Software
     (a.) USB Basic support, this include USBD.SYS driver and host controller
     driver(s) (USBUHCD.SYS and/or USBOHCD.SYS) distributed as separate packages.

     (b.) UDF file system from package "DVD/UDF Support for OS/2" must be installed
     on system in order to use CD-RW devices and media for data recording and retrieval.

     (c.) OS2CDROM.DMD from package "Fixed IDE Hard Drive and Removable Media Support"
     (IDEDASD.EXE) must be installed on system in order to use CD-RW devices and media
     for data recording and retrieval.
     
5.0  Configuration parameters
=============================

After installation USB-Removable Media / CDROM drivers serve 1 floppy device
(including LS-120 Super Disk devices), 1 removable media device (like IOMEGA
ZIP drive) and 1 CD-ROM/CD-RW device. 

Number of devices served for each device category may be changed using
CONFIG.SYS parameters.

PARAMETER       FUNCTION

/CDS:n	        Number of CD-ROM/CD-RW devices to be served (by default 1). This parameter
                is used in the statement BASEDEV=USBCDROM.ADD. For example, the
                statement BASEDEV=USBCDROM.ADD /CDS:2 serves 2 CD-ROM/CD-RW devices.
                In order to remove service the key value must be set to 0.

                NOTE: For Warp 3 systems number of CDROM devices served must be coded on
                USBMSD.ADD CONFIG.SYS line like BASEDEV=USBMSD.ADD /CDS:1.

/FLOPPIES:n     Number of floppy devices to be served (by default 1). In order to remove service the
                key value must be set to 0.

/REMOVABLES:n   Number of removable media devices to be served (by default 1).
                For example, the statement BASEDEV=USBMSD.ADD /FLOPPIES:2 /REMOVABLES:3
                serves 2 floppy devices (including LS-120 Super Disk devices),
                3 removable media devices (like IOMEGAZIP drive). In order to remove
                service the key value must be set to 0.

Removable media volumes can be processed as large floppies or partitioned volumes (default processing type). You can serve removable disks as partitioned volumes.

PARAMETER                  FUNCTION

/REMOVABLE_AS_FLOPPY       System uses removable disks as partitioned volumes:
                           BASEDEV=USBMSD.ADD /REMOVABLE_AS_FLOPPY

/MP : (device_number, partition_count)
                           Number of partitions for device number (by default 1).
                           This parameter is used in BASEDEV=OS2DASD.DMD line.
                           For example BASEDEV=OS2DASD.DMD /MP:2,2

6.0 OS/2 Warp 4 boot from diskettes through USB floppy drive
    ========================================================
6.1 Introduction
    ------------
To boot OS/2 Warp 4 from diskettes 2 sets of floppy disks can be used:
        - Installation Diskettes,
        - Utility Diskettes.
        
Installation diskettes are a set of three diskettes (Installation Diskette,
Diskette 1, and Diskette 2) that allow you to start (boot) OS/2 Warp 4, and
begin installation process from OS/2 Warp 4 CD. To create Installation
Diskettes run CDINST command file in OS/2 Warp 4 CD root directory and
follow the directions on your screen.

Utility diskettes are a set of four diskettes (Diskette 0...3) that allows
you to boot OS/2 Warp 4, and get to a command line session. To create Utility
Diskettes run Create Utility Diskettes utility in the System Setup folder
on your desktop. Simply double-clicking on the Icon and inserting diskettes
when required will create these diskettes.

You need to modify the Diskettes 1 and 2 to boot OS/2 Warp 4 from diskettes
through Universal Serial Bus (USB) floppy drive using USB keyboard.

If you are not using Convenience Package 2 for OS/2 Warp 4, you must use 
latest versions of the USB drivers and device dependent keyboard driver
(IBMKBD.SYS).

To boot OS/2 Warp 3 with latest FixPacks from diskettes through USB floppy
drive you need to modify only Diskette 1 using latest versions of the USB
drivers, device dependent keyboard driver (IBMKBD.SYS), and resource manager
(RESOURCE.SYS) (for example, from the Convenience Package 2 for OS/2 Warp 4).

6.2 Modifying the Diskette 1
    ------------------------
6.2.1 Make sure the following statemrnt exists in the CONFIG.SYS file:

SET SAVECONNECT=1

6.2.2 You can add the following statement to ensure that the USB drivers are
copied from diskettes throughout the installation process:

SET COPYFROMFLOPPY=1

6.2.3 Add the following sequence (important) of statements to the CONFIG.SYS
file on Diskette 1:

BASEDEV=USBD.SYS /I13
BASEDEV=USBUHCD.SYS
BASEDEV=USBMSD.ADD

BASEDEV=USBHID.SYS
DEVICE=USBKBD.SYS
    
NOTES:
- Two last statements must be added if you are using USB keyboard throughout
  the installation process.
- The /I13 parameter must be specified to ensure proper BIOS support during
  boot process. If this parameter is specified USBD.SYS driver delays switching
  on USB support via base stack drivers to allow access to USB devices using BIOS
  calls. This parameter must be used only for system installation from specially
  prepared floppy disk set.
- For systems with N USB host controllers host controller driver must be
  specified for each hardware controller.
  For example, IBM ThinkPad T23 computer requires the following sequence of
  statements (3 hardware USB host controllers onboard):

BASEDEV=USBD.SYS /I13
BASEDEV=USBUHCD.SYS
BASEDEV=USBUHCD.SYS
BASEDEV=USBUHCD.SYS      
BASEDEV=USBMSD.ADD
...

6.2.4 Add (copy) the following USB Device Drivers to the Diskette 1:
- USB Driver (USBD.SYS),
- USB Universal Host Controller Driver (USBUHCD.SYS),
- USB Mass Storage Device Adapter Device Driver (USBMSD.ADD).

If you are using USB keyboard throughout the installation process:
- add the USB Human Interface Device driver (USBHID.SYS) to the Diskette 1,
- copy the latest version of device dependent keyboard driver (IBMKBD.SYS)
  over the existing file on Diskette 1 if you are not using Convenience
  Package 2 for OS/2 Warp 4.

6.2.5 If there is not enough space on the Diskette 1, you can try the
following procudures before you copy USB drivers. For each file you delete
from the diskette 1, you must also remove or comment out the corresponding
statement from CONFIG.SYS and from the SNOOP.LST.

If you are not using a SCSI adapter, you can delete one or more of the
following files:
AHA152X.*       AIC7770.*       DPT20XX.*       QL10OS2.*
AHA154X.*       AIC7870.*       FLASHPT.*       QL40OS2.*
AHA164X.*       AIC78U2.*                       QL510.*
AHA174X.*

If you are not using a RAID system, you can delete the following files:
DAC960.*        IPSRAID.*

6.3 Modifying the Diskette 2
    ------------------------
6.3.1 If you are using USB keyboard throughout the installation process
add (copy) the USB KeyBoard Driver (USBKBD.SYS) to the Diskette 2.

6.3.2 If there is not enough space on the Diskette 2, you can remove the
following files before you copy USBKBD.SYS driver to the Diskette 2:
TEDIT.*         RMVIEW.EXE      NPXEMLTR.DLL
                RMINFO.DLL

6.4 OS/2 Warp 4 boot from diskettes through USB floppy drive
    --------------------------------------------------------
6.4.1 Enable USB boot in the BIOS Setup.

6.4.2 Place the Installation Diskette 0 in your USB floppy drive and
restart your system. Follow the instructions to add other diskettes
when required.

7.0 Copyright and Trademark Information
=======================================

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

