#    25H7912  (C)  COPYRIGHT International Business Machines Corp. 1996
#   All Rights Reserved
#   Licensed Materials - Property of IBM
#   US Government Users Restricted Rights - Use, duplication or
#   disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
#   @(#) 1.6 src/somples.nt/somd/c/animal/readme.txt, somples.somd, som3.0 12/18/96 17:50:10 [12/23/96 08:40:17]

 **************************************************************************
 * 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.
 *************************************************************************

ANIMAL

   CONCEPT/FEATURE:
      This directory contains the source for a simple generic server
      which uses the SOM Object Adapter to automatically load class
      libraries and execute requests on objects instantiated in the server.
      The server will loop forever processing requests from clients.
      The directory also contains a sample client program that uses
      static bindings to invoke methods on remote objects.  The client
      program creates and initializes several remote animals, invokes
      remote methods on the objects as directed by user input, and destroys
      the local proxy objects and remote animal objects when the program
      is terminated.



    HOW TO RUN THE SAMPLE:
      The makefile in this directory will build a server executable, a client
      executable and a dynamically loadable library.  They are:

        - testsvr.exe (the generic server)

        - anitest.exe (the DSOM client application)

        - danimal.dll (the library loaded by testsvr)

       To build the sample:
        "nmake -f vac.mak all".

       To clean the sample:
        "somdd" must be started if it is not running.
        "nmake -f vac.mak clean".


       RUNNING THE SAMPLE
       ------------------
         The DSOM daemon, "somdd", must be started.
         Wait until "somdd" displays the "Ready" message before continuing.
         To run the sample, execute "anitest".

         Alternatively, you may start the server yourself by invoking
         "start testsvr -a aniServer1".  ("aniServer1" is the
         server's alias name used by the makefile when registering the server
         in the Implementation Repository using the "regimpl" registration
         utility.)  After the server is started, run "anitest".

