• All Files

JMSSender

Using the Java Message System (JMS), sends messages to a message broker.

Working with JMS

For information about configuring FME to communicate with JMS-compliant message brokers, see Working with JMS.

Usage Notes

The performance of this transformer is dependent on the amount of memory allocated to the Java Virtual Machine (JVM). The following environment variables allow you to specify memory available to Java Plugins:

  • FME_JVM_MIN_HEAP_SIZE: Initial heap size for initializing the JVM. Default value is 1024K.

  • FME32_JVM_MIN_HEAP_SIZE: Same as FME_JVM_MIN_HEAP_SIZE, but applies to the 32-bit version of FME Desktop on Windows, and takes precedence over FME_JVM_MIN_HEAP_SIZE.

  • FME_JVM_MAX_HEAP_SIZE: Maximum heap size for initializing JVM. Default value is 16384K.

  • FME32_JVM_MAX_HEAP_SIZE: Same as FME_JVM_MAX_HEAP_SIZE, but applies to the 32-bit version of FME Desktop on Windows, and takes precedence over FME_JVM_MAX_HEAP_SIZE.

If unset, the JVM applies the default values. If set, the values must be multiples of 1024K (for example, 4M and 64M, or 4096K and 32768K).

Note: To pass additional parameters used by FME to the Java Virtual Machine, use the JAVA_TOOL_OPTIONS environment variable.

Parameters

Connection Parameters

ClosedProvider Type or Context

The message broker to connect to, or the initial context factory if the broker is not listed.

ClosedProvider URL

The URL of the folder containing connection details for the JMS provider.

ClosedAdditional Provider Properties

Any additional provider-specific properties, in the form key=value. Specify multiple pairs on separate lines, using the Text Editor.

In most cases, this field is not required. The JMS brokers tested by Safe, including Apache ActiveMQ, IBM Websphere MQ, and Oracle WebLogic JMS, do not require any additional properties to establish a connection.

Note: Note: When connecting to ACTIVEMQ, do not specify any failover transport options here. Instead, specify them directly in the Provider URL field. For example: failover:(tcp://primary:61616,tcp://secondary:61616)?randomize=false

ClosedConnection Factory

The name of the connection factory object.

ClosedUsername

An authenticating username.

ClosedPassword

An authenticating password.

ClosedDestination(s)

The names of the destination objects. These correspond to queues and/or topics.

Message Parameters

ClosedMessage Attribute

The attribute that contains the message to send.

ClosedUse Persistent Delivery

If Yes, messages are stored by the JMS broker until the message is delivered to a destination, and can be recovered in the event of a broker restart. If No, messages may be lost in the event of a broker restart during delivery. Persistent delivery is slower than non-persistent delivery, particularly when sending large volumes of messages.

Examples

This example sends a message to an Oracle Weblogic JMS queue:

Editing Transformer Parameters

Using a set of menu options, transformer parameters can be assigned by referencing other elements in the workspace. More advanced functions, such as an advanced editor and an arithmetic editor, are also available in some transformers. To access a menu of these options, click beside the applicable parameter. For more information, see Transformer Parameter Menu Options.

Transformer Categories

Integrations

Web

FME Licensing Level

FME Professional edition and above

Technical History

Associated FME function or factory: COM.safe.fme.factory.JmsFactory

Search FME Community

Search for samples and information about this transformer on the FME Community.