
	IBM SOMobjects Win32 Toolkit Samples : Beta Version
	----------------------------------------------------


/*
 *
 * DISCLAIMER OF WARRANTIES.
 * The following [enclosed] code is sample code created by IBM
 * Corporation. This sample code is not part of any standard or IBM
 * product and is provided to you solely for the purpose of assisting
 * you in the development of your applications.  The code is provided
 * "AS IS". IBM MAKES NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT
 * NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
 * FOR A PARTICULAR PURPOSE, REGARDING THE FUNCTION OR PERFORMANCE OF
 * THIS CODE.  IBM shall not be liable for any damages arising out of
 * your use of the sample code, even if they have been advised of the
 * possibility of such damages.
 *
 * DISTRIBUTION.
 * This sample code can be freely distributed, copied, altered, and
 * incorporated into other software, provided that it bears the above
 * Copyright notice and DISCLAIMER intact.
 */




The samples contained in the subdirectories of this directory are:

somk  - the SOM Run-time Kernel
somd  - the Distributed SOM Framework
somi  - the SOM Interface Repository Framework
somem - the SOM Event Manager
some  - the SOM Emitter Framework

Please refer to the readme files contained in the subdirectories for
more information on the sample programs.


To build the samples you must have first set up your environment for
SOM or you may run the somenv.bat command file.  In general, you must
build the toolkit bindings with the SOMCORBA command and if you are
using C++ you must also run the SOMXH command.


The following table outlines which samples use which set of bindings.

Samples                          Supported Bindings
--------------------------------------------------------------
somk
	\c\tp			SOMSTARS
	\c\animals		SOMSTARS
	\cpp\simple		(SOMSTARS or SOMCORBA) + SOMXH
	\cpp\derived		(SOMSTARS or SOMCORBA) + SOMXH

somd
	\cpp\event.gui		(SOMSTARS or SOMCORBA) + SOMXH
	\stack.gui		(SOMSTARS or SOMCORBA) + SOMXH
	\dii.gui		(SOMSTARS or SOMCORBA) + SOMXH
	\animal.gui		(SOMSTARS or SOMCORBA) + SOMXH
	
some				NA

somi
	\c\irdump.gui		SOMCORBA

somem
	\c\emdemo.gui		SOMCORBA


Make sure that you run "nmake clean" before you build any samples to
avoid using old files such as som.ir.  Also, refer to the readme files
contained in the subdirectories for more information and prerequisites
for the sample programs.

If you are a Microsoft Visual C++ 2.0 user, you can build the samples
using "nmake -f makefile.msc all" from a given samples directory.
Alternatively, you may build the samples from the Microsoft Visual 
C++ Integrated Development Environment (IDE):
        
        1. Bring up Microsoft Visual C++ IDE. Select the "Options"
	   choice from the Tools Menu.  Click on the "Directories"
	   notebook tab and add the SOM Toolkit directories for the
	   options Lib, Executables, and Include.

           For example if your toolkit is installed on c:\som
           then Add a directory for Lib by adding the directory
           c:\som\lib. Executables c:\som\bin. Include c:\som\include.

           You only have to do this step once as Visual C++ will
           remember these settings from session to session.

	2. Optional: Rename "makefile.msc" to "makefile.mak" 
           in the samples directory. (MSVC already looks for "*.mak"
	   files in the "Open" dialog box thus saving you a little
           typing.)

	3. Open the makefile.mak from File Menu of Microsoft Visual
	   C++ IDE. Click on the "Project" menu and select the "Build"
           option.  You can modify the build command that MSCV issues
           by editing "Settings" under the Project menu.

	5. Build and execute samples from the IDE. After the sample
           is built you can debug by opening the appropriate .exe
           from the "Open" choice on the File Menu.



        Zephyr Technologies, Inc 1995 for IBM Corp.@
