source: trunk/doc/manual/ODINUSER.IPF@ 8558

:userdoc.:title.Project Odin User's Manual
:docprof toc=123.
.***************************************************
.*** IPF-Generator Version 0.82 for Framework IV ***
.***************************************************

:h1 res=100 x=right y=bottom width=70% height=100%.Introduction

:font facename='Default' size=0x0.:artwork align=center name='E:\DEV\INF\ODINDOC\ODIN.BMP' .
:lines align=center.:font facename='Helv' size=8x4.:hp2.User's Manual Release 1 (2002&slr.04&slr.14):elines.:font facename='Default' size=0x0.
:p.:ehp2.Odin is a free Open Source project (read about license and warranty :link reftype=hd res=600.here:elink.) with
the goal to eventually provide a fully working
Win95&slr.98&slr.NT&slr.2000&slr.XP runtime environment. This will make it
possible to run your favorite Windows programs under OS&slr.2 (eCS) as if they
were native.

:p.This document's intention is to provide an easy installation guide for Odin
itself and some basic concepts for trying to install and run
Win95&slr.98&slr.ME&slr.NT&slr.2000&slr.XP programs on OS&slr.2 (eCS).

:p.Win95&slr.98&slr.ME&slr.NT&slr.2000&slr.XP programs will be referred to as
Win32 programs in this document as that is what Microsoft calls this
programming model.

:p.This document will not cover all technical details and it is not supposed to
do so.

:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.Odin is still work in progress. It is not complete in any way!

:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.Many (not to say most) programs still do not run with Odin&comma.
but the number of programs that run or partly run has increased dramatically
during the last months.
:p.[Home] [Previous] :link reftype=hd res=200.:hp2.[Next]:elink.:ehp2. 
:i1.purpose of this document
:i1.Win95&slr.98&slr.ME&slr.NT&slr.2000&slr.XP
:i1.What is Odin
:i1.Status of Odin

:h1 res=200 x=right y=bottom width=70% height=100%.How does Odin work?

:font facename='Default' size=0x0.:p.Odin has 2 main tasks to accomplish&colon.
:ol.
:li.:link reftype=hd res=220.Make OS&slr.2 (eCS) load Win32 programs:elink..
:li.:link reftype=hd res=230.Provide an environment:elink. for Win32 programs where they can be
executed.
:eol.
:p.Both tasks are described on the following pages.
:p.:link reftype=hd res=100.:hp2.[Home]:elink.:ehp2. :link reftype=hd res=100.:hp2.[Previous]:elink.:ehp2. :link reftype=hd res=220.:hp2.[Next]:elink.:ehp2. 

:h2 res=220 x=right y=bottom width=70% height=100%.Make OS/2 load Win32 programs

:font facename='Default' size=0x0.:p.OS&slr.2 (eCS) uses a different binary format for program files
than Windows. Because OS&slr.2 (eCS) does not understand this
Windows format it does not know how to load it.
:p.There are 3 possibilities implemented in Odin in order to load
Win32 programs in OS&slr.2 (eCS)&colon.
:ol.
:li.:link reftype=hd res=222.Win32K.SYS:elink.
:li.:link reftype=hd res=223.PE.EXE&slr.PEC.EXE:elink.
:li.:link reftype=hd res=224.XX2LX.EXE (formerly known as PE2LX.EXE):elink.
:eol.
:p.:hp5.:hp2.Exkurs&colon.:ehp5.
:p.:ehp2.It might be of interest to know the internal name of these binary
format types. However it is not needed for using Odin.
:ul compact.
:li.:link reftype=fn refid=31.LX:elink.&colon. 32 bit OS&slr.2 (eCS) executable
:li.:link reftype=fn refid=31.PE:elink.&colon. 32 bit Windows executable
:li.:link reftype=fn refid=31.NE:elink.&colon. 16 bit Windows and 16 bit OS&slr.2
:eul.
:p.It is quite easy to determine which type of executable a binary
is&colon. Take a look at the file contents (using a file viewer)
and usually (not always) you will find one of the above types in
capitalized letters within the first 100 bytes or so.
:p.:link reftype=hd res=100.:hp2.[Home]:elink.:ehp2. :link reftype=hd res=220.:hp2.[Previous]:elink.:ehp2. :link reftype=hd res=222.:hp2.[Next]:elink.:ehp2. 
:fn id=31.:p.LX = :hp5.L:ehp5.inear e:hp5.X:ehp5.ecutable
:p.PE = :hp5.P:ehp5.ortable :hp5.E:ehp5.xecutable
:p.NE = :hp5.N:ehp5.ew :hp5.E:ehp5.xecutable (funny&comma. isn't it?)
:efn.
:i1.loading Win32 programs
:i1.executable types

:h3 res=222 x=right y=bottom width=70% height=100%.Win32K.SYS

:font facename='Default' size=0x0.:p.Win32K.SYS acts as an extension to the OS&slr.2 (eCS) kernel to
make OS&slr.2 (eCS) think Win32 programs are native. It provides
a way to seamlessly load a Win32 program. If you have Win32K.SYS
installed you should not notice any difference between OS&slr.2
(eCS) and Windows programs in respect of loading a program
whether from a command line or WPS object.
:p.:hp8.WARNING! Bugs in Win32K.SYS may crash and&slr.or corrupt your
entire system! Make sure you have backed up important stuff
first!
:p.Team Odin is not responsible for ANYTHING AT ALL!
:p.Before you install Win32K.SYS make sure that you have a backdoor
to your system which works. For example try to boot your system
using the Alt&plus.F1 during bootup and choose Commandline boot
(F2). Make sure you have an textmode editor which works; for
example TEDIT.EXE.:ehp8.

:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.Win32K.SYS :link reftype=hd res=460.parameters:elink. are set automatically when
installing a weekly build.

:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.Win32K.SYS :link reftype=hd res=460.parameters:elink. can be configured using Win32K
Control Center in the Odin folder.

:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.If you are using a recent testcase kernel and you
experience a trap (black screen of death) in module GRACE then it
is Win32K.SYS. The following programs are currently causing such
traps with Win32K.SYS loaded&colon.
:ul compact.
:li.The old (but nevertheless quite often found) IBM Installer
(PMView 2000&comma. Netscape Communicator 4.61 and Lotus
SmartSuite come with it). The files of this installer start with
the letters "EPFI".
:li.Stardock's Object Packages from Object Desktop.
:li.There may be others as well...
:eul.
:p.Remove Win32K.SYS from your :font facename='Courier' size=14x8.CONFIG.SYS:font facename='Default' size=0x0. and reboot before trying
to run one of these programs.
:p.:link reftype=hd res=100.:hp2.[Home]:elink.:ehp2. :link reftype=hd res=220.:hp2.[Previous]:elink.:ehp2. :link reftype=hd res=223.:hp2.[Next]:elink.:ehp2. 
:i1.Win32K.SYS

:h3 res=223 x=right y=bottom width=70% height=100%.PE.EXE/PEC.EXE

:font facename='Default' size=0x0.:p.PE.EXE can be used if :link reftype=hd res=222.Win32K.SYS:elink. is not installed. It has to
precede the executable name of every Win32 program that is going
to be run. For example&colon.
If a Win32 program executable is called REALPLAY.EXE then your
commandline will look like the following&colon.
:p.:font facename='Courier' size=14x8.PE.EXE REALPLAY.EXE :font facename='Default' size=0x0.(or:font facename='Courier' size=14x8. PE REALPLAY).:font facename='Default' size=0x0.
:p.:font facename='Courier' size=14x8.PEC.EXE:font facename='Default' size=0x0. is a near relative of :font facename='Courier' size=14x8.PE.EXE:font facename='Default' size=0x0.. It is used the same
way&comma. despite it does not display textmode programs in a
separate window but in an OS&slr.2 window or fullscreen session.
This is handy for Win32 commandline programs.
:p.A WPS program object using PE.EXE would look like this&colon.
:p.
:artwork align=center name='E:\DEV\INF\ODINDOC\PROGOBJ.BMP' .
:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.Your program object will have the OS&slr.2 (eCS)
standard icon. You have to assign your favorite icon manually.
:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.PE.EXE searches for executables (.EXE&comma. .DLL) in
the following locations&colon.
:ol compact.
:li.Current directory
:li.:font facename='Courier' size=14x8.WINDOWSPATH:font facename='Default' size=0x0. (PATH-like Odin specific environment variable.)
:li.:font facename='Courier' size=14x8.PATH:font facename='Default' size=0x0.
:eol.
:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.It is not recommended to use :font facename='Courier' size=14x8.PE.EXE:font facename='Default' size=0x0. if :link reftype=hd res=222.Win32K.SYS:elink. is
installed. However from practical experience I found that using
:font facename='Courier' size=14x8.PE.EXE:font facename='Default' size=0x0. if :link reftype=hd res=222.Win32K.SYS:elink. is installed in PE-mode does not seem to
hurt. Nevertheless it is not recommended.
:p.:link reftype=hd res=100.:hp2.[Home]:elink.:ehp2. :link reftype=hd res=222.:hp2.[Previous]:elink.:ehp2. :link reftype=hd res=224.:hp2.[Next]:elink.:ehp2. 
:i1.PE.EXE
:i1.PEC.EXE
:i1.PATH
:i1.WINDOWSPATH

:h3 res=224 x=right y=bottom width=70% height=100%.XX2LX.EXE

:font facename='Default' size=0x0.:p.PE2LX is called XX2LX.EXE in recent builds. The use of PE2LX (aka
Xx2LX) is not recommended anymore&comma. especially not for
endusers.
:p.PE2LX has to be used on every single binary file that comes with
a Win32 program before the program can be used on OS&slr.2 e.g.
you have to convert every binary on a file per file basis from
Windows PE format to OS&slr.2 LX format using PE2LX.EXE.
:p.You will not find any further information upon PE2LX (aka Xx2LX)
in this document. The best advice is - do not use it!
:p.:link reftype=hd res=100.:hp2.[Home]:elink.:ehp2. :link reftype=hd res=223.:hp2.[Previous]:elink.:ehp2. :link reftype=hd res=230.:hp2.[Next]:elink.:ehp2. 
:i1.PE2LX.EXE
:i1.XX2LX.EXE 

:h2 res=230 x=right y=bottom width=70% height=100%.Provide an environment for Win32 programs

:font facename='Default' size=0x0.:p.After the Win32 executable is loaded it needs an appropriate
environment.

:p.Odin provides the environment by adding many .DLLs to OS&slr.2
(eCS) that a Win32 program expects to find under Windows so it
can make all the :link reftype=fn refid=16.API:elink. calls it has to. Those .DLLs that Odin
provides do their best to answer every possible call a Win32
program can make.

:p.And that's where the problems begin&colon. Odin's .DLLs are still
incomplete. Some :link reftype=fn refid=16.API:elink. calls work perfectly&comma. some only
partially and some fail. The number of :link reftype=fn refid=16.API:elink. calls that work
correctly grows with every build that is released.

:p.In addition&comma. Odin provides things for Win32 programs that
otherwise simply do not exist in OS&slr.2 (eCS). Odin adds&colon.
:ul compact.
:li.Specific directories&comma.
:li.the biggest part of the registry&comma.
:li.OLE (not fully implemented yet)&comma.
:li.and some more things.
:eul.

:p.:artwork align=left name='E:\DEV\INF\ODINDOC\BL_PIN.BMP' runin.:hp2.Conclusion&colon. :ehp2.If a Win32 program only uses calls and
facilities that are provided by Odin it will (probably) work. If
it wants to use things that are currently not present in Odin it
will fail.
:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.There are still Windows programs around that claim to
be 32 bit but contain portions of code that rely on 16 bit
Windows APIs. Such programs will not work with Odin. For 16 bit
installers look :link reftype=hd res=570.here:elink..
:p.:link reftype=hd res=100.:hp2.[Home]:elink.:ehp2. :link reftype=hd res=224.:hp2.[Previous]:elink.:ehp2. :link reftype=hd res=300.:hp2.[Next]:elink.:ehp2. 
:fn id=16.:p.API = Application Programming Interface:efn.
:i1.environment for Win32 programs
:i1.API calls quality

:h1 res=300 x=right y=bottom width=70% height=100%.Distribution of Odin

:font facename='Default' size=0x0.:p.First you need to decide how you are going to use Odin and how adventurous
you are.
:p.Odin binary builds come in several flavors. The main flavors are&colon.
:ul compact.
:li.:link reftype=hd res=320.:hp2.Weekly buildfiles:elink.:ehp2.&colon. These are intended to be stable builds for
end-users.
:li.:link reftype=hd res=330.:hp2.Daily buildfiles:elink.:ehp2.&colon. These are intended for developers and the adventurous
who prefer to be on the bleeding edge.
:eul.

:p.Both of these build types come in two sub-flavors&colon.

:ul compact.
:li.Release builds contain no debugging code and are generally smaller and
faster.
:li.Debug builds contain extensive debugging and logging code. Therefore you
should have :link reftype=fn refid=7.lots of free space:elink. on a drive on which you plan to run an Odin
debug build with :link reftype=hd res=550.logging enabled:elink..
:eul.

:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.You will often be asked to install a debug build to assist in
diagnosing the source of the defect if you report a problem with a release
build.

:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.If you need to run a debug build&comma. be aware that the logs
can be large. You need to ensure you have sufficient free disk space.
:p.For details about reporting bugs take a look at :link reftype=hd res=550.OdinBug:elink.&comma. the bug report
generator for Odin. It has an extensive on-line help which covers every
detail about reporting bugs.
:p.Of course&comma. if all of the above options are all too tame&comma. you can
always build Odin from source.

:p.That's one of the beauties of Open Source.
:p.:link reftype=hd res=100.:hp2.[Home]:elink.:ehp2. :link reftype=hd res=230.:hp2.[Previous]:elink.:ehp2. :link reftype=hd res=320.:hp2.[Next]:elink.:ehp2. 
:i1.flavors of Odin
:i1.subflavors of Odin
:i1.release builds
:i1.debug builds

:h2 res=320 x=right y=bottom width=70% height=100%.Weekly builds

:font facename='Default' size=0x0.:p.The weekly builds are considered to be (relatively) stable builds for
endusers.

:p.They come in WarpIN .WPI file format.

:p.These are the recommended buildfiles for the novice Odin user. It is
essential that your first installation of Odin is done with a weekly build.
It is not important whether this first installation is done with a release or
a debug build.

:p.In order to install these weekly builds you will have to get :link reftype=hd res=430.WarpIN:elink.&comma.
the popular installer kit done by Mr. xWorkplace&comma. Ulrich M&oe.ller.
:link reftype=hd res=430.WarpIN:elink. can be found :link reftype=fn refid=5.here:elink..

:p.The usage of WarpIN for the first installation of Odin is recommended&comma.
because the usage of WarpIN ensures that a few basics are done right.
:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.Be careful when downloading .WPI files with Netscape. By default
Netscape considers .WPI files as text files and damages them. There is a
little program that comes with :link reftype=hd res=430.WarpIN:elink. named Wizilla.EXE. It has to be run
once in order to make Netscape recognize .WPI files as binaries (and download
them correctly!).
:p.:link reftype=hd res=100.:hp2.[Home]:elink.:ehp2. :link reftype=hd res=300.:hp2.[Previous]:elink.:ehp2. :link reftype=hd res=330.:hp2.[Next]:elink.:ehp2. 
:i1.Weekly builds
:i1.WPI builds
:i1.stable builds

:h2 res=330 x=right y=bottom width=70% height=100%.Daily builds

:font facename='Default' size=0x0.:p.Daily builds come in the traditional .ZIP file format.
:p.They have to be installed manually or with a little tool named
OdinTool available in the file area of the odinusers list at
YahooGroups.
:p.The .ZIP file should be unpacked in the &bsl.Odin directory. When
unZIPping be sure not to trash directories&comma. because the
build files have an appropriate directory structure stored
inside.
:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.You have to run :link reftype=hd res=520.:font facename='Courier' size=14x8.OdinInst.EXE:font facename='Default' size=0x0.:elink. after unZIPping a daily
build in order to update the directory tree and registry.

:p.:link reftype=hd res=100.:hp2.[Home]:elink.:ehp2. :link reftype=hd res=320.:hp2.[Previous]:elink.:ehp2. :link reftype=hd res=340.:hp2.[Next]:elink.:ehp2. 
:i1.Daily builds
:i1.ZIP builds

:h2 res=340 x=right y=bottom width=70% height=100%.Getting an Install Kit

:font facename='Default' size=0x0.:p.The recommended location to get Odin builds is from
:ul compact.
:li.:link reftype=fn refid=1.ftp&colon.&slr.&slr.ftp.os2.org&slr.odin&slr.daily:elink.
:li.:link reftype=fn refid=2.ftp&colon.&slr.&slr.ftp.os2.org&slr.odin&slr.weekly:elink.
:eul.
:p.However&comma. since no service is available 24 hours 7 days a
week&comma. an alternative source is
:ul compact.
:li.:link reftype=fn refid=3.ftp&colon.&slr.&slr.ftp.netlabs.org&slr.pub&slr.odin&slr.daily:elink.
:li.:link reftype=fn refid=4.ftp&colon.&slr.&slr.ftp.netlabs.org&slr.pub&slr.odin&slr.weekly:elink.
:eul.

:p.Both Daily and Weekly builds are named based on the build date and style&colon.
:lines align=center.:font facename='Courier' size=14x8.
odin32bin-YYYYMMDD-STYLE.FORMAT
:elines.:font facename='Default' size=0x0.
:p.Now&comma. what do these stand for&colon.
:sl.
:li.YYYYMMDD is the build date.  
:li.STYLE is the build style and will be one of&colon.
:sl compact.
:li."debug" for the debug builds
:li."release" for the release builds
:esl.
:li.FORMAT is the build type
:sl compact.
:li."WPI" for the weekly builds in :link reftype=hd res=430.WarpIN:elink. format
:li."ZIP" for the daily builds in ZIP format
:esl.
:esl.
:p.For example&colon.
:lines align=center.:font facename='Courier' size=14x8.
odin32bin-20020214-debug.wpi
:elines.:font facename='Default' size=0x0.
:p.indicates the weekly debug build from 02-14-2002.
:p.:link reftype=hd res=100.:hp2.[Home]:elink.:ehp2. :link reftype=hd res=330.:hp2.[Previous]:elink.:ehp2. :link reftype=hd res=400.:hp2.[Next]:elink.:ehp2. 
:fn id=1.:p.:link reftype=launch object='NETSCAPE.EXE' data='ftp://ftp.os2.org/odin/daily'.ftp&colon.&slr.&slr.ftp.os2.org&slr.odin&slr.daily:elink.:efn.
:fn id=2.:p.:link reftype=launch object='NETSCAPE.EXE' data='ftp://ftp.os2.org/odin/weekly'.ftp&colon.&slr.&slr.ftp.os2.org&slr.odin&slr.weekly:elink.:efn.
:fn id=3.:p.:link reftype=launch object='NETSCAPE.EXE' data='ftp://ftp.netlabs.org/pub/odin/daily'.ftp&colon.&slr.&slr.ftp.netlabs.org&slr.pub&slr.odin&slr.daily:elink.:efn.
:fn id=4.:p.:link reftype=launch object='NETSCAPE.EXE' data='ftp://ftp.netlabs.org/pub/odin/weekly'.ftp&colon.&slr.&slr.ftp.netlabs.org&slr.pub&slr.odin&slr.weekly:elink.:efn.
:i1.naming scheme
:i1.build names
:i1.where to get builds
:i1.downloading Odin builds
:i1.ftp.os2.org
:i1.ftp.netlabs.org
:i1.netlabs
:i1.os2.org

:h1 res=400 x=right y=bottom width=70% height=100%.Installing Odin

:font facename='Default' size=0x0.:p.Odin is easy to install. However&comma. there are enough options that you
should do a little planning before you start. So here is a short cookbook with
links to get the appropriate details for every step&colon.
:ol.
:li.Check whether your system meets the :link reftype=hd res=420.requirements:elink. for installing Odin.
:li.Decide whether to use a
:ol compact.
:li.:link reftype=hd res=320.weekly build:elink. with :link reftype=fn refid=21.release:elink. or :link reftype=fn refid=22.debug:elink. flavor.
:li.:link reftype=hd res=330.daily build:elink. with :link reftype=fn refid=21.release:elink. or :link reftype=fn refid=22.debug:elink. flavor.
:eol.
:li.Get :link reftype=hd res=340.the desired build:elink..
:li.Get and install :link reftype=hd res=430.WarpIN:elink..
:li.Install the :link reftype=hd res=440.weekly:elink. or :link reftype=hd res=450.daily:elink. build.
:eol.
:p.You are done!
:p.Subsequent builds can be installed over the existing one&comma. there is no
need to uninstall (neither for weekly nor for daily builds). It is no problem
at all to install a daily build over a weekly build and vice versa.
:p.:link reftype=hd res=100.:hp2.[Home]:elink.:ehp2. :link reftype=hd res=340.:hp2.[Previous]:elink.:ehp2. :link reftype=hd res=420.:hp2.[Next]:elink.:ehp2. 

:fn id=21.:p.Release builds are considered stable builds for endusers. They are smaller and
faster than debug builds.:p.They :hp5.:hp2.cannot:ehp5.:ehp2. be used to report bugs.:efn.
:fn id=22.:p.Debug builds contain extensive debugging and logging code. They are bigger and
slower than release builds.:p.They :hp5.:hp2.must:ehp5.:ehp2. be used to report bugs.:efn.

:i1.cookbook
:i1.installation cookbook
:i1.subsequent installations
:i1.installing over previous installations

:h2 res=420 x=right y=bottom width=70% height=100%.Requirements

:font facename='Default' size=0x0.:p.Your system must meet the following specifications in order to be able to
install Odin successfully&colon.
:ol.
:li.The :hp2.recommended operating system version:ehp2. is any flavor of OS&slr.2 version 4.5
:ul compact.
:li.OS&slr.2 Warp 4 with fixpack 13 or better (15 recommended)
:li.OS&slr.2 Warp 4.5x (MCP1 or MCP2)
:li.OS&slr.2 Warp Server for eBusiness
:li.eComStation
:eul.
:p.When using OS&slr.2 Warp 4.0 (e.g. with a fixpack level prior to 13) it should
at least be at fixpack level 5.
:p.OS&slr.2 Warp 3 is not officially supported&comma. but is reported to work by
using Warp 4 Open32 dlls and patching them.
:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.The reason why OS&slr.2 version 4.5 is recommended and not version
4.0 with fixpack level of 5 or better is the infamous 512 MB virtual memory
limit per process which has been :link reftype=fn refid=13.lifted:elink. to 3072 MB in fixpack 13 or better
(e.g. OS&slr.2 version 4.5).
:li.You must have OS&slr.2 with :hp2.Open32&slr.DAX&slr.DAPIE:ehp2. installed. This is (was?)
an option during the initial installation process of OS&slr.2.
:p.Check for the presence of the following files on your system in order to
determine whether Open32&slr.DAX&slr.DAPIE is installed&colon.
:ul compact.
:li.:font facename='Courier' size=14x8.&bsl.OS2&bsl.DLL&bsl.PMWINX.DLL :font facename='Default' size=0x0.(main DLL&comma. although Odin does not need
it anymore)
:li.:font facename='Courier' size=14x8.&bsl.OS2&bsl.DLL&bsl.REGISTRY.DLL :font facename='Default' size=0x0.(this one and all the following are required
by Odin)
:li.:font facename='Courier' size=14x8.&bsl.OS2&bsl.SYSTEM&bsl.USER.DAT
:li.&bsl.OS2&bsl.SYSTEM&bsl.SYSTEM.DAT
:eul.:font facename='Default' size=0x0.
:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.There are a few more files that belong to
Open32&slr.DAX&slr.DAPIE. However there have been some changes during its
history and some of these files are :link reftype=fn refid=19.obsolete:elink. today.
:p.Generally speaking&colon. If you can run Lotus SmartSuite for OS&slr.2 you can
run Odin&comma. too.
:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.There is a :link reftype=fn refid=15.defect:elink. in the Warp4 default.RSP file that affects CID
installs. This is why CID installs often will not support Open32. 
:li.You must install Odin on a :hp2.partition that supports long filenames:ehp2. (e.g.
HPFS&slr.JFS&slr.FAT32). Odin will not work on FAT16 partitions because
OS&slr.2 cannot write long filenames on FAT16 partitions.
:li.Video is always an issue with Odin. You should run an up to date display
driver when installing (and using) Odin. The :hp2.SciTech Display Doctor Suite is
the recommended:ehp2. driver for Odin (both&comma. IBM version or SciTech's
SDD&slr.Pro). The native Matrox drivers are also good drivers for this
purpose. There is no recommended resolution or color depth&comma. however 16
bit color depth (e.g. 65.536 colors) is generally known to work best (personal
opinion of the :link reftype=fn refid=999.author:elink. based on reading lots of newsgroup and mailing list
articles).
:eol.
:p.:link reftype=hd res=100.:hp2.[Home]:elink.:ehp2. :link reftype=hd res=400.:hp2.[Previous]:elink.:ehp2. :link reftype=hd res=430.:hp2.[Next]:elink.:ehp2. 
:fn id=15.
:p.As delivered&comma. the .RSP file is missing the entries&colon.
:ul compact.
:li.DAXCOMP1.Selection=1
:li.DAXCOMP1.TarDrv=x&colon.
:eul.
:p.where x&colon. is the install drive.  
:efn.
:fn id=19.:p.Among these are
:ul compact.
:li.all :font facename='Courier' size=14x8.NAME*.EXE:font facename='Default' size=0x0. files&comma.
:li.:font facename='Courier' size=14x8.boot.dat&comma. registry.dat:font facename='Default' size=0x0.
:eul.
:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.Although these files are obsolete it is not recommended to delete
them!
:efn.
:fn id=13.:p.In order to enable the new memory limit per process put
:font facename='Courier' size=14x8.VIRTUALADDRESSLIMIT=3072:font facename='Default' size=0x0. into your :font facename='Courier' size=14x8.CONFIG.SYS:font facename='Default' size=0x0.. Some Win32 applications
(especially Microsoft Office) are designed in a way that they refuse to
run&comma. if they do not have at least 2048 MB of virtual address space.
:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.This does not mean that this setting will enable you to run
Microsoft Office with Odin today. It just opens the possibility to do it in
the future.
:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.This setting has nothing to do with the amount of RAM you have
currently plugged into your system.
:efn.
:i1.OS&slr.2 version
:i1.Warp 3
:i1.Warp 4
:i1.Warp 4.5
:i1.Warp 4.51
:i1.Warp 4.52
:i1.WSeB
:i1.eComStation
:i1.FAT16
:i1.FAT32
:i1.JFS
:i1.HPFS
:i1.DAX
:i1.Open32
:i1.DAPIE
:i1.long filenames
:i1.prerequisites
:i1.video driver
:i1.display driver
:i1.SciTech Display Doctor
:i1.512 MB memory limit per process
:i1.VIRTUALADDRESSLIMIT

:h2 res=430 x=right y=bottom width=70% height=100%.Installing WarpIN

:font facename='Default' size=0x0.:p.WarpIN is required for installing Odin's weekly builds. Even if you plan on
using only daily builds&comma. which do not require WarpIN&comma. it is
strongly recommended you install WarpIN. It is quickly becoming a preferred
OS&slr.2 installer for complex applications.



:p.In addition the first installation of Odin on your machine should be a weekly
build.
:ol.
:li.:hp2.Getting a WarpIN Install Kit
:p.:ehp2.You can always get the latest WarpIN installer kit from
:link reftype=fn refid=5.ftp&colon.&slr.&slr.ftp.os2.org&slr.xworkplace:elink..The most recent release of
WarpIN at the time of this writing is warpin-0-9-16.zip.
:li.:hp2.Choosing an Install Location

:p.:ehp2.The WarpIN developers have defined default locations for applications
installed by WarpIN&colon.
:ul compact.
:li.:font facename='Courier' size=14x8.&bsl.Tools:font facename='Default' size=0x0. - Tools and utilities
:li.:font facename='Courier' size=14x8.&bsl.Apps:font facename='Default' size=0x0. - Applications
:p.If you use these defaults&comma. you would want to install WarpIN to&colon.
:li.:font facename='Courier' size=14x8.&bsl.Tools&bsl.WarpIN:font facename='Default' size=0x0.
:eul.
:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.These defaults can be overridden. If you don't like WarpIN's
defaults&comma. you can change them after WarpIN is installed.
:li.:hp2.Installing:ehp2. 
:ul compact.
:li.Create your target directory for WarpIN.
:li.Unzip the WarpIN package to this directory (no temporary directory needed)
:li.Run WarpIN.EXE
:eul.
:p.This will create a WarpIN folder and register the WarpIN class so that you
can use the usual Workplace Shell (WPS) features to activate the installer.
:p.WarpIN makes no changes to :font facename='Courier' size=14x8.CONFIG.SYS:font facename='Default' size=0x0.. A reboot is not necessary.
:eol.
:p.:link reftype=hd res=100.:hp2.[Home]:elink.:ehp2. :link reftype=hd res=420.:hp2.[Previous]:elink.:ehp2. :link reftype=hd res=440.:hp2.[Next]:elink.:ehp2. 
:fn id=5.:p.:link reftype=launch object='NETSCAPE.EXE' data='ftp://ftp.os2.org/xworkplace'.ftp&colon.&slr.&slr.ftp.os2.org&slr.xworkplace:elink.:efn.
:i1.installing WarpIN

:h2 res=440 x=right y=bottom width=70% height=100%.Installing a weekly build

:font facename='Default' size=0x0.:p.This is a step-by-step install cookbook for the end user&colon.
:ol.
:li.Make sure you have :link reftype=hd res=430.:hp2.WarpIN:elink. installed:ehp2. as described :link reftype=hd res=430.here:elink..
:li.:hp2.Get an Odin weekly build:ehp2. as described :link reftype=hd res=340.here:elink..
:li.:hp2.Decide where:ehp2. to install it.
:p.The default path that is proposed by the developers is
:link reftype=fn refid=27.C&colon.&bsl.Odin:elink.&comma. but this can be overridden.
:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.You should install Odin on a partition with plenty of free space.
You might need to create a debug logfile and these can become quite :link reftype=fn refid=7.large:elink..
:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.Do not (never&comma. never&comma. never) install Odin into your
real Windows installation. The result will be that your Windows installation
completely damaged and Odin will not work!
:li.:hp2.Decide how:ehp2. you want to run&colon.
:ul compact.
:li.Device Driver (:link reftype=hd res=222.Win32K.SYS:elink.&comma. optionally :link reftype=hd res=460.parameters:elink. can be changed manually
afterwards)
:li.With or without :font facename='Courier' size=14x8.PATH:font facename='Default' size=0x0. and :font facename='Courier' size=14x8.LIBPATH:font facename='Default' size=0x0. updates. :font facename='Courier' size=14x8.:link reftype=fn
refid=23.:hp1.x:elink.:ehp1.&colon.&bsl.ODIN&bsl.SYSTEM32:font facename='Default' size=0x0.
should be both in your :font facename='Courier' size=14x8.PATH:font facename='Default' size=0x0. and :font facename='Courier' size=14x8.LIBPATH:font facename='Default' size=0x0..
:li.With or without :link reftype=hd res=223.PE.EXE:elink..
:eul.
:li.:hp2.Install Odin:ehp2. buildfile using :link reftype=hd res=430.WarpIN:elink..
:li.:hp2.Reboot:ehp2. if needed.
:li.:hp2.Run :link reftype=hd res=540.:font facename='Courier' size=14x8.OdinApp:font facename='Default' size=0x0.:elink.:ehp2. to verify&comma. that basics went well&comma. as described:hp2. :link reftype=hd res=540.:ehp2.here:elink..
:eol.
:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.In case you get an error message from :link reftype=hd res=222.Win32K.SYS:elink.
which tells you that Win32K.SYS failed to load&comma. the most
probable reason is a missing or inadequate symbol file. Read on
:link reftype=hd res=470.here:elink. in order to resolve this problem.

:p.:link reftype=hd res=100.:hp2.[Home]:elink.:ehp2. :link reftype=hd res=430.:hp2.[Previous]:elink.:ehp2. :link reftype=hd res=450.:hp2.[Next]:elink.:ehp2. 
:fn id=7.:p.The debug files grow rapidly during the execution of a program. 40-50 MB for 5
minutes running RealPlayer 8 is not unusual.:efn.
:fn id=27.C&colon. does not represent your bootdrive here.:efn.
:fn id=23.:p.x = the drive you installed Odin on.:efn.
:i1.installing Odin
:i1.installing weekly builds
:i1.installing WPI builds

:h2 res=450 x=right y=bottom width=70% height=100%.Installing a daily build

:font facename='Default' size=0x0.:p.This is a Bleeding Edge Install Cookbook for the more adventurous users&colon.
:ol.
:li.:hp2.Get an Odin daily build:ehp2. (.ZIP file) as described :link reftype=hd res=340.here:elink..
:li.:hp2.Decide where:ehp2. to install it
:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.You should install Odin on a partition with plenty of free space.
You might want to create a debug logfile and these can become quite :link reftype=fn refid=7.large:elink..
:li.:hp2.Unzip the build:ehp2. to the install directory
:li.:hp2.Update :font facename='Courier' size=14x8.CONFIG.SYS:font facename='Default' size=0x0. if needed. You might have to update&colon.
:ul compact.
:li.:font facename='Courier' size=14x8.:ehp2.DEVICE=:link reftype=fn refid=23.:hp1.x:elink.:ehp1.&colon.&bsl.ODIN&bsl.SYSTEM32&bsl.:link reftype=hd res=222.Win32K.SYS:elink.:font facename='Default' size=0x0. [:link reftype=hd res=460.parameters:elink.]
:li.Your :font facename='Courier' size=14x8.PATH (:link reftype=fn refid=23.:hp1.x:elink.:ehp1.&colon.&bsl.ODIN&bsl.SYSTEM32:font facename='Default' size=0x0. should be added to the end of your :font facename='Courier' size=14x8.PATH:font
facename='Default' size=0x0.)
:li.Your :font facename='Courier' size=14x8.LIBPATH (:link reftype=fn refid=23.:hp1.x:elink.:ehp1.&colon.&bsl.ODIN&bsl.SYSTEM32:font facename='Default' size=0x0. should be added to the end of your :font facename='Courier' size=14x8.LIBPATH:font
facename='Default' size=0x0.)
:li.Your :font facename='Courier' size=14x8.WINDOWSPATH (:link reftype=fn refid=23.:hp1.x:elink.:ehp1.&colon.&bsl.ODIN:font facename='Default' size=0x0. and :link reftype=fn refid=23.:hp1.x:elink.:ehp1.&colon.&bsl.ODIN&bsl.SYSTEM32:font facename='Default'
size=0x0. should be added)
:eul.
:li.:hp2.Reboot:ehp2. if needed.
:li.:hp2.Run :link reftype=hd res=520.:font facename='Courier' size=14x8.OdinInst:font facename='Default' size=0x0.:elink. :ehp2.to initialize the Open32 Registry and :link reftype=hd res=530.:font facename='Courier' size=14x8.Odin.INI:font
facename='Default' size=0x0.:elink..
:li.:hp2.Run :link reftype=hd res=540.:font facename='Courier' size=14x8.OdinApp:font facename='Default' size=0x0.:elink. :ehp2.to verify.
:eol.
:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.In case you get an error message from :link reftype=hd res=222.Win32K.SYS:elink.
which tells you that Win32K.SYS failed to load&comma. the most
probable reason is a missing or inadequate symbol file. Read on
:link reftype=hd res=470.here:elink. in order to resolve this problem.
:p.:link reftype=hd res=100.:hp2.[Home]:elink.:ehp2. :link reftype=hd res=440.:hp2.[Previous]:elink.:ehp2. :link reftype=hd res=460.:hp2.[Next]:elink.:ehp2. 
:i1.installing ZIP builds
:i1.installing daily builds

:h2 res=460 x=right y=bottom width=70% height=100%.Important Win32K.SYS parameters

:font facename='Default' size=0x0.:p.Win32K.SYS understands a lot of parameters. This is a short
summary of the most important parameters needed for daily use of
Odin.

:p.The Capitalized letters are the one which is tested for when
identifying the argument. Blanks have to be inserted between
individual parameters&comma. but no blanks within a parameter. |
means OR. The "<" and ">" indicate a list of options and must be
omitted in the device driver statement.

:p.:hp2.Generally useful parameters:ehp2. for Win32K.SYS&colon.
:lines align=left.:font facename='Courier' size=12x6.
-Quiet             :font facename='Default' size=0x0.Quiet driver initiation.:font facename='Courier' size=14x8.
                 :font facename='Default' size=0x0.Default&colon. Disabled (e.g. -V):font facename='Courier' size=14x8.

-Verbose         :font facename='Default' size=0x0.Verbose driver initiation. :font facename='Courier' size=14x8.
                 :font facename='Default' size=0x0.Default&colon. Enabled:font facename='Courier' size=14x8.

-S&colon.<filename>    :font facename='Default' size=0x0.Full path to the current OS&slr.2 kernel symbol file.:font facename='Courier' size=14x8.
                 :font facename='Default' size=0x0.When this is specified the given symbol "database":font facename='Courier' size=14x8.
                 :font facename='Default' size=0x0.and default locations are not searched. Continue:font facename='Courier' size=14x8.
                 :font facename='Default' size=0x0.:link reftype=hd res=470.here:elink. to learn more about symbol files.:font facename='Courier' size=14x8.
:elines.:font facename='Default' size=0x0.
:p.:hp2.Win32 programs loader parameters&colon.
:lines align=left.:font facename='Courier' size=12x6.
:ehp2.-PE&colon.<PE|PE2LX|MIXED|NOT>
                   :font facename='Default' size=0x0.Enable&slr.disable and set mode of the PE loading.:font facename='Courier' size=14x8.

                 PE&colon.     :font facename='Default' size=0x0.PE.EXE only. The program is started using :font facename='Courier' size=14x8.
                         :font facename='Default' size=0x0.PE.EXE and the process name will be PE.EXE.:font facename='Courier' size=14x8.
                         :font facename='Default' size=0x0.This is the recommended setting.:font facename='Courier' size=14x8.

                 PE2LX&colon.  :font facename='Default' size=0x0.PE2LX loader only.:font facename='Courier' size=14x8.

                 MIXED&colon.  :font facename='Default' size=0x0.Mix of PE2LX and PE.EXE. It uses PE2LX:font facename='Courier' size=14x8.
                         :font facename='Default' size=0x0.when possible and backs out to PE.EXE if :font facename='Courier' size=14x8.
                         :font facename='Default' size=0x0.the executable is not supported by the :font facename='Courier' size=14x8.
                         :font facename='Default' size=0x0.converter.:font facename='Courier' size=14x8.
                 NOT&colon.    :font facename='Default' size=0x0.Disable PE loading.:font facename='Courier' size=14x8.
:elines.:font facename='Default' size=0x0.
:p.:hp2.OS&slr.2 loader parameter&colon.
:lines align=left.:font facename='Courier' size=12x6.
:ehp2.-Dllfixes<&colon.E|&colon.D>   :font facename='Default' size=0x0.Enables or disables the long DLL name and non .DLL:font facename='Courier' size=14x8.
                 :font facename='Default' size=0x0.extension fixes.:font facename='Courier' size=14x8.

                 :font facename='Default' size=0x0.Explanantion&colon. OS&slr.2 DLLs have been limited to 8 :font facename='Courier' size=14x8.
                 :font facename='Default' size=0x0.characters names since version 2.0. This is a very :font facename='Courier' size=14x8.
                 :font facename='Default' size=0x0.bad limitation. Also OS&slr.2 forces all DLL loaded at:font facename='Courier' size=14x8.
                 :font facename='Default' size=0x0.loadtime to have the extension '.DLL'.:font facename='Courier' size=14x8.

                 :font facename='Default' size=0x0.Both these restrictions are removed if this setting is:font facename='Courier' size=14x8.
                 :font facename='Default' size=0x0.enabled.:font facename='Courier' size=14x8.

                 :font facename='Default' size=0x0.Current state for this feature is EXPERIMENTAL.:font facename='Courier' size=14x8.
                 :font facename='Default' size=0x0.Default&colon. Enabled:font facename='Courier' size=14x8.

                 :font facename='Default' size=0x0.-Dllfixes can be used independently of the -PE parameter.:font facename='Courier' size=14x8.

:elines.:font facename='Default' size=0x0.
:p.:link reftype=hd res=100.:hp2.[Home]:elink.:ehp2. :link reftype=hd res=450.:hp2.[Previous]:elink.:ehp2. :link reftype=hd res=470.:hp2.[Next]:elink.:ehp2. 
:i1.Win32K.SYS parameters (excerpt)

:h2 res=470 x=right y=bottom width=70% height=100%.Providing a symbol file for Win32K.SYS

:font facename='Default' size=0x0.:p.:link reftype=hd res=222.Win32K.SYS:elink. is not a "real" device driver&comma. but an extension
to the OS&slr.2 kernel. It integrates into the kernel by patching
it. In order to be able to patch the kernel&comma. it needs to
know the locations of routines within the kernel.
:p.As these locations change from build to build&comma. :link reftype=hd res=222.Win32K.SYS:elink.
needs to search the kernel to find these locations.

:p.When programmers write code&comma. they use symbols to represent
functions and data because it allows them to abstract the
process.  Once the compiled code is inside the computer&comma.
all we have is binary addresses.  The .sym files contain the data
needed to convert an address back to a symbolic name.
:p.Without this :link reftype=hd res=222.Win32K.SYS:elink. would have to debug in binary which just
slows the process down considerably. That is why :link reftype=hd res=222.Win32K.SYS:elink. needs
the .sym. files.

:p.Procedure in order to the provide the appropriate symbol
file&colon.
:ol.
:li.You should look into the following places&comma. depending on
what version of OS&slr.2 you are using (x&colon. is equivalent to
your boot drive)&colon.

:ul.
:li.OS&slr.2 Warp 4
:sl compact.
:li.x&colon.&bsl.os2&bsl.pdpsi&bsl.pmdf&bsl.warp4&bsl.os2krnlr.sym
:esl.
:li.OS&slr.2 Warp 4.5
:sl compact.
:li.x&colon.&bsl.os2&bsl.pdpsi&bsl.pmdf&bsl.warp45&bsl.os2krnlr.sym
:li.x&colon.&bsl.os2&bsl.pdpsi&bsl.pmdf&bsl.warp45_u&bsl.os2krnlr.sym
:li.x&colon.&bsl.os2&bsl.pdpsi&bsl.pmdf&bsl.warp45_s&bsl.os2krnlr.sym
:esl.
:li.Recent testcase kernels (OS&slr.2 Warp 4.5)
:sl compact.
:li.x&colon.&bsl.os2krnl.sym
:esl.
:li.OS&slr.2 Warp 3 (not officially supported)
:sl compact.
:li.x&colon.&bsl.os2&bsl.system&bsl.pmdf&bsl.os2krnlr.sym
:esl.
:eul.
:li.Now that you have found your symbol file&comma. copy it to
os2krnl.sym the in the root directory of your bootdrive. The
symbol file of the testcase kernels are already there. You might
also use the -S switch instead of copying the file.
:li.Reboot and test. If Win32K.SYS does not complain anymore&comma.
you are done!
:eol.
:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.The kernel and the symbol file must match&comma.
which means they must be of the same revision (a similar date and
time indicates a matching revision)&comma.
:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.When looking for the symbol files as described
above&comma. you might find files named os2krnld.sym and
os2krnlb.sym. They are for debug kernels. Do not use the
them&comma. unless you know what you are doing! 
:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.The "r" in os2krnlr.sym stands for "retail".
:p.:link reftype=hd res=100.:hp2.[Home]:elink.:ehp2. :link reftype=hd res=460.:hp2.[Previous]:elink.:ehp2. :link reftype=hd res=500.:hp2.[Next]:elink.:ehp2. 
:i1.Win32K.SYS loading error
:i1.error loading Win32K.SYS
:i1.os2krnl.sym
:i1.os2krnlr.sym
:i1.symbol files

:h1 res=500 x=right y=bottom width=70% height=100%.Using Odin

:font facename='Default' size=0x0.:p.The following sections describe some important parts of
Odin&colon.
:ul.
:li.:link reftype=hd res=520.OdinInst.EXE:elink.
:li.:link reftype=hd res=530.Odin.INI:elink.
:li.:link reftype=hd res=540.OdinApp.EXE:elink.
:li.:link reftype=hd res=550.OdinBug.EXE:elink.
:li.:link reftype=hd res=560.OpenGL3dfx.ZIP:elink.
:li.:link reftype=hd res=570.Installing Win32 applications:elink.
:eul.
:p.:link reftype=hd res=100.:hp2.[Home]:elink.:ehp2. :link reftype=hd res=440.:hp2.[Previous]:elink.:ehp2. :link reftype=hd res=520.:hp2.[Next]:elink.:ehp2. 

:h2 res=520 x=right y=bottom width=70% height=100%.Initializing Odin - OdinInst.EXE

:font facename='Default' size=0x0.:p.The :font facename='Courier' size=14x8.OdinInst:font facename='Default' size=0x0. utility initializes or updates the Open32 registry keys and
:link reftype=hd res=530.:font facename='Courier' size=14x8.Odin.INI:font facename='Default' size=0x0.:elink.. Many Win32 programs depend on the existence of certain Registry
keys. :font facename='Courier' size=14x8.OdinInst:font facename='Default' size=0x0. adds these keys to the Open32 Registry. In addition&comma.
:font facename='Courier' size=14x8.OdinInst:font facename='Default' size=0x0. adds :link reftype=hd res=530.:font facename='Courier' size=14x8.Odin.INI:font facename='Default' size=0x0.:elink. key values&comma. as needed.

:p.If you suspect that you are missing some required values&comma. you can run
:font facename='Courier' size=14x8.OdinInst:font facename='Default' size=0x0.. 

:p.What is more&comma. :font facename='Courier' size=14x8.OdinInst.EXE:font facename='Default' size=0x0. creates the following tree&comma. which
mimics the Windows directory structure&comma. within the Odin folder&colon.
:cgraphic.
:hp2.      Odin
      ÃÄÄ All Users
      ³   ÀÄÄ Start Menu
      ³       ÀÄÄ Programs
      ³           ÀÄÄ StartUp
      ÃÄÄ Application Data
      ÃÄÄ Cookies
      ÃÄÄ Desktop
      ÃÄÄ Favorites
      ÃÄÄ Fonts
      ÃÄÄ History
      ÃÄÄ My Documents
      ÃÄÄ NetHood
      ÃÄÄ PrintHood
      ÃÄÄ Recent
      ÃÄÄ SendTo
      ÃÄÄ ShellNew
      ÃÄÄ Start Menu
      ³   ÀÄÄ Programs
      ³       ÀÄÄ Startup
      ÃÄÄ System32
      ³   ÀÄÄ Drivers
      ³       ÀÄÄ etc
      ÃÄÄ Temp
      ÀÄÄ Temporary Internet Files:ecgraphic.

:p.:ehp2.After installing manually from a .ZIP build it is essential to run
:font facename='Courier' size=14x8.OdinInst.EXE:font facename='Default' size=0x0. once.

:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :font facename='Courier' size=14x8.:ehp2.OdinInst.EXE:font facename='Default' size=0x0. updates all registry entries with its own
defaults&comma. no matter if the user provided his own customized entries.
:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.Odin and LotusSmartSuite share the same registry files. Lotus
SmartSuite comes with a program to reset the registry. This will also destroy
Odin's settings. After resetting the registry&comma. be sure to rerun
OdinInst.EXE.
:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.All current incarnations of :font facename='Courier' size=14x8.OdinInst.EXE:font facename='Default' size=0x0. have a bug&colon.
:p.If :font facename='Courier' size=14x8.OdinInst:font facename='Default' size=0x0. is typed ":font facename='Courier' size=14x8.OdinInst:font facename='Default' size=0x0." on the commandline&comma. it might hang. Type
":font facename='Courier' size=14x8.OdinInst.EXE:font facename='Default' size=0x0." instead of ":font facename='Courier' size=14x8.OdinInst:font facename='Default' size=0x0." (not case sensitive) to avoid the hang. A
hanging :font facename='Courier' size=14x8.OdinInst:font facename='Default' size=0x0. can be terminated by pressing CTRL-BREAK twice. This bug is
under investigation.
:p.:link reftype=hd res=100.:hp2.[Home]:elink.:ehp2. :link reftype=hd res=500.:hp2.[Previous]:elink.:ehp2. :link reftype=hd res=530.:hp2.[Next]:elink.:ehp2. 
:i1.OdinInst.EXE

:h2 res=530 x=right y=bottom width=70% height=100%.Configuring Odin - Odin.INI

:font facename='Default' size=0x0.:p.:font facename='Courier' size=14x8.Odin.INI:font facename='Default' size=0x0. stores a variety of configuration data that Odin uses to accommodate
differences between the OS&slr.2 and Win32 applications that may vary from
system to system. The file is created when you install Odin and&comma. if you
use the WarpIN installer&comma. it will be updated each time you install a new
build. If you install daily builds&comma. you will need to do the update
manually by running :link reftype=hd res=520.:font facename='Courier' size=14x8.:hp2.OdinInst:font facename='Default' size=0x0.:elink.:ehp2..EXE.

:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :font facename='Courier' size=14x8.:ehp2.Odin.INI:font facename='Default' size=0x0. is stored in the Odin&bsl.System32 directory. Older
builds placed :font facename='Courier' size=14x8.Odin.INI:font facename='Default' size=0x0. in the Odin directory - and if you find one
there&comma. delete it to avoid confusion. 
:p.:font facename='Courier' size=14x8.Odin.INI:font facename='Default' size=0x0. is a Windows 3.1-style INI file&comma. where the profile name has to
be in sqare brackets and the setting must come as settings name=settings
value. Currently the following settings can be configured in :font facename='Courier' size=14x8.Odin.INI:font facename='Default' size=0x0.&colon.
:lines align=left.:font facename='Courier' size=12x6.
:hp2.[COLORS]
:ehp2.UseWinColors      :font facename='Default' size=0x0.Use Windows colors:font facename='Courier' size=14x8.
                :font facename='Default' size=0x0.values&colon. 1&slr.0 (1 = Yes&comma. 0 = No):font facename='Courier' size=14x8.
                :font facename='Default' size=0x0.default&colon. 1:font facename='Courier' size=14x8.
SaveColors      :font facename='Default' size=0x0.Save&slr.restore colors to&slr.from :font facename='Courier' size=14x8.Odin.INI:font facename='Default' size=0x0.:font facename='Courier' size=14x8.
                :font facename='Default' size=0x0.values&colon. 1&slr.0 (1 = Yes&comma. 0 = No):font facename='Courier' size=14x8.
                :font facename='Default' size=0x0.default&colon. 0:font facename='Courier' size=14x8.
:hp2.[ODINSYSTEM]
:ehp2.HIGHMEM         :font facename='Default' size=0x0.Turns off high memory usage in Odin. Useful for Warp 4.5 systems:font facename='Courier' size=14x8.
                :font facename='Default' size=0x0.(FP#13 or better) that still use the old 16 bits TCP&slr.IP stack.:font facename='Courier' size=14x8.
                :font facename='Default' size=0x0.values&colon. 1&slr.0 (1 = Yes&comma. 0 = No):font facename='Courier' size=14x8.
                :font facename='Default' size=0x0.default&colon. 1:font facename='Courier' size=14x8.
INSTALLDATE     :font facename='Default' size=0x0.This setting is updated everytime :link reftype=hd res=520.:font facename='Courier' size=14x8.OdinInst.EXE:font facename='Default' size=0x0.:elink. is executed:font facename='Courier' size=14x8.
                :font facename='Default' size=0x0.:link reftype=hd res=550.OdinBug:elink. evaluates this when creating a bugreport.:font facename='Courier' size=14x8.
OS2Look         :font facename='Default' size=0x0.Creates an OS&slr.2 titlebar&comma. system menu&comma. min&slr.max&slr.close buttons.:font facename='Courier' size=14x8.
                :font facename='Default' size=0x0.Also overrides UseWinColors setting (uses OS&slr.2 colors).:font facename='Courier' size=14x8.
                :font facename='Default' size=0x0.values&colon. 1&slr.0 (1 = Yes&comma. 0 = No):font facename='Courier' size=14x8.
                :font facename='Default' size=0x0.default  0
:elines.:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.OS2Look can interfere with windows applications that draw their
own custom titlebar. (e.g. RealPlayer). In addition OS2Look ignores some of
Styler&slr.2's titlebar changes.
:lines align=left.:font facename='Courier' size=14x8.
:hp2.[Font Mapping]:ehp2.  :font facename='Default' size=0x0.Maps MS-Windows font names to OS&slr.2 fonts.:font facename='Courier' size=14x8.
MS Sans Serif=WarpSans  (default)
MS Shell Dlg 2=WarpSans (default):font facename='Default' size=0x0.
:elines.:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.Font names are case sensitive in OS&slr.2.
:lines align=left.:font facename='Courier' size=14x8.
:hp2.[WinVersion]
:ehp2.Version=Win98   :font facename='Default' size=0x0.-> Windows 98:font facename='Courier' size=14x8.
Version=WinME   :font facename='Default' size=0x0.-> Windows ME:font facename='Courier' size=14x8.
Version=NT4     :font facename='Default' size=0x0.-> Windows NT4  SP6 :font facename='Courier' size=14x8.
Version=Win2000 :font facename='Default' size=0x0.-> Windows 2000 SP2 (default):font facename='Courier' size=14x8.
Version=WinXP   :font facename='Default' size=0x0.-> Windows XP:font facename='Courier' size=14x8.
:elines.:font facename='Default' size=0x0.
:p.Used to override the version Odin reports to the application.
:lines align=left.:font facename='Courier' size=14x8.
:hp2.[TWAIN]
:ehp2.TwainIF         :font facename='Default' size=0x0.values 1&comma.2&comma.3 (default=1):font facename='Courier' size=14x8.
                :font facename='Default' size=0x0.1 -> Use CFM Twain Driver:font facename='Courier' size=14x8.
                :font facename='Default' size=0x0.2 -> Use STI Twain Driver (not supported at the moment):font facename='Courier' size=14x8.
                :font facename='Default' size=0x0.3 -> Use SANE Driver (not supported at the moment):font facename='Courier' size=14x8.

:hp2.[DirectDraw]
:ehp2.Fullscreen      :font facename='Default' size=0x0.Use&slr.don't use fullscreen DirectDraw:font facename='Courier' size=14x8.
                :font facename='Default' size=0x0.values&colon. 1&slr.0 (1 = Yes&comma. 0 = No):font facename='Courier' size=14x8.
                :font facename='Default' size=0x0.default  0:font facename='Courier' size=14x8.

:hp2.[WINMM]
:ehp2.DirectAudio     :font facename='Default' size=0x0.Use DirectAudio interface (if available) for wave playback:font facename='Courier' size=14x8.
                :font facename='Default' size=0x0.in WINMM and DSOUND.:font facename='Courier' size=14x8.
                :font facename='Default' size=0x0.values&colon. 1&slr.0 (1 = Yes&comma. 0 = No):font facename='Courier' size=14x8.
                :font facename='Default' size=0x0.default = 1:font facename='Courier' size=14x8.
                :font facename='Default' size=0x0.:hp2.Note&colon. :ehp2.Only available in SB Live! audio driver!:font facename='Courier' size=14x8.
DefVolume       :font facename='Default' size=0x0.Default waveout volume:font facename='Courier' size=14x8.
                :font facename='Default' size=0x0.default = 100:font facename='Courier' size=14x8.
:elines.:font facename='Default' size=0x0.
:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.The [CodePage] section found in earlier Odin.INI files is obsolete
and not used anymore!
:lines align=left.:font facename='Courier' size=14x8.
:hp2.[DLLRENAMEWIN]:ehp2. :font facename='Default' size=0x0.do not change these&comma. otherwise Odin will not work anymore!:font facename='Courier' size=14x8.
OLE32=OLE32OS2
NETAPI32=WNETAP32
OLEAUT32=OLAUTOS2
OPENGL=OPENGL32
WINSPOOL=WINSPOOL.DLL
MCICDA=MCICDA.DLL
CRTDLL=CRTDLL32

:hp2.[DLLRENAMEOS2]:ehp2. :font facename='Default' size=0x0.do not change these&comma. otherwise Odin will not work anymore!:font facename='Courier' size=14x8.
OLE32OS2=OLE32
WNETAP32=NETAPI32
OLAUTOS2=OLEAUT32
OPENGL32=OPENGL
WINSPOOL=WINSPOOL.DRV
MCICDA=MCICDA.DRV
CRTDLL32=CRTDLL
:elines.:font facename='Default' size=0x0.
:p.:link reftype=hd res=100.:hp2.[Home]:elink.:ehp2. :link reftype=hd res=520.:hp2.[Previous]:elink.:ehp2. :link reftype=hd res=540.:hp2.[Next]:elink.:ehp2. 
:i1.Odin.INI

:h2 res=540 x=right y=bottom width=70% height=100%.The first application - OdinApp.EXE

:font facename='Default' size=0x0.:p.:font facename='Courier' size=14x8.OdinApp:font facename='Default' size=0x0. is a Win32 application. It serves two purposes&colon.
:ol.
:li.When :font facename='Courier' size=14x8.OdinApp:font facename='Default' size=0x0. is installed&comma. the installer also installs some core
Microsoft runtime DLLs&colon.
:ul compact.
:li.MSVCRT40.DLL
:li.MSVCIRT.DLL
:li.MSVCRT.DLL
:li.MFC42.DLL
:eul.
:p.The Microsoft license does not allow Netlabs to distribute these DLLs with
Odin. They must be distributed as part of a Win32 application. 
:li.If :font facename='Courier' size=14x8.OdinApp:font facename='Default' size=0x0. installs and runs successfully&comma. it indicates your Odin setup
has no major problems. It opens a window&comma. presents an empty file browser
window all within a single window. :font facename='Courier' size=14x8.OdinApp:font facename='Default' size=0x0. has no useful functionality e.g.
you cannot perform a particular task with it. You can play with it by creating
multiple child windows&comma. print these empty windows (and get a blank page
out of the printer). But that is all&comma. folks!
:li.If installed and run successfully&comma. :font facename='Courier' size=14x8.OdinApp:font facename='Default' size=0x0. looks like this&colon.
:eol.
:artwork align=center name='E:\DEV\INF\ODINDOC\ODINAPP.BMP' .
:p.You can get :font facename='Courier' size=14x8.OdinApp:font facename='Default' size=0x0. from the same location as the build files.
:p.:link reftype=hd res=100.:hp2.[Home]:elink.:ehp2. :link reftype=hd res=530.:hp2.[Previous]:elink.:ehp2. :link reftype=hd res=550.:hp2.[Next]:elink.:ehp2. 
:i1.OdinApp.EXE
:i1.HelloWorld.EXE
:i1.Microsoft runtime DLLs

:h2 res=550 x=right y=bottom width=70% height=100%.Reporting bugs - OdinBug.EXE

:font facename='Default' size=0x0.:p.OdinBug is a helper application for Odin. Its purpose is to ease the creation
of proper bug reports&comma. so in other words it is a bug report generator.
:p.If everything goes well&comma. you just have to specify a proper logfile and
some more (non technical) information. OdinBug does (or should do) the rest
for you.
:p.OdinBug has its own extensive on-line help file with explanations
on how to create logfiles and bug reports.
:p.Only debug builds can generate logfiles.
:p.In order to enable a debug build to generate logfiles the
environment variable
:p.:font facename='Courier' size=14x8.SET WIN32LOG_ENABLED=1
:p.:font facename='Default' size=0x0.must be set.
:p.You have 2 possibilities&colon.
:ol.
:li.Put :font facename='Courier' size=14x8.SET WIN32LOG_ENABLED=1:font facename='Default' size=0x0. into your :font facename='Courier' size=14x8.CONFIG.SYS:font facename='Default' size=0x0.. This will enable
logging for all Win32 programs run. If you want a particular
program to run without logging&comma. you have to type :font facename='Courier' size=14x8.SET
WIN32LOG_ENABLED=:font facename='Default' size=0x0. (no value) on the commandline to clear the
variable. This effects only the session in which you cleared the
variable. I do not recommend to put :font facename='Courier' size=14x8.SET WIN32LOG_ENABLED=1:font facename='Default' size=0x0. into
:font facename='Courier' size=14x8.CONFIG.SYS:font facename='Default' size=0x0..
:li.Type :font facename='Courier' size=14x8.SET WIN32LOG_ENABLED=1:font facename='Default' size=0x0. in the session in which you want to
run a particular Win32 program with logging. Win32 programs in
other sessions will still run without logging. This is the
recommended procedure.
:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.DragText by R. L. Walsh provides an extended WPS
class for program objects that allows you to enter environment
variables into the settings pages of a programs object (this is
one of the freeware features).
:artwork align=center name='E:\DEV\INF\ODINDOC\DTPROG.BMP' .
:p.This will enable logging for the program started from this
object. Removing the entry will disable logging again.
:eol.
:p.For details about logging and bug reporting&comma. please&comma.
read the OdinBug on-line help file&comma. which does not only
serve as an online help but also as a full fledged manual for
everything concerning bugs and reporting them.
:p.:link reftype=hd res=100.:hp2.[Home]:elink.:ehp2. :link reftype=hd res=540.:hp2.[Previous]:elink.:ehp2. :link reftype=hd res=560.:hp2.[Next]:elink.:ehp2. 
:i1.bug reports
:i1.OdinBug
:i1.reporting bugs
:i1.DragText

:h2 res=560 x=right y=bottom width=70% height=100%.Using Glide with 3dfx cards - OpenGL3dfx.ZIP

:font facename='Default' size=0x0.:p.To run DirectDraw games or Quake 2 in Voodoo mode (Voodoo 2 or 3)&comma. you
must install Holger
Veit's XFree86&slr.2 support driver (:font facename='Courier' size=14x8.XF86SUP.SYS:font facename='Default' size=0x0.). You should have a line
like
:p.:font facename='Courier' size=14x8.DEVICE=x&colon.&bsl.OS2&bsl.BOOT&bsl.XF86SUP.SYS:font facename='Default' size=0x0.
:p.in your :font facename='Courier' size=14x8.CONFIG.SYS:font facename='Default' size=0x0. where x&colon. is your boot drive.
:p.You can get :font facename='Courier' size=14x8.XF86SUP.SYS:font facename='Default' size=0x0. from
:link reftype=fn refid=6.http&colon.&slr.&slr.ais.gmd.de&slr.veit&slr.os2&slr.xf86sup.html:elink..
:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.The Glide and 3Dfx OpenGL DLL's are no longer part of the basic
Odin installation package. Development is halted on the 3dfx package.
:p.You can get OpenGL3dfx.ZIP from the same :link reftype=hd res=340.locations:elink. as the build files.
:p.:link reftype=hd res=100.:hp2.[Home]:elink.:ehp2. :link reftype=hd res=550.:hp2.[Previous]:elink.:ehp2. :link reftype=hd res=570.:hp2.[Next]:elink.:ehp2. 
:fn id=6.:p.:link reftype=launch object='NETSCAPE.EXE' data='http://ais.gmd.de/veit/os2/xf86sup.html'.http&colon.&slr.&slr.ais.gmd.de&slr.veit&slr.os2&slr.xf86sup.html:elink.:efn.


:i1.Glide
:i1.OpenGL
:i1.3dfx
:i1.Voodoo
:i1.XF86SUP.SYS

:h2 res=570 x=right y=bottom width=70% height=100%.Installing Win32 programs

:font facename='Default' size=0x0.:p.Generally&comma. you install applications as you would under Windows. You may
have to make some accommodations&comma. because they are Windows applications
after all.

:p.Most Win32 applications come packaged as a self-extracting executable with
built-in installers. 

:p.There are a couple of installers&colon.
:ul compact.
:li.Full 32-bit
:li.Full 16-bit
:eul.
:p.Odin should have no problems running the 32-bit installers unless they happen
to require some feature not yet implemented by Odin.

:p.The 16-bit installers can be a problem. Odin can not yet run these directly.
If they are run under WinOS2&comma. these installers will eventually attempt
to run 32-bit code and fail.

:p.Sometimes the 16-bit part of the installer&comma. usually setup.exe&comma. can
be replaced with a 32-bit version. The Yahoo OdinUsers group maintains an
OdinUsers File Repository which contains setup.exe's for some of the widely
used Win32 installers. 

:p.Sometimes&comma. the 16-bit part of the installer can be run under WinOS2. It
will fail&comma. but may leave behind the decompressed 32-bit programs. These
can be run under Odin to complete the install. It might help to copy the
decompressed files somewhere else before trying to run them.

:p.If all else fails you can try to copy the installation from your Windows
machine. But&comma. it will not work if the application needs the installer to
set up registry entries. However&comma. some users are persistent and have
succeeded in copying the registry entries using RegEdit32 running under Odin.

:p.From 09&slr.2001 to 01&slr.2002 there was a 5 part article series on the
OS&slr.2 Voice Newsletter covering all aspects of the installation of Win32
applications on OS&slr.2 using Odin.

:p.You can find them at :link reftype=launch object='NETSCAPE.EXE' data='http://www.os2voice.org'.http&colon.&slr.&slr.www.os2voice.org:elink.!

:p.Part 1&colon. Why are so many installation packages not working with Odin? 
:link reftype=launch object='NETSCAPE.EXE' data='http://www.os2voice.org/vnl/past_issues/vnl0901h/vnewsf7.htm'.http&colon.&slr.&slr.www.os2voice.org&slr.vnl&slr.past_issues&slr.vnl0901h&slr.vnewsf7.htm:elink.
:p.Part 2&colon. Excursion&colon. Self-expanding installation packages based upon
InstallShield
:link reftype=launch object='NETSCAPE.EXE' data='http://www.os2voice.org/vnl/past_issues/vnl1001h/vnewsf6.htm'.http&colon.&slr.&slr.www.os2voice.org&slr.vnl&slr.past_issues&slr.vnl1001h&slr.vnewsf6.htm:elink.
:p.Part 3&colon. Unpacked - how to get everything in the right place?
:link reftype=launch object='NETSCAPE.EXE' data='http://www.os2voice.org/VNL/past_issues/VNL1101H/vnewsf6.htm'.http&colon.&slr.&slr.www.os2voice.org&slr.VNL&slr.past_issues&slr.VNL1101H&slr.vnewsf6.htm:elink.
:p.Part 4&colon. Registry issues - how do I find out what belongs into the registry?
:link reftype=launch object='NETSCAPE.EXE' data='http://www.os2voice.org/VNL/past_issues/VNL1201H/vnewsf6.htm'.http&colon.&slr.&slr.www.os2voice.org&slr.VNL&slr.past_issues&slr.VNL1201H&slr.vnewsf6.htm:elink.
:p.Part 5&colon. It's still not working - what can you do now?
:link reftype=launch object='NETSCAPE.EXE' data='http://www.os2voice.org/VNL/past_issues/VNL0102H/vnewsf5.htm'.http&colon.&slr.&slr.www.os2voice.org&slr.VNL&slr.past_issues&slr.VNL0102H&slr.vnewsf5.htm:elink.

:p.:link reftype=hd res=100.:hp2.[Home]:elink.:ehp2. :link reftype=hd res=560.:hp2.[Previous]:elink.:ehp2. :link reftype=hd res=580.:hp2.[Next]:elink.:ehp2. 
 
:i1.installing Win32 programs
:i1.16 bit installers
:i1.32 bit installers
:i1.WinOS2
:i1.OS&slr.2 Voice Newsletter
:i1.Voice
:i1.articles about installation

:h2 res=580 x=right y=bottom width=70% height=100%.Some popular Windows programs that (usually) work

:font facename='Default' size=0x0.:p.The following applications work quite well with Odin and might be interesting
things to start with&colon.
:ul.
:li.:hp2.FreeCell:ehp2. (Oh yeah!)
:p.Be sure to use a FreeCell either from the Win32s package or from Windows
NT&comma. as the one that comes with Windows 95&slr.98&slr.ME is still 16 bit
and does not work with Odin. You need :font facename='Courier' size=14x8.FREECELL.EXE&comma. FREECELL.HLP:font facename='Default' size=0x0. and
:font facename='Courier' size=14x8.CARDS.DLL:font facename='Default' size=0x0. to run it!
:li.:hp2.Adobe Acrobat 4.0:ehp2. (not 4.05 and not 5.0)
:p.You must replace the 16 bit setup files with their 32 bit counterparts&comma.
described in the previous chapter.
:p.In order to display text correctly you must turn off "smooth text" in the
"preferences dialog" otherwise it works nicely.
:li.:hp2.RealPlayer 7 or 8 basic
:p.:ehp2.Fullscreen and double size is usually distorted&comma. otherwise works very
well. Make sure you have unchecked the startcenter option in the settings
notebook.
:artwork align=center name='E:\DEV\INF\ODINDOC\RPSTCTR.BMP' .
:li.:hp2.Lotus Notes 5.0x:ehp2. client (version 5.09a being current)
:p.It has to be installed on a Windows system first. Then one has to
copy the entire Notes directory tree to the Odin partition. When
bringing over from the Windows machine make sure to edit the
NOTES.INI to have the Notes Data Path and WinNTIconPath point the
appropriate paths on the Odin system.
:p.Be aware that it may work for a long time and then completely
lock up your machine&comma. with nothing left than
Ctrl-Alt-Del&comma. though it could be killed successfully with
kill.exe occasionally (available on dink.org). 
:li.:hp2.Palm Desktop&colon. :ehp2.Take a look at Tereul De Campo's article on running Palm desktop under Odin at :link reftype=launch object='NETSCAPE.EXE'
data='http://www.os2voice.org/VNL/past_issues/VNL0301H/vnewsf4.htm'.http&colon.&slr.&slr.www.os2voice.org&slr.VNL&slr.past_issues&slr.VNL0301H&slr.vnewsf4.htm.:elink.
:li.:hp2.CALC.EXE:ehp2. and :hp2.TELNET.EXE:ehp2. from Win95&slr.98 work well.
:li.:hp2.Home Planet 3.0:ehp2. (an astronomy application) also works well.
:eul.
:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.Although these applications generally work&comma. you will
probably experience infrequent crashes.
:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.There is a large database of tested applications at the Odin site
at Netlabs.
:p.:link reftype=hd res=100.:hp2.[Home]:elink.:ehp2. :link reftype=hd res=570.:hp2.[Previous]:elink.:ehp2. :link reftype=hd res=600.:hp2.[Next]:elink.:ehp2. 
 
:i1.applications that work
:i1.RealPlayer
:i1.Adobe Acrobat
:i1.FreeCell
:i1.Palm Desktop
:i1.Home Planet
:i1.Telnet
:i1.Calc

:h1 res=600 x=right y=bottom width=70% height=100%.License and warranty

:font facename='Default' size=0x0.:p.:hp8.EXCEPT AS OTHERWISE RESTRICTED BY LAW&comma. THIS WORK IS PROVIDED WITHOUT ANY
EXPRESSED OR IMPLIED WARRANTIES OF ANY KIND&comma. INCLUDING BUT NOT LIMITED
TO&comma. ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE&comma.
MERCHANTABILITY OR TITLE. EXCEPT AS OTHERWISE PROVIDED BY LAW&comma. NO
AUTHOR&comma. COPYRIGHT HOLDER OR LICENSOR SHALL BE LIABLE TO YOU FOR DAMAGES
OF ANY KIND&comma. EVEN IF THEY HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH
DAMAGES.:ehp8.
:p.The following license applies to Project Odin&colon. :link reftype=launch object='E.EXE' data='LICENSE.TXT'.Click here to read!:elink.
:p.The following license applies to WGSS50 library&colon. :link reftype=launch object='E.EXE' data='WGSS50.LIC'.Click here to read!:elink.
:p.:link reftype=hd res=100.:hp2.[Home]:elink.:ehp2. :link reftype=hd res=580.:hp2.[Previous]:elink.:ehp2. :link reftype=hd res=700.:hp2.[Next]:elink.:ehp2. 
:i1.license
:i1.warranty

:h1 res=700 x=right y=bottom width=70% height=100%.Project participation, getting help

:font facename='Default' size=0x0.:p.:hp2."Do not ask&comma. what Odin can do for you&comma. ask what you can do for
Odin!"
:artwork align=left name='E:\DEV\INF\ODINDOC\UNCLESAM.BMP'.
:p.:hp9.:ehp2.WANTED&colon. We are still looking for talented developers that want to
contribute!:ehp9.

:p.As Odin became an open source project&comma. everybody is kindly invited to
contribute his&slr.her share to the progress of the project. May it be active
coding&comma. fixing bugs or just providing detailed information about
examined problems.
:p.There is no formal support infrastructure for Odin. Please&comma. remember
most work on Odin is done by a few volunteers in their spare time.
:p.The following mailing lists are considered to be the universal platform for
people needing help and people wishing to contribute.

:p.We suggest you subscribe to&colon.
:ul.
:li.:hp2.OdinUsers:ehp2. for endusers wishing to contribute&comma. discussing about
problems&comma. getting help.
:li.:hp2.Win32OS2-WAI:ehp2. for developers wishing to contribute.
:eul.
:p.on :link reftype=fn refid=10.http&colon.&slr.&slr.www.yahoogroups.com:elink..

:p.In case you are interested in participating&comma. every member of the project
will
be happy to give you direction to the right places and to give a personal
introduction to further development of the particular modules.

:p.:artwork align=left name='E:\DEV\INF\ODINDOC\RD_PIN.BMP' runin.:hp2.Note&colon. :ehp2.There is another mailing list named :hp2.Win32OS2:ehp2. at YahooGroups. It is
also Odin-related&comma. but is considered outdated and obsolete.
:p.:link reftype=hd res=100.:hp2.[Home]:elink.:ehp2. :link reftype=hd res=600.:hp2.[Previous]:elink.:ehp2. :link reftype=hd res=800.:hp2.[Next]:elink.:ehp2. 

:fn id=10.:p.:link reftype=launch object='NETSCAPE.EXE' data='http://www.yahoogroups.com'.http&colon.&slr.&slr.www.yahoogroups.com:elink.:efn.

:i1.participation
:i1.support
:i1.getting help

:h1 res=800 x=right y=bottom width=70% height=100%.Odin related links

:font facename='Default' size=0x0.:p.The following links might be interesting for anybody needing information about
Odin&colon.
:ul.
:li.Netlabs at :link reftype=launch object='NETSCAPE.EXE' data='http://odin.netlabs.org'.http&colon.&slr.&slr.odin.netlabs.org:elink.
:ul compact.
:li.:link reftype=fn refid=3.ftp&colon.&slr.&slr.ftp.netlabs.org&slr.pub&slr.odin&slr.daily:elink.
:li.:link reftype=fn refid=4.ftp&colon.&slr.&slr.ftp.netlabs.org&slr.pub&slr.odin&slr.weekly:elink.
:eul.
:li.OS2.org at :link reftype=launch object='NETSCAPE.EXE' data='http://www.os2.org'.http&colon.&slr.&slr.www.os2.org:elink.
:ul compact.
:li.:link reftype=fn refid=1.ftp&colon.&slr.&slr.ftp.os2.org&slr.odin&slr.daily:elink.
:li.:link reftype=fn refid=2.ftp&colon.&slr.&slr.ftp.os2.org&slr.odin&slr.weekly:elink.
:eul.
:li.Innotek Systemberatung at :link reftype=launch object='NETSCAPE.EXE' data='http://www.innotek.de'.http&colon.&slr.&slr.www.innotek.de:elink.
:ul compact.
:li.The company backing Odin! Also take a look at their other products!
:eul.
:li.OS&slr.2 VOICE newsletter at :link reftype=launch object='NETSCAPE.EXE' data='http://www.os2voice.org'.http&colon.&slr.&slr.www.os2voice.org:elink.
:ul compact.
:li.Running Palm Desktop under Odin (by Tereul De Campo) at
:link reftype=launch object='NETSCAPE.EXE' data='http://www.os2voice.org/VNL/past_issues/VNL0301H/vnewsf4.htm'.http&colon.&slr.&slr.www.os2voice.org&slr.VNL&slr.past_issues&slr.vnl0301h&slr.vnewsf4.htm.:elink.
:li.Part 1&colon. Why are so many installation packages not working with Odin? 
:link reftype=launch object='NETSCAPE.EXE' data='http://www.os2voice.org/vnl/past_issues/vnl0901h/vnewsf7.htm'.http&colon.&slr.&slr.www.os2voice.org&slr.vnl&slr.past_issues&slr.vnl0901h&slr.vnewsf7.htm:elink.
:li.Part 2&colon. Excursion&colon. Self-expanding installation packages based upon
InstallShield
:link reftype=launch object='NETSCAPE.EXE' data='http://www.os2voice.org/vnl/past_issues/vnl1001h/vnewsf6.htm'.http&colon.&slr.&slr.www.os2voice.org&slr.vnl&slr.past_issues&slr.vnl1001h&slr.vnewsf6.htm:elink.
:li.Part 3&colon. Unpacked - how to get everything in the right place?
:link reftype=launch object='NETSCAPE.EXE' data='http://www.os2voice.org/VNL/past_issues/VNL1101H/vnewsf6.htm'.http&colon.&slr.&slr.www.os2voice.org&slr.VNL&slr.past_issues&slr.vnl1101h&slr.vnewsf6.htm:elink.
:li.Part 4&colon. Registry issues - how do I find out what belongs into the registry?
:link reftype=launch object='NETSCAPE.EXE' data='http://www.os2voice.org/VNL/past_issues/VNL1201H/vnewsf6.htm'.http&colon.&slr.&slr.www.os2voice.org&slr.VNL&slr.past_issues&slr.vnl1201h&slr.vnewsf6.htm:elink.
:li.Part 5&colon. It's still not working - what can you do now?
:link reftype=launch object='NETSCAPE.EXE' data='http://www.os2voice.org/VNL/past_issues/VNL0102H/vnewsf5.htm'.http&colon.&slr.&slr.www.os2voice.org&slr.VNL&slr.past_issues&slr.vnl0102h&slr.vnewsf5.htm:elink.
:eul.
:li.OS&slr.2 e-zine newsletter at :link reftype=launch object='NETSCAPE.EXE' data='http://www.os2ezine.com'.http&colon.&slr.&slr.www.os2ezine.com:elink.
:li.OS&slr.2 Connect newsletter at :link reftype=launch object='NETSCAPE.EXE' data='http://www.os2ss.com/connect'.http&colon.&slr.&slr.www.os2ss.com&slr.connect:elink.
:li.SCOUG (Southern California OS&slr.2 User Group) at
:link reftype=launch object='NETSCAPE.EXE' data='http://www.scoug.com'.http&colon.&slr.&slr.www.scoug.com:elink.
:ul compact.
:li.Search for "Odin" in order to find further information!
:eul.
:li.Wine Headquarters at :link reftype=launch object='NETSCAPE.EXE' data='http://www.winehq.com'.http&colon.&slr.&slr.www.winehq.com:elink.
:ul compact.
:li.Wine is for Linux what Odin is for OS&slr.2. In addition&comma. Odin is partly
based on work of the Wine people.
:eul.
:eul.
:p.:link reftype=hd res=100.:hp2.[Home]:elink.:ehp2. :link reftype=hd res=700.:hp2.[Previous]:elink.:ehp2. :link reftype=hd res=900.:hp2.[Next]:elink.:ehp2. 
:i1.links

:h1 res=900 x=right y=bottom width=70% height=100%.Contributors to this manual

:font facename='Default' size=0x0.:artwork align=center name='E:\DEV\INF\ODINDOC\ODINBANN.BMP' .
:p.This manual is copyrighted material.
:p.This compilation was done from January to April 2002 by&colon.

:p.:link reftype=fn refid=998.Herwig:elink. Bauernfeind (:link reftype=fn refid=999.herwig.bauernfeind@aon.at:elink.)
:p.Send corrections&comma. additions or whatever either directly to me or to the
odinusers list at Yahoo.

:p.The following sources have been used and were partly merged into this
manual&colon.
:ul.
:li.The old ReadMe.TXT dated 1999&slr.11&slr.16&comma. last modified on
2001&slr.04&slr.18&comma. that came with every Odin build done by&colon.
:ul compact.
:li.Sander van Leeuwen&comma. 
:li.Achim Hasenm&ue.ller and 
:li.Knut Stange Osmundsen
:eul.
:li.The article at
:link reftype=launch object='NETSCAPE.EXE' data='http://www.scoug.com/OS24U/2001/SCOUG009.ODINTODAY.HTML'.http&colon.&slr.&slr.www.scoug.com&slr.OS24U&slr.2001&slr.SCOUG009.ODINTODAY.HTML:elink. done by&colon.
:ul compact.
:li.Steven Levine for SCOUG 08&slr.2001. Thanks for the kind permission to use it.
:eul.
:li.The following persons contributed information&comma. ideas&comma. concepts and
proof reading to this manual&colon.
:ul compact.
:li.Seth Berkowitz (a lot of proof reading&comma. ideas and concepts)
:li.Mark Abramowitz (screenshots)
:li.Derek Wright (ideas&comma. concepts)
:li.Steven Levine (persuasion&comma. information)
:li.Sander van Leeuwen (information)
:eul.
:eul.
:fn id=998.:p.:artwork align=left name='E:\DEV\INF\HERWIG.BMP' runin.:p.You got me!:efn.
:fn id=999.:p.mailto&colon. herwig.bauernfeind@aon.at:efn.
:p.:link reftype=hd res=100.:hp2.[Home]:elink.:ehp2. :link reftype=hd res=800.:hp2.[Previous]:elink.:ehp2. :link reftype=hd res=100.:hp2.[Next]:elink.:ehp2. 






:euserdoc.