
             WPSam - WorkPlaceShell Access Manager

*** READ THE FOLLOWING INSTRUCTIONS CAREFULLY BEFORE INSTALLATION ***

**************************     ATTENTION     *************************

If you use WORKFRAME/2 Version 2.1 (software development environment),
you will run in problems when using WPSAM due to bugs within WF/2 2.1.
Please read the paragraph concerning WF/2 2.1 at the end of this file.

**************************     ATTENTION     *************************


        Description

WPSAM is an Extension of the  Workplace Shell of OS/2 2.1 and like the
WPS itself implemented  completely in SOM.  Therefore working with and
Installing of WPSam  is somehow  different from  what you  are used to
from other programs or operating systems.



        Install Program

This install  program  is designed  to be on a  diskette drive  in the
"\"-directory. Have at least the file WPSAM on a diskette.

Additionally make shure to be on  the root desktop when you start this
installation program. When you  install first time this is necessarily
the case but remember it when deinstalling.



        InitOS2

During installation you may select  whether to install InitOS2 or not.
InitOS2  is  an  additional   program  asking  for a  user  name  and,
optionally, for  a password during  boot of OS/2.  This serves for two
purposes:

1.) Access protection for the computer (mostly in connection with a
    ROM BIOS avoiding booting from drive A: and containing password
    protection itself.

2.) Creation of users having not only a separate Desktop and OS2.INI
    but also their own OS2SYS.INI and are fully independant from the
    "root desktop"  therefore. This  could be  rather useful  during
    software development or usage of slightly buggy software or when
    using software not compatible with another product.

Note: When installing with InitOS2, you are prompted for a user name
      and password already during  the next bootup. The default user
      name for the root desktop is "ROOT" !!


        How WPSam works

WPSam is a  program bundle,  allowing to  create and  handle different
desktops.

Every desktop is stored together with the corresponding INI files in a
special folder, the so called user container (shortcut user).

To switch to  another desktop  simply double click  the user container
belonging to.  It is also possible to enter  the user name during boot
of the computer.

There is a  template for a  user container contained  in the templates
folder. Please note that a new desktop is created for every user. This
is the same action as is done during the first boot after installation
of OS/2. Please be patient when a new user is opened first time.


        Deinstallation

Due to the fact that WPSam is  an extension to the workplace shell and
gears into it you should not  try to deinstall WPSam by deleting files
or INI  file entries.  Please use this  installation program  for that
purpose. It removes not only the installed files but also entries made
in INI files.  Only users created by you have to be removed by hand if
you don't want to install WPSam later.  If you don't remove users this
causes no harm to  your system - there are only  some files left which
are invisible for the WPS.

Please note that you  have to be  on the  root desktop  when using the
installation program for deinstallation also.


        Workframe WF/2 Version 2.1

IBM WorkFrame/2 version 2.1 has a bug,  that destroyes the consistency
of data in OS2SYS.INI.  You will mention this  without an installation
of WPSam when generating a new OS2.INI file using the program MAKEINI.
If you  reboot your  computer after  doing so,  you will  get an error
message "Workplace shell not found".  You will notice exactly the same
error, if you start an uninitialized new user.

We  recommend the  following:  Install  WF/2  only  in a  private user
session.

A lot of users will have the problem, that they have already used WF/2
before an  installation of  WPSam and  they therefore  already have an
inconsistent "root desktop".

Here a possible remedy:

 o Boot with the installation disk. 
 o Copy OS2.INI and OS2SYS.INI to another location and generate new
   ones. Move the directory "desktop" to another location.
 o Reboot your computer. 
 o Install WPSam. 
 o Generate a user, but don't initialize it (don't start it). Mark the
   user as a "private" one.
 o Use the drive icons to move the old desktop directory and the *.INI
   files into the new user folder.
 
Now the  new desktop  is the  root desktop,  whereas the  old one is a
private user, that may be started using InitOS2.

You will find  this paragraph again  in the online manual WPSAM.INF in
the EXE path you selected during install.
