EXAMPLES

Security

1) Description

The PingPong example allows the measurement of roundtrip duration when sending and receiving back a single message.

2) Design

It consists of 2 units :

3) Scenario

A message is sent by the ping executable on the "PING" partition, which the pong executable is waiting for. The pong executable sends the same message back on the "PONG" partition, which the ping executable is waiting for. This sequence is repeated a configurable number of times.

The ping executable measures:

Configurable:

topic_id allows selection of topic used for the test, among those defined by pragma keylist in pinpong.idl, and may be one of :

PING and PONG partition: this enables to use several PING-PONG pairs simultaneous with them interfering with each other. It also enables creating larger loops, by chaining several PONG tests to one PING test.

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 directory 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 directory when the example is built:

For Java5

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 ping and pong

    pong usage:  pong [write_partition] [read_partition]
    
ping usage:
      ping [blocks][nof_cycles] [topic_id] [write_partition] [read_partition]
      topic_id is from 'm', 'q', 's', 'f', 'a' or 't' where 't' is to quit
    

Running C/C#/Java5 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/C# Executables

Building the examples is described on the Summary page

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

For C

For C#

Java5 Executables

Building the examples is described on the Summary page

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

For Java5

Running the C/C#/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.

  • In the second terminal start ping by running either
    ping usage:
            ping [blocks][number of cycles] [topic_id] [write partition] [read partition]
            topic_id is from 'm', 'q', 's', 'f', 'a' or 't' where 't' is to quit