EXAMPLES

HelloWorld

1) Description

The basic HelloWorld example is used to illustrate the necessary steps to setup DCPS entities.

This example also shows the deployment architecture choices available for OpenSplice. OpenSplice can be deployed as multiple processes interfacing directly with shared memory, or can be deployed with all OpenSplice services and applications in a single process utilizing dynamic heap memory. Please refer to the OpenSplice_DeploymentGuide.pdf document for more detailed discussion of these deployment strategies.

2) Design

It consists of 2 units :

3) Scenario

The publisher sends a single HelloWorld sample. The sample contains 2 fields :

When it receives the sample, the subscriber displays the userID field and the message field.

Running of examples

Running the examples in a Posix environment

Environment Setup

Let's call OpenSplice_install_dir the OpenSplice installation directory.

The OpenSplice environment variables must be set in order for the examples to build/run correctly. To do this, open a terminal and source the "OpenSplice_install_dir/release.com" script supplied with the distribution.

C Executables

Building the examples is described on the Summary page

Two executables are generated in the bin folder when the example is built:

For C

Java5 executables

Building the examples is described on the Summary page

Two jars are generated in the java5 folder when the example is built:

For Java5

ISO C++ 2 Executables

Building the examples is described on the Summary page

Two executables are generated in the bin directory when the example is built:

Running the example

Ensure that the environment for OpenSplice is set up correctly as described above for each new terminal used.

It is recommended that you run the subscriber and publisher in separate terminals to avoid mixing the output

Running in single process (heap memory) configuration : the application starts OpenSplice middleware

Running in multiple process shared memory configuration

To enable deployment in this mode, an OpenSplice configuration file must be selected that has shared memory support e.g. one of the ospl_shmem xml configuration files found in the OpenSplice_install_dir/etc/config directory.

Starting the subscriber and publisher

Running C/C99/C#/Java examples on Windows

Environment Setup

Let's call OpenSplice_install_dir the OpenSplice installation directory.

The OpenSplice environment variables must be set in order for the examples to run correctly. To do this open an OpenSplice Command Prompt which will set up the environment variables for OpenSplice automatically. The OpenSplice Command Prompt can be selected from the launcher. Alternatively, open a windows Command Prompt and execute the "OpenSplice_install_dir\release.bat" batch script supplied with the distribution.

C/C99/C# Executables

Building the examples is described on the Summary page

Two executables are generated in the examples build/bin directory when the example is built:

For C

For C99

For C#

Java5 Executables

Building the examples is described on the Summary page

Two jars are generated in the java5 folder when the example is built:

For Java5

ISO C++ 2 Executables

Building the examples is described on the Summary page

Two executables are generated in the bin directory when the example is built:

Running the C/C99/C#/ISO C++ 2/Java5 Examples

Ensure that the environment for OpenSplice is set up correctly as described above for each new command prompt used.

The following steps describe how to run the examples:

Running in single process (heap memory) configuration : the application starts OpenSplice middleware

Running in multiple process shared memory configuration

To enable deployment in this mode, an OpenSplice configuration file must be selected that has shared memory support e.g. one of the ospl_shmem xml configuration files found in the OpenSplice_install_dir\etc\config directory.

Starting the subscriber and publisher