#
# README.txt
#
# Copyright 2001-2008 by Oracle. All rights reserved.
#
# Oracle is a registered trademarks of Oracle Corporation and/or its
# affiliates.
#
# This software is the confidential and proprietary information of Oracle
# Corporation. You shall not disclose such confidential and proprietary
# information and shall use it only in accordance with the terms of the
# license agreement you entered into with Oracle.
#
# This notice may not be removed or altered.
#
README
======

C++ to Coherence Example using JNI

Contents
========

    * Overview
    * Prerequisites
    * Build Instructions
    * Running the Example
    * Resources

Overview
========

This example demonstrates how to access Coherence cachefrom a C++ application.

The example consists of two basic components, one written in Java and the other
written in C++. The sources found in  the src\java directory contain a very
simple value object implementation (Account). The sources found in the src\cpp
directory contain a simple C++ command line application that populates and 
accesses a clustered Coherence cache via JNI.

Prerequisites
=============

To build the example, you must have the following software installed:

  * J2SE SDK 1.4 or later
    (http://java.sun.com/)
  * gcc compiler
    build.sh assumes gcc/linux, but this example will also work on other
    platforms such as Windows.
  * Oracle Coherence 3.3.1
    (http://www.oracle.com/technology/products/coherence/index.html)

Build Instructions
==================

  * Update set-env.cmd to reflect your system environment.

  * Open a shell and execute the following command in the cppclient directory :

      ./build.sh

Running the Example
===================

  * Start the Coherence cluster by executing the following script:

      ./runserver.sh

  * Start the example C++ client application by executing the following script:

      ./runcppclient.sh

Resources
=========

