home *** CD-ROM | disk | FTP | other *** search
/ Power GUI Programming with VisualAge C++ / powergui.iso / trialva / ibmcppw / samples / som / somd / cpp / readme.txt next >
Encoding:
Text File  |  1996-01-30  |  5.8 KB  |  142 lines
  1. #   10H9767, 10H9769  (C) COPYRIGHT International Business Machines Corp. 1992,1994,1996
  2. #   All Rights Reserved
  3. #   Licensed Materials - Property of IBM
  4. #   US Government Users Restricted Rights - Use, duplication or
  5. #   disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
  6.  
  7.  **********************************************************************
  8.  * DISCLAIMER OF WARRANTIES.
  9.  * The following [enclosed] code is sample code created by IBM
  10.  * Corporation. This sample code is not part of any standard or IBM
  11.  * product and is provided to you solely for the purpose of assisting
  12.  * you in the development of your applications.  The code is provided
  13.  * "AS IS". IBM MAKES NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT
  14.  * NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  15.  * FOR A PARTICULAR PURPOSE, REGARDING THE FUNCTION OR PERFORMANCE OF
  16.  * THIS CODE.  IBM shall not be liable for any damages arising out of
  17.  * your use of the sample code, even if they have been advised of the
  18.  * possibility of such damages.
  19.  *
  20.  * DISTRIBUTION.
  21.  * This sample code can be freely distributed, copied, altered, and
  22.  * incorporated into other software, provided that it bears the above
  23.  * Copyright notice and DISCLAIMER intact.
  24.  *
  25.  *
  26.  * %Z% %I% %W% %G% %U% [%H% %T%] 
  27.  **********************************************************************
  28. DSOM SAMPLES OVERVIEW
  29.  
  30.    DESCRIPTION:
  31.       IMPORTANT: YOU MUST READ AND FOLLOW THE DIRECTIONS IN  
  32.       THIS FILE IN ORDER TO CORRECTLY BUILD AND RUN THE DSOM 
  33.       SAMPLES.                                              
  34.  
  35.    HOW TO RUN THE PROJECT FROM THE COMMAND LINE:
  36.  
  37.       PREPARING TO BUILD AND RUN THE DSOM CPP SAMPLES
  38.       ===============================================
  39.  
  40.       You must set up some DSOM variables - or at least verify that they 
  41.       have been set.  These are as follows (you can use somdenv.bat, or you 
  42.       can add it to somenv.bat.)
  43.  
  44.       somdenv.bat contains lines like:
  45.  
  46.         set SOMDDIR=<directory for your implementation registry>
  47.  
  48.         set HOSTNAME=localhost
  49.         set USERNAME=<your_name>
  50.  
  51.       You should edit it to add your computer to the USER name.
  52.  
  53.       The SOMIR variable should include som.ir in the current directory in its
  54.       list of IR files.
  55.  
  56.       The samples in the "cpp" subdirectory also require the strict CORBA-
  57.       compliant C bindings and SMADDSTAR to be undefined.  In addition,
  58.       they require that you have built the C++ .xh files.  These files are
  59.       produced by running the "somxh" command.
  60.  
  61.  
  62.       BUILDING A DSOM SAMPLE
  63.       ======================
  64.  
  65.       Makefiles are provided in each sample subdirectory.  Follow the
  66.       instructions for in the read.me file for each sample.
  67.  
  68.       RUNNING A DSOM SAMPLE
  69.       =====================
  70.  
  71.       To run a sample, you must first start the DSOM daemon, "somdd".
  72.       Because the samples build DSOM servers, dynamically loadable libraries,
  73.       and Interface Repository data into the current directory (rather than
  74.       into common directories), you must start somdd (and any DSOM servers 
  75.       required by the sample) from the directory in which the sample was built.
  76.  
  77.       As you move from one DSOM sample to the next, you must terminate the 
  78.       DSOM daemon and the DSOM servers that are running for the first 
  79.       sample and restart them from the next sample's directory.  Refer to 
  80.       "Cleaning Up After Running a DSOM Sample" below.
  81.  
  82.       Review the README files in the sample subdirectories for additional
  83.       instructions.
  84.  
  85.  
  86.       CLEANING UP AFTER RUNNING A DSOM SAMPLE
  87.       =======================================
  88.  
  89.       The DSOM servers and DSOM daemon can be stopped by pressing Ctrl+C or
  90.       selecting "End Task" after selecting that task from the task list.
  91.       Use "nmake -f vac.mak clean" to clean up a sample directory.
  92.  
  93.  
  94.       OVERVIEW OF DSOM CPP SAMPLES
  95.       ============================
  96.  
  97.       The cpp/animal subdirectories contain the source for:
  98.  
  99.         testsvr - a simple generic server which uses the SOM Object Adapter
  100.             to automatically load class libraries and execute requests
  101.             on objects instantiated in the server
  102.  
  103.         anitest - a sample client program which uses static bindings to invoke
  104.             methods on remote objects
  105.  
  106.       The cpp/dii subdirectories contain the source for:
  107.       
  108.         diitest - a sample client program which uses the Dynamic Invocation
  109.             Interface (DII) to invoke a method on a remote object
  110.  
  111.  
  112.       The cpp/event subdirectories contains the source for
  113.       
  114.         eventsvr - a server which supports the class libraries - cell, eventch 
  115.                    and eventcomm and in which remote instances of these 
  116.                    classes reside.
  117.       
  118.         eventcli - client program which invokes methods on the remote "cell" 
  119.                    class instance
  120.  
  121.         consumer - a second client program which invokes methods on a remote 
  122.                    "event channel" instance to pull events from the channel.
  123.  
  124.       The cpp/stack subdirectories contains the source for:
  125.  
  126.         somtack  - a sample client program which uses a simple Stack
  127.                   class implementation. The client program is the same one
  128.                   explained in the SOMobjects Developer Toolkit Users Guide
  129.                   (Chapter 6)
  130.  
  131.    HOW TO RUN THE SAMPLES FROM WORKFRAME:
  132.    Follow the instructions for each sample's read.me.  
  133.   
  134.    VisualAge for C++ SAMPLES INFORMATION:
  135.      A complete listing of samples shipped with the VisualAge for C++
  136.      product can be found in the online GUIDE TO SAMPLES.  To access
  137.      this notebook, simply:
  138.  
  139.      -  Open the VisualAge for C++ program group in the Program
  140.         Manager window, then
  141.      -  Open the GUIDE TO SAMPLES notebook in the program group.
  142.