JMS Send Message

JMS Send Message is a synchronous activity that sends a message to the specified JMS destination.

General

The General tab has the following fields.

Field Literal Value/Process Property/Module Property Description
Name None The name to be displayed as the label for the activity in the process.
Messaging Style None Select from one of the following available options:
  • Generic
  • Queue
  • Topic
JMS Connection None The JMS connection. For more information, see JMS Connection .
Destination Yes The name of the destination of the outgoing message.
Message Type None The type of the message. This can be one of the following:
  • Text: the message is a java.lang.String.
  • Byte: a stream of bytes.
  • Map: a set of name or value pairs. The names are strings, and the values are simple datatypes (JAVA primitives), an array of bytes (use the Binary datatype when mapping this data), or a string. Each item can be accessed sequentially or by its name.
  • Object: a Java object that can be serialized.
  • Object Ref: an object reference to a Java object.
  • Simple: a message with no body part.
  • Stream: a stream of Java primitives, strings, or arrays of bytes. Each value must be read sequentially.
  • XML Text: the message is XML text.

Description

Provide a short description for the activity.

Advanced

The Advanced tab has the following fields.

Field Literal Value/Process Property/Module Property Description
Reply To Destination Yes The destination to use for replies for this activity.
Note: If more than one job has the same Reply To Destination, each job may not receive the correct reply. Ensure to specify an expression in this field that assigns a different Reply To Destination to each process instance.
Delivery Mode None The delivery mode of the message. Can be one of the following:
  • Persistent: signifies that the messages are stored and forwarded.
  • Non_Persistent: signifies that the messages are not stored and may be lost due to transmission failure.
  • TIBCO_EMS_Reliable_Delivery: this mode is only available when using TIBCO Enterprise Message Service.

    For more information, see the TIBCO Enterprise Message Service documentation.

JMS Expiration(msec) None Corresponds to the JMSExpiration property that specifies how long the message can remain active in milliseconds.

If set to 0, the message does not expire.

Delivery Delay(msec) Yes Delivery Delay feature, which is supported in EMS, is now supported in TIBCO ActiveMatrix BusinessWorks™ 6.4.2.

Delivery Delay is the minimum length of time in milliseconds that must elapse after a message is sent before the JMS provider may deliver the message to a consumer.

Priority None The priority of the message. You may set the priority to a value from 0-8. The default value is 4.
Type None The value to supply to the JMSType header property.
Application Properties Type None Any application-specific message property that is part of the message. This is specified by the JMS application properties shared configuration object.
Override Transaction Behavior None Overrides the default behavior of a transaction group.

When the activity is in a transaction group, the JMS message is normally committed or rolled back with the other participants in the transaction.

When the check box is selected, the JMS message does not participate in the transaction.

Input Editor

The Input Editor tab defines the schema to use for outgoing messages whose message type is Map, Stream, or XML Text. Map messages are name or value pairs, and you can use the schema to define the structure of the outgoing message. After defining the schema on the Input Editor tab, it becomes the structure used for the body of the message displayed on the Input tab. For the XML Text message type, select an XSD element. For Map and Stream message types, select an XSD type in the Input Editor tab.

Input

The following is the input for the activity.

Input Item Datatype Description
Destination string The destination to which to send the message. This input item overrides the Destination field on the General tab.
replyTo string The destination to use for replies for this activity.
Note: If more than one job has the same Reply To Destination, each job may not receive the correct reply. Ensure to specify an expression in this field that assigns a different Reply To Destination to each process instance.
JMSExpiration integer Specifies how long the message can remain active in milliseconds.

If set to 0, the message does not expire.

JMSPriority string The priority of the message. This item overrides the priority set on the Advanced tab.
JMSDeliveryMode string The delivery mode of the message. Can be one of the following:
  • Persistent: signifies that the messages are stored and forwarded.
  • Non_Persistent: signifies that the messages are not stored and may be lost due to transmission failure.
  • TIBCO_EMS_Reliable_Delivery: this mode is only available when using TIBCO Enterprise Message Service.

    For more information, see the TIBCO Enterprise Message Service documentation.

JMSCorrelationID string This ID is used to link a response message with its related request message. This is usually the message ID of a request message when this field exists in a reply message.
JMSType string The type of the message. This item overrides the value specified on the Advanced tab.
JMSProperties complex The message properties. For more information, see Common JMS Properties and Headers.
Body depends on the message type The body of the message.
DynamicProperties complex

Dynamic properties is an additional parameter to add runtime property to the outgoing JMS messages that are specified in the Input tab. This is an optional element with only one instance. Dynamic property can have multiple property elements.

Each property element denotes a single dynamic property and can contain the following elements:

  • Name - Required. Name of the property with one instance.
  • Value - Required. Value of the property with one instance.
  • Type - Optional. Type of the property. If not provided, it is considered as string.

The following data types are supported:

  • string
  • boolean
  • short
  • integer
  • long
  • float
  • double
  • byte
Note: The DynamicProperty overwrites the value of a property (with the same name) added using the JMS Application Property.

The DynamicProperties are also added to the outgoing message.

Output

The following is the output of the activity.

Output Item Datatype Description
MessageID string The unique identifier of the message.

Fault

The Fault tab lists the possible exceptions generated by this activity. For more information about error codes and the corrective actions to take, see the TIBCO ActiveMatrix BusinessWorks™ Error Codes guide.

Fault Generated When..
JMSInvalidInputException The input to the activity is not valid.
JMSMessageCreateException The JMS message could not be created.
JMSSessionCreateException The JMS session could not be created.
JMSSendException The JMS send operation failed.