JMS Connection

JMS Connection resource describes a JMS connection. This resource is used to specify activities on the JMS palette.

General

The General section has the following fields.

Field Description
Package The name of the package in which you want to create a shared resource.
Name The name of the shared resource.
Description A short description of the shared resource.

Basic Configuration

This section has the following fields.

Field Description
Connection Factory Type A connection factory is the object used by a client to create a connection to a provider. Select from one of the following available options:
  • JNDI: select to look up the connection factory object. Selecting this option displays the Queue Connection Factory and Topic Connection Factory fields, when the Messaging Style selected is Queue/Topic.
  • Direct: select if you want to connect to the JMS server using a URL. Selecting this option displays the Provider URL field. Ensure to select the Queue/Topic in the Message Style.
Messaging Style The available messaging style options are:
  • Generic:
  • Queue/Topic:

You can combine these styles in a single application or the application can use any one of these messaging styles.

Queue Connection Factory This field is available when you select JNDI in the Connection Factory Type field and Queue/Topic in the Message Style field.

The QueueConnectionFactory object stored in JNDI is used to create a queue connection with a JMS application.

For more information about creating and storing QueueConnectionFactory objects, see the JNDI provider documentation.

Topic Connection Factory This field is available only when you select JNDI in the Connection Factory Type field and Queue/Topic in the Message Style field.

The TopicConnectionFactory object stored in JNDI. This object is used to create a topic connection with a JMS application.

For more information about creating and storing TopicConnectionFactory objects, see the JNDI provider documentation.

Connection Factory JNDI Name This field is available only when you select the JNDI in the Connection Factory Type field and Generic in the Message Style field.

The GenericConnectionFactory object stored in JNDI is to create connection with JMS server.

JNDI Configuration A JNDI Configuration shared configuration object that specifies the JNDI connection information. For more information, see JNDI Configuration.
Note: The New button is used to create a New JNDI Configuration Shared Resource using the preferences set by the user.
Provider URL This field is available only when you select Direct in the Connection Factory Type field.

The URL to the JNDI service provider, for example,tcp://<host>:<port>.

Use UFO Connection Factory Use this check box when using EMS Unshared State Failover factories.

This field appears only when the option Direct is selected in the Connection Factory field.

When using Unshared failover setup, if a connection loss is detected to server (A), TIBCO ActiveMatrix BusinessWorks™ try to connect to server (B) as defined in the connection factory configuration.

After enabling this check box you can pass the provider URL in the form of UFO. For example: tcp://serverA:7222+tcp://serverB:7222, where serverA and serverB are two EMS servers configured for the Unshared State Failover.

Unsupported Features and Activities

  • JMS Palette
    • JMS Queue Requestor
    • JMS Topic Requestor
    • Any other Requestor activity
  • SOAP Palette
    • All Activities
  • Service Palette
    • All activities
  • AE Adaptor
    • All activities

Looking up factories using JNDI is not supported

  • UFO factories cannot be retrieved through JNDI directly.

For more information about Unshared State Failover, see TIBCO Enterprise Message Service User's Guide .

Test Connection

Click the Test Connection button to test the connection specified in the configuration of this resource.

Using Third Party JMS Drivers

The JMS palette supports the EMS, IBM MQ, TIBCO Custom JMS, and JBoss JMS drivers.

Adding Drivers for Runtime

If you want to use other JMS servers, other than the JMS servers mentioned in the section, Using Third Party JMS you must add them separately, for run time. This is a one time process for every installation of TIBCO Business Studio for BusinessWorks. To add the JMS drivers at run time for IBM MQ, or JBoss run the bwinstall command from <BW_Home>/6.x/bin. Ensure that you run bwinstall with no arguments to access the help and instructions to add the driver to the run time.

The script creates driver bundles and adds it to the specific ActiveMatrix BusinessWorks environment. Any AppNodes that are created and started in that ActiveMatrix BusinessWorks environment includes the drivers automatically. Since the drivers are a part of the system and not part of each application, all the applications on a particular AppNode use the same drivers.

However, this is not true of App Spaces. The drivers belong to an AppNode and not an AppSpace.

To use another location for the drivers, a preference is provided in TIBCO Business Studio™ for BusinessWorks™ which can be updated for the JMS palette to use drivers at design time.

To change the Directory Preference in TIBCO Business Studio for BusinessWorks, navigate to Windows > Preferences > BusinessWorks > Palettes > JMS

If you have changed the preferences and want to use other databases with the JMS palette at design time, place the drivers at <BW_Home>/6.x/config/design/thirdparty location.

Field Description
One click JNDI Resource name The name of JNDI Connection shared resource which is auto created when you click the New button. This is used only if the shared resource uses JNDI and not Direct.
Default JNDI Naming URL The default URL to be added in the JNDI Connection shared resource when a new resource is created.
Generic Connection Factory Name The value to be added in the Generic Connection Factory field when a new JMS Connection Shared Resource is created.
Queue Connection Factory Name The value to be added in the Queue Connection Factory field when a new JMS Connection shared resource is created.
Topic Connection Factory Name The value to be added in the Topic Connection Factory field when a new JMS Connection shared resource is created.
Directory Preferences Click the Browse button and navigate to the location where the driver libraries are stored.

Note: While testing the JMS connection for JMS drivers other than EMS, ensure that only the jars related to the selected third party JMS driver are present in the location specified in the directory preference.

Security

Security section has the following field.

Field Description
Login Credentials The login credentials to log on to the JMS server. Click the Username+Password radio button, if you want to use this option for a secure login. This displays the Username and Password fields.

Advance Configuration

This section has the following fields.

Field Description
Auto-generate Client-ID Select this check box if you want to automatically generate the client ID if no client ID is specified or if the specified ID is already in use.

When this check box is selected, a value cannot be specified for the clientID.

When an automatically generated client ID is required, the following format is used for the client ID:

BW-<projectName>-<topic or queue>-<engineName>-<timestamp>

Do not select this check box if you do not want to use the value specified in the Client ID field. If no value is specified in the Client ID field, no client ID is set. If the value specified in the Client ID field is already in use, it throws an exception.

Note: Selecting the Auto-generate Client-ID check box generates a new Client ID every time a connection is made to the JMS Server. If you are using Durable Subscribers, manually set the client ID for the JMS Connection.
Client ID The client ID for the connection. The JMS providers have a provider-specific format for client IDs.

For more information about client IDs, see the JMS provider’s documentation.

Each connection must use a unique client ID. If you do not specify a value in this field, ActiveMatrix BusinessWorks ensures the uniqueness of the client ID for each connection.

SSL

Select the Confidentiality check box to configure the SSL connection parameters.

Field Description
SSL Client

Specify an SSL Client Shared Resource. For more information about how to configure the Shared Resource, see SSL Client .

Connection Factory SSL Password This field is only available if you select the Confidentiality check box.

The SSL configuration is specified in the ConnectionFactory object, except for the client SSL password. You can specify your client SSL password in this field, or you can leave this field empty. If your password is not specified, the private key password is used.

Uninstalling Drivers for Run Time

To uninstall the drivers at run time for IBM MQ or JBOSS, run the bwuninstall command from <BW_Home>/1.0/bin. Ensure that you run bwuninstall with no arguments to access the help and instructions to uninstall the driver at run time.