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 Literal Value/Module Property Description
Connection Factory Type No 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 None 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 Yes 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 Yes 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 Yes 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 the JMS server.

JNDI Configuration No 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 JNDI Configuration Shared Resource using the preferences set by the user.

Provider URL Yes 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 Yes Use this checkbox 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 Cloud™ Integration tries to connect to server (B) as defined in the connection factory configuration.

After enabling this checkbox 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.

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>/1.0/config/design/thirdparty location.

Field Description
One click JNDI Resource name The name of JNDI Connection shared resource that 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.

Security

Security section has the following field.

Field Literal Value/Module Property Description
Login Credentials Yes The login credentials to log in 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 Literal Value/Module Property Description
Auto-generate Client-ID No Select this checkbox 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 checkbox 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 checkbox 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 generates an exception.

Note: Selecting the Auto-generate Client-ID checkbox 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 Yes 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.

SSL

Select the Confidentiality checkbox to configure the SSL connection parameters.

Field Literal Value/Module Property Description
SSL Client None

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

Connection Factory SSL Password Yes This field is only available if you select the Confidentiality checkbox.

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.

Installing TIBCO Enterprise Message Service™ Client Libraries

To install the TIBCO Enterprise Message Service™ client libraries for your environment, run the following command from the <BW_HOME>/bin folder and follow the prompts: 

bwinstall ems-driver