High Quality JMS Messaging.

Installation

The installation takes place via 'hot deployment'. See the documentation of the Deploy Swiftlet for further information.

The Swiftlet uses the client classes of the foreign JMS server(s). These classes need to be deployed into the same directory where you put the classes of this Swiftlet for hot deployment. During hot deployment, these classes are detected and available. Don't put these classes into the classpath of the router!

Configuration

The configuration of the JMS Bridge Extension Swiftlet is defined within the element

      <swiftlet name="xt$bridge" .../>

of the router's configuration file. One can use the SwiftMQ Exlorer or CLI for configuration as well. They both save into that file.

Attributes of Element "swiftlet"

Definition

Attribute Type Mandatory Description
collect-interval java.lang.Long No Collect Interval (ms) for the Usage Section

Values

Attribute Values
collect-interval Default: 10000

Element List "servers", Parent Element: "swiftlet"

Server Definitions. This element list contains zero or more "server" elements with this template definition:

Definition

Attribute Type Mandatory Description
name java.lang.String Yes Name of this Server
enabled java.lang.Boolean No Enables/Disables this Server
clientid java.lang.String No Client Id for durable Subscribers
username java.lang.String No Username
password java.lang.String No Password
retryinterval java.lang.Long No Retry Interval (ms) for Re-Connect

Values

Attribute Values
enabled Default: false
clientid
username
password
retryinterval Default: 60000

Element "objectfactory", Parent Element: "server"

Object Factory Definition.

Definition

Attribute Type Mandatory Description
class java.lang.String Yes Object Factory Class

Values

Attribute Values
class Default: com.swiftmq.extension.bridge.JNDIObjectFactory

Element List "properties", Parent Element: "objectfactory"

Object Factory Properties. This element list contains zero or more "property" elements with this template definition:

Definition

Attribute Type Mandatory Description
name java.lang.String Yes Name of this Object Factory Property
value java.lang.String Yes Property Value

Values

Attribute Values
value

Element List "bridgings", Parent Element: "server"

JMS Bridging Definitions. This element list contains zero or more "bridging" elements with this template definition:

Definition

Attribute Type Mandatory Description
name java.lang.String Yes Name of this JMS Bridging
direction java.lang.String Yes Bridging Direction
localname java.lang.String Yes Name of the local Destination
localtype java.lang.String Yes Type of the local Destination
remotefactoryname java.lang.String Yes Name of the remote Queue/TopicConnectionFactory
remotename java.lang.String Yes Name of the remote Destination
remotetype java.lang.String Yes Type of the remote Destination
durablename java.lang.String No Name of the durable Subscriber
transferpersistence java.lang.String Yes Persistence Mode for Message Transfer

Values

Attribute Values
direction Choice: local_to_remote remote_to_local
Default: local_to_remote
localname
localtype Choice: queue topic
Default: queue
remotefactoryname
remotename
remotetype Choice: queue topic
durablename
transferpersistence Choice: persistent nonpersistent as_source
Default: as_source

CLI Commands During Deployment

This Swiftlet performs the following CLI commands during deployment:

      cc /sys$threadpool/pools
      new bridge.server
      cc /sys$threadpool/pools/bridge.server/threads
      new extension.xt$bridge.server.mgr
      cc /sys$threadpool/pools
      new bridge.source
      cc /sys$threadpool/pools/bridge.source/threads
      new extension.xt$bridge.source.queue
      new extension.xt$bridge.source.topic

CLI Commands During Undeployment

This Swiftlet performs the following CLI commands during undeployment:

      cc /sys$threadpool/pools
      delete bridge.server
      delete bridge.source