JMS Send Message From File

JMSSend32x32

Description

Send JMS Message(s) from file(s) on a remote JMS Server.

Parameters

Name Mandatory Default Description

Jms Commit

No

False

Commit on the session after sending the message.

Jms Connection

Yes

JMS connection used for the command. This connection is automatically set on the action if a metadata link is added on this action.

Jms Acknowledge Mode

No

SESSION_TRANSACTED

The acknowledge mode is the way the consumer is going to inform the provider it has successfully received a message.

Jms Initial Context Factory

Yes

The JNDI naming service used by the JMS Server. It depends on the JMS Provider.

Jms Connection Factory Name

No

Connection Factory

Name of the connection Factory Used.

Jms Login

No

Login/Username of the JMS Server to use.

Jms Password

No

Encrypted password of the User.

Jms Uncrypted Password

No

Uncrypted password of the User.

Jms Provider Url

Yes

URL of the JMS server. The syntax of the url depends on the JMS Provider used.

Jms Client Id

No

Set a custom client ID. Multiple processes running at the same time cannot have the same client Id.

Jms Session Name

No

T1

Name of the JMS Session.

Jms Server Properties

No

Server specific properties.

In File Mask

Yes

The mask of the file(s) name to send.

Jms Message Type

Yes

Type of the message(s) sent.

In File Dir

No

The directory which contains the message file(s).

Jms Sent Files Dir

No

A directory in which sent file(s) will be stored after being sent if Jms Sent Files Behaviour property is set to move or copy.

Jms Sent Files Behaviour

No

Choose what to do with sent files.

Jms Destination Name

Yes

JMS Queue/Topic in which the message will be sent.

Jms User Defined Properties

No

Set custom properties. This properties can be retrieved and used in the Receive JMS File Message action.

Jms Properties

No

Set the predefined JMS properties manually.
Passwords are encrypted using the encrypt <password> command on the Runtime engine console (engine command line tool).

Sent Files Behaviour:

  • keep: keep it where it is

  • move: move it in the directory set in `Jms Sent Files Dir' property

  • copy: copy it in the directory set in `Jms Sent Files Dir' property

  • delete: delete it

Jms Server Properties:

Jms Server Properties can be set with this parameter when sending messages with the following syntax:

<property name="propertyName" value="propertyValue"/>

It is automatically set on the action if a metadata link is added on this action.
This can be specifically usefull with ActiveMQ for example, which requires a property for each queue/topic.
It is set in the metadata by adding a property to the JMS Server (Recommended) or with

  1. <property name="queue.<queueName>" value="<queueName>"/>

  2. <property name="topic.<topicName>" value="<topicName>"/>.

JMS Properties:

This parameter can be used to specify standard JMS Properties that are attached to the JMS Message with the following syntax:

<setProperty name="<propertyName>">Value</setProperty>

The available properties are: JMSMessageID, JMSCorrelationID, JMSDeliveryMode, JMSDestination, JMSExpiration, JMSPriority, JMSRedelivered, JMSReplyTo, JMSTimestamp, JMSType

Jms User Defined Properties:

This parameter can be used to specify custom Properties that will be attached to the JMS Message. The syntax is

<setProperty name="<name>" type="<type>">Value</setProperty>

The type is optional and must be one of these: STRING (default), INT, BOOLEAN, DOUBLE, LONG, FLOAT, BYTE, SHORT