                           Win32Prn
                            v1.0.0b
                          Release Candidate
                   (c) 2002-2004 Vit Timchishin
                     winprn32@gtech-ua.com
                   http://www.gtech-ua.com/vit

1. Introduction

This package allows OS/2 users to run Windows 2000 printer drivers under OS/2
and eComStation using the Odin project (http://odin.netlabs.org).
Testing new printers that are supported is great.
Please also report printers that work!! Even testing a printer already
supported by native drivers under OS/2 with the Windows 2000 is a good contri-
bution. This version still has a lot of points that require you todo things
manualy. First the base system needs to be tested and fine tuned before
things can be enhanced futher.

2. Requirements

MS Windows 2000 (installed on a system this need will change with later
releases)
OS/2 Warp 4 with fixpak 13 or higher
eComStation 1.0 or 1.1
Warp Server for e-business or eComServer.

Odin (latest debug or release build; debug prefered for better bug reports)

3. Installation
3.1. Package installation on OS/2 an or eComStation system:

1) Download ODIN
   You can get daily builds of ODIN from the following location:
   ftp://odin.netlabs.org/pub/odin/Daily/
   Download file of with the name is:
   odin32bin-xxxxxxxx-release.zip (xxxxxxxxxx is the date of archive).

2) Create a directory called ODIN.

3) Unzip the odin zipfile you just downloaded into the
   odin directory.

4) Create a directory for the Win32Prn project (for example c:\win32prn)

5) Put the Win32Prn files in the created directory.

6) Open your config.sys in an editor and add to the line LIBPATH and SET PATH
   at the end of the line(for example): "C:\win32prn;" .

   For the ODIN installation:
   Also add to the end of the LIBPATH and SET PATH the line
   X:\ODIN\SYSTEM32. Where X: is the drive you created the directory ODIN.

   Also make certain your config.sys contains the following statement:

   VIRTUALADDRESSLIMIT=2048

   The value 2048 can also be increased to 3072. The best value to use is
   2048.

   Save your config.sys and restart the system

7) After the reboot just from an OS/2/eCS command run the program
   odininst.exe (you can just start it will be started automaticly).
   When its finished you cursor will return to the command line.

3.2. Instaltion of Win32PRN into ODIN32.INI:

Add the following lines to odin.ini:
(Odin.INI is located in the directory \ODIN\SYSTEM32):
1)
[DLLRENAMEWIN] section:
WINSPOOL.DRV=WSPLPRN.DLL
WINSPOOL=WSPLPRN.DLL
GDI32=PRN32GD.DLL
GDI32ORG=GDI32.DLL
WSPLORIG=WINSPOOL.DLL

2)
[DLLRENAMEOS2] section
WSPLPRN=WINSPOOL.DRV
WINSPOOL=WSPLORIG
GDI32=GDI32ORG
PRN32GD=GDI32

If there are entries with the same names in the odin.ini, remove old lines first
(i.e. remove WINSPOOL.DRV=WINSPOOL.DLL line).

Save the file odin.ini

3.3. Printer driver installation in OS/2

To install virtual prnwin32 driver in OS/2 system:
1) Run win32prn daemon (see Running below)
2) Install at least one windows driver into OS/2 (see below)
2) Create new printer object by dragging and dropping Printer template to
free space.
3) In dialog, select "Install new printer driver..." button
4) Click "Other OS/2 printer driver"
5) Into directory entry box enter path to prnwin32 directory
6) Click refresh
7) Select needed driver and click install

3.4. Installing additional Windows printer driver

To install additional printer driver into OS/2 printing suubsystem:
1) Run win32prn daemon (see Running below)
2) Install windows driver into OS/2 (see below)
3) Select properties for printer object
4) Select printer driver tab
5) On Existing PRNWIN32 printer driver press right mouse button
6) Select "Install", "New device"
7) Select needed driver and click install

3.5. Installing Windows printer driver into OS/2

Since win32prn project can't provide printer properties dialog yet,
each printer object from windows can be represented as distinct device kind.
So, you can create "My Printer 300 dpi" and "My Printer 600 dpi" or
"My printer double-sided" Printers in Windows, then copy them to OS/2 and
use as different printer devices.
Next steps are needed to transfer set up of windows printer to OS/2:
Note: You must use Local Printer under windows to transfer properties,
not Network printer even if you wish to print to network from OS/2.
1) Set up properties under windows
2) Run under windows wprn32e utility provided with win32prn package
3) Export settings of the printer you need into a file by selecting printer
   and pressing "Export" button.
4) Import resulting files into OS/2 regedit2 using "File" -> "Import Registry File" command
5) You will also need to transfer driver files. They can be usually found under winnt\system32\spool\drivers\w32x86\3 directory. List of needed files can be found in the inf file supplied with drivers.
6) Add directory with printer driver files to OS/2 PATH

3.6. Setting up OS/2 printer object

You will need to set "Queue options" ->
"printer-specific format" for OS/2 printer object

4. Running the project

To run the project you will need to start prn32d daemon.
Note: Start it minimized or detached because it will output a lot of
debugging info.

5. Known bugs and limitations
5.1. Black and white only

6. Working drivers database

Note that this database contains information about printers tested.
Actually project supports virtually any printer that has MS Windows
drivers.

Printer                 Driver name/version         Results

Canon LBP-810           CAPT 1.00.1.012d            OK
Epson EPL-N2050/PS+     3.31                        OK
HP LaserJet 1100        unidrv/WinXP                OK
Samsung ML-1210         JustWay 1.43.09             OK

Note: Unidrv means standard drivers from Windows OS, not OEM ones.

7. Contacts

Please e-mail me with any results to winprn32@gtech-ua.com
Also Project page is available at my home page: http://www.gtech-ua.com/vit

8. Bug reports

Bug reports are welcome.
It is highly recommended to use debug versions of the project and Odin to
produce report Next information is needed to be supplied with bug report
(along with report description):
1) Printer name
2) Printer driver name & version
3) REG files you've imported
4) POPUPLOG.OS2 entries if any
5) Bug kind (trap, error screen, nothing printed, blank page printed, error
page printed)
6) Any log files (odin*.log, pe*.log) produced by the daemon. To produce full
log files, please add
"SET WIN32LOG_ENABLED=1" statement to the config.sys or CMD file you are using
to run prn32d.exe.
7) Syslog output produced by the OS/2 win32prn driver
    ( to create the file, "C:\]start syslogd" before trying to print,
      then look for \MPTN\ETC\syslog.msg,syslog.000,syslog.001,... files)
(If you have any trouble with the steps above in paragraph 8 send an email
to rwklein@mensys.nl, English please).

9. License

This program is provided "AS IS". Author is not responsible for any
problems you have. You may distribute this program if you want.
But you should distribute only the original archive without any changes.
Please note the final version will be shareware of this product.

10. Trademarks.
All trademarks belong to there respected owners.