Create a JMS activity

Create a custom JMS activity to retrieve or send messages to external systems using the Java Messaging Service.

Before you begin

Role required: activity_creator or workflow_admin

About this task

The JMS activity supports third party JMS providers whose JMS client application is written with a typical Java EE pattern and can support these operations:

• Using JNDI to find a ConnectionFactory object.
• Using JNDI to find one or more destination objects.
• Using the ConnectionFactory to create a JMS connection object.
• Using the JMS connection to create one or more JMS session objects.
• Using a JMS session and the destinations to create the MessageProducer and MessageConsumer objects.
• Starting the JMS connection to enable delivery or consumption of messages.

Note: The JMS activity designer has been tested with the JMS providers ActiveMQ and Tibco EMS. When connecting to a JMS provider, refer to your third party user documentation.

Procedure

1. Create or verify your JMS credential .

   Your JMS credentials must have permission for the target database and proper configuration for the corresponding JMS connection. Credentials must be set up before you can create a JMS activity.

2. Create or verify your JMS connection .

   Your JMS connection must be configured with valid JMS credentials set up before you can create a JMS activity.

3. Create a custom activity.

   This action creates a custom activity using a template.

4. After setting up general properties and creating input variables, configure the JMS Execution Command.

What to do next

• Use auto-mapping to generate outputs and parsing rules
• If you do not use auto-mapping, you can manually create output variables and create parsing rules

Parent Topic:Orchestration custom activity templates

Create a JMS connection for an Orchestration activity

Configure your system to use Java Messaging Service (JMS) with a custom Orchestration JMS activity.

Before you begin

Role required: admin

About this task

The MID Server must have the correct JMS connection factories for your organization. Configure those values in the mid.property.jms.command.allowed_factory_names property, found in MID Server > Properties. The default values for this property can be changed to any value or comma-separated list of values that the third-party JMS provider advertises.

Procedure

1. Navigate to MID Server > JAR Files.

2. Click New and add.

1. Click the paper clip icon in the banner and attach the JMS driver jar file.

   The JMS driver jar file should be available as part of JMS provider installation. Few JMS vendors make them available as a separate product. Refer to the JMS provider documentation to determine which JMS client driver jar files require the client applications to connect to the JMS provider. For example, if you are trying to connect to ActiveMQ V5.10 (JMS provider), you need the activemq-all-5.10.1.jar file.

2. Navigate to Orchestration > Credentials & Connections > JMS Connection Factory.

3. Click New, add the following, and click Submit.

1. Navigate to Orchestration > Credentials.

2. Click New, select JMS Credentials, and provide the user name and password the MID should use to communicate with the JMS provider.

   For more information, see JMS credentials JMS credentials.

3. Click Submit.

   You are ready to create a custom JMS activity.

JMS template execution parameters

You use execution parameters to create the input process script in the Preprocessing form.

You must use the executionParam. prefix with all variables in this table.

var valueCapability = {'NEW_MID_CAPABIILTY':'NEW_MID_CAPABILITY_VALUE'};
executionParam.valueCapabilities.push(valueCapability);

JMS template post-processing parameters

Use these parameters to create a post-processing script.