home *** CD-ROM | disk | FTP | other *** search
/ Power GUI Programming with VisualAge C++ / powergui.iso / trialva / ibmcppw / samples / som / somd / cpp / animal / readme.txt < prev    next >
Encoding:
Text File  |  1996-02-16  |  4.6 KB  |  106 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. ANIMAL
  27.  
  28.    DESCRIPTION:
  29.       This sample displays attributes of animals via a graphical user 
  30.       interface.
  31.  
  32.    CONCEPT/FEATURE:
  33.       This directory contains the source for a simple generic server 
  34.       which uses the SOM Object Adapter to automatically load class 
  35.       libraries and execute requests on objects instantiated in the server.
  36.       The server will loop forever processing requests from clients.
  37.       The directory also contains a sample client program that uses 
  38.       static bindings to invoke methods on remote objects.  The client 
  39.       program creates and initializes several remote animals, invokes 
  40.       remote methods on the objects as directed by user input, and destroys 
  41.       the local proxy objects and remote animal objects when the program 
  42.       is terminated.
  43.  
  44.  
  45.  
  46.     HOW TO RUN THE SAMPLE FROM THE COMMAND LINE:
  47.       The makefile in this directory will build a server executable, a client
  48.       executable and a dynamically loadable library.  They are:
  49.  
  50.         - testsvr.exe (the generic server)
  51.        
  52.         - anitest.exe (the DSOM client application)
  53.  
  54.         - danimal.dll (the library loaded by testsvr)
  55.  
  56.        To build the sample:
  57.         "nmake -f vac.mak all".
  58.  
  59.        To clean the sample:
  60.         "nmake -f vac.mak clean".
  61.  
  62.  
  63.        RUNNING THE SAMPLE
  64.        ------------------
  65.          Kill "somdd" if it is already running.
  66.          Execute "run.bat" to run the sample. It will start "somdd" and
  67.          run the sample "anitest.exe".
  68.  
  69.          You may also wish to run the samples manually. First, remember
  70.          that the DSOM daemon, "somdd", must be started from this
  71.          directory before executing the sample.  (See the readme.txt in
  72.          %SOMBASE%\samples\somd for information on running somdd.)
  73.  
  74.          To run the sample, execute "anitest".  (There will be a
  75.          slight delay before the application's window appears, during which
  76.          the client and server are initialized and the remote objects are 
  77.          created.) somdd will automatically start the server when the
  78.          client program, "anitest" is started.
  79.          
  80.          Alternatively, you may start the server yourself by invoking 
  81.          "testsvr -a aniServer2".  ("aniServer2" is the
  82.          server's alias name used by the makefile when registering the server 
  83.          in the Implementation Repository using the "regimpl" registration 
  84.          utility.)  After the server is started, run "anitest".
  85.  
  86.  
  87.    HOW TO RUN THE PROJECT FROM WITHIN THE WORKFRAME ENVIRONMENT
  88.     -Open the project "animal.iwp" in the sample directory.
  89.     -Kill "somdd" if it is already running.
  90.     -To make the project:
  91.         from the "Project" menu, select "Make",
  92.         or from the pop-up menu for the icon "vac.mak", select "Make"
  93.     -Click the "Run" icon to run the sample. 
  94.     -From the command line or Project Monitor, "nmake -f vac.mak clean" 
  95.      to cleanup.
  96.  
  97.    VisualAge for C++ SAMPLES INFORMATION:
  98.      A complete listing of samples shipped with the VisualAge for C++
  99.      product can be found in the online GUIDE TO SAMPLES.  To access
  100.      this notebook, simply:
  101.  
  102.      -  Open the VisualAge for C++ program group in the Program
  103.         Manager window, then
  104.      -  Open the GUIDE TO SAMPLES notebook in the program group.
  105.  
  106.