TIBCO Rendezvous Adapter Sample

This sample demonstrates the use of the Spotfire Streaming Adapter for TIBCO Rendezvous®.

Note

Before running this sample, be sure to configure the TIBCO Rendezvous tibrvj.jar file and make the Rendezvous middleware libraries available to the system, as described in TIBCO Middleware Dependencies in the TIBCO Rendezvous Subscribing Input Adapter or TIBCO Rendezvous Publishing Output Adapter pages of the Adapters Guide.

A launch config file is provided as part of this sample to make it easier to add the tibrvj.jar file to your maven repository. To use the launch config copy the tibrvj.jar to the root of the project and run the tibrv maven install

The sample also comes with a src/main/configurations/engine.conf which has sample configurations for the external native library paths required. Please edit this file to conform to your install.

Importing This Sample into StreamBase Studio

In StreamBase Studio, import this sample with the following steps:

  • From the top-level menu, click File>Import Samples and Community Content.

  • Enter ren, to narrow the list of options.

  • Select TIBCO Rendezvous input/output adapters from the Other TIBCO Product Connectivity category.

  • Click Import Now.

StreamBase Studio creates a project for this sample.

Running This Sample in StreamBase Studio

  1. In the Project Explorer view, open the sample you just loaded.

    If you see red marks on a project folder, wait a moment for the project to load its features.

    If the red marks do not resolve themselves after a minute, select the project, right-click, and select Maven>Update Project from the context menu.

  2. Open the src/main/eventflow/packageName folder.

  3. Select the PublishNYSE adapter icon to open the Properties view for the adapter.

Note

Skip the following step to use the Rendezvous daemon on the local computer listening on the default port.

  1. Select the Adapter Properties tab and enter your site's values for Service, Network, and Daemon.

  2. Open the PennyStockAlert.sbapp file and click the Run button. This opens the SB Test/Debug perspective and starts the module.

  3. In the Test/Debug Perspective, open the Output Streams view. If the adapter is able to connect to the Rendezvous daemon, three "Transport Created" status tuples appear, one from each TIBCO Rendezvous adapter instance.

  4. In the Manual Input view, click Send Data. Addition tuples will appear in the Output Streams view from the NYSE and Alerts streams indicating:

    • The CSV file reader adapter read and published the simulated feed via the PublishNYSE TIBCO Rendezvous adapter.

    • The SubscribeToNYSE TIBCO Rendezvous adapter read the published NYSE feed.

    • The PennyStockAlert filter operator detected "penny stock" tuples and directed them to the Alerts output port and PublishAlerts TIBCO Rendezvous adapter.

  5. When done, press F9 or click the Terminate EventFlow Fragment button.

Sample Location

When you load the sample into StreamBase® Studio, Studio copies the sample project's files to your Studio workspace, which is normally part of your home directory, with full access rights.

Important

Load this sample in StreamBase® Studio, and thereafter use the Studio workspace copy of the sample to run and test it, even when running from the command prompt.

Using the workspace copy of the sample avoids permission problems. The default workspace location for this sample is:

studio-workspace/sample_adapter_embedded_tibrv

See Default Installation Directories for the default location of studio-workspace on your system.