This README file contains the latest information on installing
and uninstalling USB Print Support for OS/2 Warp.

Contents
-----------
1.0 Supported OS/2 versions
2.0 Supported Printers
3.0 Installing USB print support
4.0 Uninstall Instructions
5.0 WSoD installation instructions
6.0 Copyright and Trademark Information



1.0 Supported OS/2 versions
---------------------------

USB print support is designed to work with OS/2 Warp 3 with FixPak35,
OS/2 Warp 4 with Fixpak6, WSoD v2.0 with FixPak11, Warp Server for
e-business or later levels.

2.0 Supported Printers
----------------------

USB print support for OS/2 is designed to serve all the USB printer
class devices which meet USB printer specifications.

This software package is tested on the following USB printer devices:

o Hewlett Packard DeskJet 895Cse
o Hewlett Packard LaserJet 4050 (with USB I/O card)
o Lexmark Optra E310
o Lexmark Optra S1855  (with USB EIO card)
o Lexmark Z51
o Epson Stylus Color 740
o Epson Stylus Color 900
o Epson Stylus Color 1200
o Brother HL-1240
o Brother HL-1250
o Brother HL-2060
o Xerox P1202
o Xerox DocuPrint P8ex


3.0 Installing/upgrading USB print support
--------------------------------

The USBPRTEN.EXE** file contains the following USB print support files in a
self-extracting compressed format:

o README.TXT        The file that you are reading

o USBUHCD.SYS       USB host controller device driver

o USBD.SYS          USB device driver

o USBPRT.SYS        USB physical printer driver

o USBMON.EXE        USB Auto Monitor Executable

o TSTUHCD.EXE       USB host controller presence check routine

o USBPRT.DDP        USB physical driver stack installation profile

o USBPRT.PDR        USB Printer Port driver

o USBPRT.HLP        USB Printer Port driver help file

o RSPDDI.EXE        Physical device driver installation utility

**NOTE: The file name is language dependent, USBPRTEN.EXE is the English version
name.

To expand the USB print support installation files:

1. From the command line, change to the directory containing the
   USBPRTEN.EXE file.

2. Type "USBPRTEN" (without quotes) to expand the files.



To install/upgrade USB printer support:

1.  Open the existing (or create new) printer object properties window.

2.  Select the "Output Port" page.

3.  Select the "Install new port" button (click the right mouse button
    on LPT1 port icon and select the "Install..." menu option to open the
    dialog for the print object).

4.  When the "Install New Port" dialog opens, Sselect the "New port drivers"
    radio button and type the full path to the expanded port driver in the
    "Directory" edit box.

5.  Select "Refresh" , afterwards choose the USB port.

6.  Select "Install" to install the port.

NOTE: Use the DDINSTAL utility from OS/2 command line to reinstall physical
      drivers if notified about install failure during automated install.

7.  Shutdown and restart your operating system if prompted to do so from the 
    previous step.


4.0  Uninstall Instructions
---------------------------

To uninstall the USB print support:

1.  Open the print object and delete all the USB printer ports, disable spooler
    and delete USBPRT.PDR and USBPRD.HLP files from OS2\DLL\ directory.

2.  Delete lines containing USB physical driver names - USBUHCD, USBD, USBPRT
    from CONFIG.SYS file.
NOTE: Do not delete USBUHCD and USBD lines from CONFIG.SYS if other USB device
      drivers are in use.

3.  Delete USBUHCD.SYS, USBD.SYS and USBPRT.SYS files from \os2\boot\
    directory and USBMON.EXE file from \os2\ directory.
NOTE: Do not delete USBUHCD.SYS and USBD.SYS files if other USB device
      drivers are in use.

4.  Delete the "Auto Monitor" object from the "Startup" folder.

5.  Shutdown and restart your operating system.


5.0 WSoD installation instructions
----------------------------------

USB print support package consists of 2 separate components:
1) physical device drivers and auto monitor support utility (files
USBUHCD.SYS, USBD.SYS, USBPRT.SYS, USBMON.EXE);
2) port driver (USBPRT.PDR, USBPRT.HLP).

In order to make physical drivers and utility operational, USBUHCD.SYS,
USBD.SYS, USBPRT.SYS files must be available in the requester's (client
workstation) \os2\boot directory and the utility  - in the requester's
\os2\ directory. CONFIG.SYS file on the requester must contain the
following lines:

BASEDEV=USBUHCD.SYS
BASEDEV=USBD.SYS /REQ:USBUHCD$
DEVICE=<requester boot drive letter>:\OS2\BOOT\USBPRT.SYS

Port driver files USBPRT.PDR and USBPRT.HLP must be available in the
requester's \OS2\DLL directory and the requester OS2SYS.INI file must
contain USBPRT key with the  value
<requester boot drive letter>:\OS2\DLL\USBPRT.PDR for the application
PM_PORT_DRIVER. See the detailed instructions below how to do it.

Auto monitor feature is enabled through a startup item for USBMON.EXE
with the parameter USBPRT for each requester.


One of possible scenarios to enable USB print support for WSoD is the
following (assuming that WSoD related information is located on the
server's drive F: directory \IBMLAN\RPL and the requester boot driver
letter is Z:):

1) stop RPL server -
type the command "NET STOP RPL" (without quotes) in OS/2 command window
on the server.

2) copy port driver files (USBPRT.PDR, USBPRT.HLP) to the
\IBMLAN\RPL\BB20.US\OS2\DLL directory with the following commands:
COPY A:\USBPRT.PDR F:\IBMLAN\RPL\BB20.US\OS2\DLL /B
COPY A:\USBPRT.HLP F:\IBMLAN\RPL\BB20.US\OS2\DLL /B
Remember: use the WSoD server's drive letter instead of F: if needed.

3) copy physical driver files to the \IBMLAN\RPL\BB20.US\OS2\BOOT
directory:
COPY A:\USBPRT.SYS  F:\IBMLAN\RPL\BB20.US\OS2\BOOT /B
COPY A:\USBD.SYS    F:\IBMLAN\RPL\BB20.US\OS2\BOOT /B
COPY A:\USBUHCD.SYS F:\IBMLAN\RPL\BB20.US\OS2\BOOT /B
Remember: use the WSoD server's drive instead of F: if needed. This must
be done even you have USB support already  installed because you need to
update USB Base drivers. Print support may not work with the previous
versions of USB Base drivers. All previously installed USB devices will
work with the new USB Base drivers.

4) copy the auto monitor executable to the \IBMLAN\RPL\BB20.US\OS2
directory:
COPY A:\USBMON.EXE  F:\IBMLAN\RPL\BB20.US\OS2\ /B
Remember: use the WSOD server's drive letter instead of F: if needed.

5) update CONFIG.SYS file for each WSOD requester equipped with USB
host hardware. CONFIG.SYS file for requester  with a name 'machine_name'
resides in F:\IBMLAN\RPL\MACHINES\machine_name directory. Use E text
editor to add lines
BASEDEV=USBUHCD.SYS
BASEDEV=USBD.SYS /REQ:USBUHCD$
DEVICE=Z:\OS2\BOOT\USBPRT.SYS
at the bottom of CONFIG.SYS file.
If you already have USB support installed, then you must add only the
following line to CONFIG.SYS file:
DEVICE=Z:\OS2\BOOT\USBPRT.SYS
Remember: use the requester's boot drive letter instead of Z: if needed.

6) add USBPRT key to the application PM_PORT_DRIVER in OS2SYS.INI file for
each USB enabled user. User's INI file for "user_name" resides in the
F:\IBMLAN\RPLUSER\user_name directory. Use INIEDIT utility to add
USBPRT key - open OS2SYS.INI file (use the "File"->"Other..." menu item to
open the user specific OS2SYS.INI file), open the PM_PORT_DRIVER application
INI file entries, create a new key (select the "Edit"->"Add..." menu item
and fill in the "Key" field in the opened dialog). Open this key item and
set its value to Z:\OS2\DLL\USBPRT.PDR in ASCII entry box, select the
"Null Terminated" checkbox.
Remember: use the requester's boot drive letter instead of Z: if needed.

7) re-create RPL images:
type the command "GETRPL" (without quotes) in OS/2 command window on the
server.

8) start RPL server:
type the command "NET START RPL" (without quotes) in OS/2 command window
on the server.

After booting the requester will have USB Print support enabled.


6.0  Copyright and Trademark Information
----------------------------------------

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

THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF
ANY KIND. IBM DISCLAIMS ALL WARRANTIES, WHETHER
EXPRESS 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 International Business Machines Corporation, 1999.
     All rights Reserved.
