_____________________________________________________________________________

wpsMon - Workplace Shell Monitor Application for IBM OS/2
_____________________________________________________________________________

Version : 1.0

Date of creation: 01.10.2009
Last update     : 04.12.2009

Project : ObjectWorkplace Embedded Desktop
Internet: http://www.objectworkplace.org
Category: Development tools for high level object class programming
Target  : Research systems (IBM OS/2)
Author  : Clemens-E. Fischer

Homepage: http://software.cefischer.de
E-mail  : inbox@objectworkplace.org

Copyright (c) 2009 cefischer, Germany. All rights reserved.
_____________________________________________________________________________


I. SYNOPSIS
wpsMon is a small PM (Presentation Manager) application used during the early
development phase of OWP (ObjectWorkplace) on OS/2 for the purpose of high
level object class (document class) engineering.

High level OWP object classes can be derived from WPS (WorkplaceShell) classes.
The preferred WPS ancestor class is WPFileSystem which acts as parent for the
owpStorage class in the OWP research environment. Thus, besides some minor 
restrictions, WPS can simulate the OWP environment quite well. 

OWP classes must be registered with WPS. This is a fairly easy process. After
registration is complete, the class can be used immediately. Replacing the class 
library during class development for testing, however, is more complex. It 
requires the termination of WPS for the class library cannot be replaced with
a new version as long as WPS is running. Unfortunately, there is no function 
designed into WPS for termination and restarting which complicates testing new
object classes. wpsMon resolves this problem by providing the desired function.


II. FUNCTION
wpsMon can start and terminate WPS on behalf of the user or when object class
libraries are to be replaced during runtime. Additionally, it offers functions
for registration, deregistration and replacement of classes, in detail:

o Querying and refreshing a list containing the WPS class tree at every 
  startup of the program and during runtime as requested or required by
  function.

o Registering new object classes and deregistering and/ or replacing object 
  classes already registered with the system.

o Restarting WPS for object class library replacement.

Refer to the help function of the program itself for getting more information
on all functions currently implemented.

Note: wpsMon does not allow to be terminated, even though the window close 
button and corresponding system menu item are present and functional. Never 
terminate wpsMon from the system's switch list when WPS is active which would
cause wpsMon to close and do not come up again. 


III. INSTALLATION 
wpsMon does not come with an installation program. It is distributed as single
executable module along with this README file and installed by performing the 
following steps:

1) Copy the WPSMON.EXE file into a directory mentioned in the PATH environment
   variable, e.g. C:\OS2. Alternatively, a new directory can be created the
   WPSMON.EXE file can be copied to. In this case, do not forget to add the
   new directory to the PATH environment variable.

2) Open the file CONFIG.SYS. 

3) Locate the statement SET RUNWORKPLACE which is usually set to PMSHELL.EXE
   and comment it out, e.g.: 

   REM SET RUNWORKPLACE=C:\OS2\PMSHELL.EXE

4) Add a new RUNWORKPLACE statement to CONFIG.SYS with the directory the 
   file WPSMON.EXE was copied to, e.g.:

   SET RUNWORKPLACE=C:\OS2\WPSMON.EXE.

5) Save the CONFIG.SYS file.

6) Perform a system shutdown and then reboot the system.

After restarting the system, the wpsMon program window appears on the screen.
Press CTRL+S to start WPS, CTRL+T to terminate it and CTRL+C to shutdown the
system. You can safely terminate wpsMon for reinitialization if any problem 
should arise. The protected mode shell workplace monitor thread will restart
wpsMon automatically.


IV. DEINSTALLATION 
Deinstalling wpsMon is easy for the program does not make any changes to the
OS/2 environment. Simply comment out or erase the RUNWORKPLACE statement 
corresponding to wpsMon and reactivate the original RUNWORKPLACE statement.
After restarting the system, the WPSMON.EXE file can be removed.


V. UPDATING 
Updating wpsMon is done by commenting out the RUNWORKPLACE statement which
corresponds to the program and uncommenting the RUNWORKPLACE statement
correspondig to PMSHELL.EXE. Then shutdown and restart your system. After
the system has been restarted you can replace the old WPSMON.EXE file with
a new one. Then change the RUNWORKPLACE statements accordingly and again
shutdown and restart your system so that the changes can take effect. 


VI. SUPPORT
wpsMon is part of the ObjectWorkplace Research Toolbox Software Programme.
and currently under support.

Support by e-mail is provided by cefischer through the division 
cefischer solutions, maintainer of the ObjectWorkplace project. Send 
requests to support@cefischer-solutions.de.

Comments regarding the program are always welcome.

Updated program versions can be downloaded from software.cefischer.de
at no charge. E-mail support is free.


VII. LICENCE
Please read the file LICENCE regarding the licence under which wpsMon is 
distributed. By using this program you agree to the terms and conditions
defined within the LICENCE file.

_____________________________________________________________________________

END OF FILE 