29West LBM Subscribe ACK Output Adapter

Introduction

Note

This adapter is now sold as the TIBCO StreamBase® Adapter for Informatica Ultra Messaging.

The TIBCO StreamBase® 29West LBM Subscribe ACK Output Adapter allows a StreamBase application to ACK incoming LBM message based on a topic and sequence number. The adapter is embedded in the StreamBase application and has an input port that receives tuples for messages the require an ACK response.

The adapter is configured through several properties set in the adapter's Properties view in StreamBase Studio.

Note

For this adapter to work correctly the 29West LBM Subscribing Input adapter must have the option 'Enable Explicit ACK Only' enabled.

29West LBM Middleware Dependencies

This adapter requires access to the JAR file that implements the 29West LBM Java API on your system, and any files referenced by that JAR file. You will need to copy your site's LBM implementation version of that file, copy the file to $STREAMBASE_HOME/lib/ext.

Informatica purchased 29West and has since released an update of the LBM API, renamed Ultra Messaging Streaming Edition, or UMS. This adapter works with the UMS 6.x JAR files, but you cannot mix LBM and UMS installations. You must thoroughly uninstall any LBM 4.x kit before reinstalling a UMS 6.x kit. Since UMS is a workalike superset of LBM, this page uses "LBM" to refer to both.

The LBM JAR file, in turn, relies on various native library files, which are supplied as part of your LBM installation, and are not shipped with StreamBase. Make sure these files are locatable by the LBM JAR file on the PATH environment variable.

If you get an error message whose text refers to can't load lbmj: java.lang.UnsatisfiedLinkError: no lbmj in java.library.path, make sure the directory containing the LBM native libraries is on the path.

The LBM API implementation described in this section is a product of a third party, and its specifications and file names are subject to change by 29West. See your LBM documentation for the latest information.

Adapter Properties

Property Description
Sequence Number Field Name

The field name in the incoming tuple which represents the sequence number of the message to ACK

Topic Field Name

The field name in the incoming tuple which represents the topic of the message to ACK

Log Level Controls the level of verbosity the adapter uses to send notifications to the console. This setting can be higher than the containing application's log level. If set lower, the system log level is used. Available values, in increasing order of verbosity, are: OFF, ERROR, WARN, INFO, DEBUG, TRACE, and ALL.

Typechecking and Error Handling

The 29West LBM Subscribe ACK Output adapter uses typecheck messages to help you configure the adapter in your StreamBase application. In particular, the adapter generates typecheck messages when:

  • The sequence number field name given is blank or is not present in the incoming tuple or is not of type long.

  • The topic field name given is blank or is not present in the incoming tuple or is not of type string.

Suspend and Resume Behavior

When suspended, the 29West LBM Subscribe ACK Output Adapter stops processing input tuples.

When resumed, the adapter begins processing input tuples once again.