home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: SysTools / SysTools.zip / printusb.zip / usbprint.txt < prev    next >
Text File  |  2001-12-21  |  10KB  |  282 lines
  1. USBPRINT README
  2.  
  3. October 15, 2001
  4.  
  5.     OS/2 Device Driver Development
  6.     IBM Solution Technologies
  7.     Austin, TX
  8.  
  9. This README contains information
  10. for the Universal Serial Bus (USB) Print Support for
  11. IBM OS/2 Warp 3.0 release with FixPak35,
  12. OS/2 Warp 4 with Fixpak6,
  13. WSoD v2.0 with FixPak11,
  14. OS/2 Warp Server for e-business,
  15. OS/2 Warp 4 Convenience Pack 1,
  16. OS/2 Warp 4 Convenience Pack 2,
  17. OS/2 Warp Server for e-business Convenience Pack 1,
  18. OS/2 Warp Server for e-business Convenience Pack 2.
  19.  
  20.  
  21. CONTENTS
  22. ________
  23.  
  24. 1.0  Introduction
  25. 2.0   USB-Print Support
  26.     2.1  USB Print Support Installation/upgrading
  27.     2.2  5.0 WSoD installation instructions
  28.     2.3  USB Print Driver Additional Parameters
  29.     2.4  USB Print Support Un-Install Instructions
  30.     2.5  List of Supported USB-Printers
  31.     2.6  Requirements
  32.     2.7  Dependencies
  33. 3.0  Copyright and Trademark Information
  34.  
  35.  
  36. 1.0  Introduction
  37. _________________
  38.  
  39. This USBPRTEN.EXE driver package provides you with IBM's most current support
  40. for Universal Serial Bus (USB) print devices on the OS/2 Operating System.
  41.  
  42. 1.1  The USBPRTEN.EXE** file that you received contains the following
  43.      files in a self-extracting compressed format.
  44.  
  45.     -  USBPRINT.TXT  This file that you are reading
  46.     -  RSPDDI.EXE    Physical device driver installation utility
  47.     -  USBPRT.SYS    USB physical printer driver
  48.     -  USBPRT.SYM    
  49.     -  USBMON.EXE    USB Auto Monitor Executable
  50.     -  USBPRT.DDP    USB physical driver stack installation profile
  51.     -  USBPRT.PDR    USB Printer Port driver
  52.     -  USBPRT.HLP    USB Printer Port driver help file
  53.     -  CLEANUP.CMD   Command file that deletes all USB print support
  54.              files from installation directory to release disk
  55.              space after installation
  56.         -  TSTUSBC.EXE   Tests USB Stack
  57.  
  58. **NOTE: The file name is language dependent, USBPRTEN.EXE is the English version
  59. name.
  60.  
  61.  
  62. 2.0  USB-Print Support
  63. ______________________
  64.  
  65. 2.1  USB-Print Installation/upgrading
  66. =====================================
  67.  
  68. 2.1.1    To use these USB driver files, you must expand the USBPRTEN.EXE
  69.     file into its component files by
  70.          (a.) opening an OS/2 window and
  71.             (b.) typing USBPRTEN at the OS/2 command prompt.
  72.     Once the USBPRTEN.EXE file is expanded, please continue with the
  73.         USB Installation Instructions.
  74.  
  75. 2.1.2   Open the existing (or create new) printer object properties window.
  76.  
  77. 2.1.3   Select the "Output Port" page.
  78.  
  79. 2.1.4   Select the "Install new port" button (click the right mouse button
  80.     on LPT1 port icon and select the "Install..." menu option to open
  81.     the dialog for the print object).
  82.  
  83. 2.1.5   When the "Install New Port" dialog opens, select the "New port
  84.     drivers" radio button and type the full path to the expanded port
  85.     driver in the "Directory" edit box.
  86.  
  87. 2.1.6   Select "Refresh" , afterwards choose the USB port.
  88.  
  89. 2.1.7   Select "Install" to install the port.
  90.  
  91. NOTE:    Use the DDINSTAL utility from OS/2 command line to reinstall physical
  92.           drivers if notified about install failure during automated install.
  93.  
  94.     If USBBASIC stack was not installed on the system you will see the message
  95.     "The file, TSTUSBC.EXE, returned a non-zero return code.This DDP file
  96.     did not run." You have to install USBBASIC before installing USBPRTEN.EXE.
  97.  
  98. 2.1.8   Shutdown and restart your operating system if prompted to do so
  99.     from the previous step.
  100.  
  101.  
  102. 2.2  WSoD installation instructions
  103. ===================================
  104.  
  105. USB print support package consists of 2 separate components:
  106. 1) physical device driver and auto monitor support utility (files
  107. USBPRT.SYS, USBMON.EXE);
  108. 2) port driver (USBPRT.PDR, USBPRT.HLP).
  109.  
  110. In order to make physical driver and utility operational USBPRT.SYS
  111. file must be available in the requester's (client workstation)
  112. \os2\boot directory and the utility  - in the requester's
  113. \os2\ directory. CONFIG.SYS file on the requester must contain the
  114. following lines:
  115.  
  116. DEVICE=<requester boot drive letter>:\OS2\BOOT\USBPRT.SYS
  117.  
  118. Port driver files USBPRT.PDR and USBPRT.HLP must be available in the
  119. requester's \OS2\DLL directory and the requester OS2SYS.INI file must
  120. contain USBPRT key with the  value
  121. <requester boot drive letter>:\OS2\DLL\USBPRT.PDR for the application
  122. PM_PORT_DRIVER. See the detailed instructions below how to do it.
  123.  
  124. Auto monitor feature is enabled through a startup item for USBMON.EXE
  125. with the parameter USBPRT for each requester.
  126.  
  127.  
  128. One of possible scenarios to enable USB print support for WSoD is the
  129. following (assuming that WSoD related information is located on the
  130. server's drive F: directory \IBMLAN\RPL and the requester boot driver
  131. letter is Z:):
  132.  
  133. 1) stop RPL server -
  134. type the command "NET STOP RPL" (without quotes) in OS/2 command window
  135. on the server.
  136.  
  137. 2) copy port driver files (USBPRT.PDR, USBPRT.HLP) to the
  138. \IBMLAN\RPL\BB20.US\OS2\DLL directory with the following commands:
  139. COPY A:\USBPRT.PDR F:\IBMLAN\RPL\BB20.US\OS2\DLL /B
  140. COPY A:\USBPRT.HLP F:\IBMLAN\RPL\BB20.US\OS2\DLL /B
  141. Remember: use the WSoD server's drive letter instead of F: if needed.
  142.  
  143. 3) copy physical driver file to the \IBMLAN\RPL\BB20.US\OS2\BOOT
  144. directory:
  145. COPY A:\USBPRT.SYS  F:\IBMLAN\RPL\BB20.US\OS2\BOOT /B
  146. Remember: use the WSoD server's drive instead of F: if needed.
  147.  
  148. Note:    You may be needed to update USB Base drivers.
  149.     Print support may not work with the previous versions of
  150.     USB Base drivers. All previously installed USB devices will
  151.     work with the new USB Base drivers.
  152.  
  153. 4) copy the auto monitor executable to the \IBMLAN\RPL\BB20.US\OS2
  154. directory:
  155. COPY A:\USBMON.EXE  F:\IBMLAN\RPL\BB20.US\OS2\ /B
  156. Remember: use the WSOD server's drive letter instead of F: if needed.
  157.  
  158. 5) update CONFIG.SYS file for each WSOD requester equipped with USB
  159. host hardware. CONFIG.SYS file for requester  with a name 'machine_name'
  160. resides in F:\IBMLAN\RPL\MACHINES\machine_name directory. Use E text
  161. editor to add lines
  162. DEVICE=Z:\OS2\BOOT\USBPRT.SYS
  163. at the bottom of CONFIG.SYS file.
  164. Remember: use the requester's boot drive letter instead of Z: if needed.
  165.  
  166. 6) add USBPRT key to the application PM_PORT_DRIVER in OS2SYS.INI file for
  167. each USB enabled user. User's INI file for "user_name" resides in the
  168. F:\IBMLAN\RPLUSER\user_name directory. Use INIEDIT utility to add
  169. USBPRT key - open OS2SYS.INI file (use the "File"->"Other..." menu item to
  170. open the user specific OS2SYS.INI file), open the PM_PORT_DRIVER application
  171. INI file entries, create a new key (select the "Edit"->"Add..." menu item
  172. and fill in the "Key" field in the opened dialog). Open this key item and
  173. set its value to Z:\OS2\DLL\USBPRT.PDR in ASCII entry box, select the
  174. "Null Terminated" checkbox.
  175. Remember: use the requester's boot drive letter instead of Z: if needed.
  176.  
  177. 7) re-create RPL images:
  178. type the command "GETRPL" (without quotes) in OS/2 command window on the
  179. server.
  180.  
  181. 8) start RPL server:
  182. type the command "NET START RPL" (without quotes) in OS/2 command window
  183. on the server.
  184.  
  185. After booting the requester will have USB Print support enabled.
  186.  
  187.  
  188. 2.3 USB Print Driver Additional Parameters
  189. ==========================================
  190.  
  191. DEVICE=drive:\OS2\BOOT\USBPRT.SYS
  192.  
  193.        Where drive: is the drive letter of the OS/2 boot partition on your
  194.        system.
  195.  
  196. PARAMETER     FUNCTION
  197.  
  198.   /V        Verbose Mode, displays driver information
  199.         during OS/2 initialization.
  200.  
  201.   /LPT        Set driver name as LPTn (by default name is $USBPRT).
  202.  
  203.  
  204. 2.4  USB Print Support Un-Install Instructions
  205. ==============================================
  206.  
  207. 2.4.1    Open the print object and delete all the USB printer ports, disable
  208.     spooler and delete USBPRT.PDR and USBPRD.HLP files from OS2\DLL\
  209.     directory.
  210.  
  211. 2.4.2    Delete line containing USB physical driver name - USBPRT
  212.     from CONFIG.SYS file.
  213.  
  214. 2.4.3    Delete USBPRT.SYS file from \os2\boot\ directory and USBMON.EXE
  215.     file from \os2\ directory.
  216.  
  217. 2.4.4    Delete the "Auto Monitor" object from the "Startup" folder.
  218.  
  219. 2.4.5    Shutdown and restart your operating system.
  220.  
  221.  
  222. 2.4 List of Supported USB-Printers
  223. ==================================
  224.  
  225. This software package is tested on the following USB printer devices:
  226.  
  227. Hewlett Packard DeskJet 895Cse
  228. Hewlett Packard LaserJet 4050 (with USB I/O card)
  229. Lexmark Optra E310
  230. Lexmark Optra S1855  (with USB EIO card)
  231. Lexmark Z51
  232. Epson Stylus Color 740
  233. Epson Stylus Color 900
  234. Epson Stylus Color 1200
  235. Brother HL-1240
  236. Brother HL-1250
  237. Brother HL-2060
  238. Xerox P1202
  239. Xerox DocuPrint P8ex
  240.  
  241.  
  242. 2.5 Requirements
  243. ================
  244.  
  245. 2.5.1  Hardware
  246.     USBPRT.SYS is designed to work with any standard USB printer.
  247.  
  248. 2.5.2  Software
  249.        (a.) USB Basic support
  250.  
  251.  
  252. 2.6 Dependencies
  253. ================
  254.  
  255. This package contains only USB-Printer support, in order to
  256. use USB-Printers USB base stack driver package (USBBASIC.EXE)
  257. must also be installed.
  258.  
  259.  
  260. 3.0  Copyright and Trademark Information
  261. ________________________________________
  262.  
  263. The following terms, are registered trademarks of the International 
  264. Business Machines Corporation in the United States, or other countries,
  265. or both:
  266. o IBM
  267. o OS/2
  268. o Warp
  269.  
  270. Other company, product, and service names may be trademarks or service
  271. marks of others.
  272.  
  273. THE INFORMATION PROVIDED IN THIS README IS PROVIDED "AS IS" WITHOUT 
  274. WARRANTY OF ANY KIND.  IBM DISCLAIMS ALL WARRANTIES, WHETHER 
  275. EXPRESSED OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED 
  276. WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY 
  277. WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING
  278. THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS.
  279.  
  280. (C) Copyright IBM Corporation, 2001. All rights reserved.
  281. U.S. Government Users Restricted Rights -- Use, duplication or 
  282. disclosure restricted by GSA ADP Schedule Contract with IBM Corp.