+

Search Tips   |   Advanced Search

Third-party JMS connection factory settings


To browse or change the configuration properties of a JMS connection factory configured for use with a third-party messaging provider; that is a messaging provider other than the default messaging provider, the WebSphere MQ messaging provider or the V5 default messaging provider. These configuration properties control how connections are created to the JMS destinations on the provider.

A JMS connection factory is used to create connections to JMS destinations. The JMS connection factory is created by the associated JMS provider.

To view this page, use the admin console to complete the

  1. In the navigation pane, click Resources > JMS > JMS providers .

  2. If appropriate, in the content pane, change the scope of the third-party messaging provider.

  3. In the content pane, click the name of the messaging provider that supports the JMS connection factory.

  4. Under Additional Properties, click Connection factories.

  5. Click the name of the JMS connection factory to work with.

A JMS connection factory for a third-party messaging provider (that is, a provider other than the default, the V5 default or the WebSphere MQ messaging provider) has the following properties:

Scope

Level to which this resource definition is visible to applications.

Resources such as messaging providers, namespace bindings, or shared libraries can be defined at multiple scopes, with resources defined at more specific scopes overriding duplicates defined at more general scopes.

The scope displayed is for information only, and cannot be changed on this panel. To browse or change this resource (or other resources) at a different scope, change the scope on the messaging provider settings panel, then click Apply, before clicking the link for the type of resource.

Data type String

Name

The name by which this JMS connection factory is known for admin purposes within IBM WAS. The name must be unique within the associated messaging provider.

Data type String

Type

Whether this connection factory is for creating JMS queue destinations or JMS topic destinations.

Select one of the following options:

QUEUE

A JMS queue connection factory for point-to-point messaging.

TOPIC

A JMS topic connection factory for publish/subscribe messaging.

JNDI name

The JNDI name used to bind the connection factory into the WAS namespace.

As a convention, use the fully qualified JNDI name; for example, in the form jms/Name, where Name is the logical name of the resource.

This name is used to link the platform binding information. The binding associates the resources defined by the deployment descriptor of the module to the actual (physical) resources bound into JNDI by the platform.

Data type String

Description

A description of this connection factory for administrative purposes within IBM WAS.

Data type String
Default Null

Category

A category used to classify or group this connection factory, for the IBM WAS administrative records.

Data type String

External JNDI name

The JNDI name used to bind the connection factory into the namespace of the third-party messaging provider.

As a convention, use the fully qualified JNDI name; for example, in the form jms/Name, where Name is the logical name of the resource.

This name is used to link the platform binding information. The binding associates the resources defined by the deployment descriptor of the module to the actual (physical) resources bound into JNDI by the platform.

Data type String

Component-managed Authentication Alias

This alias specifies a user ID and password to be used to authenticate connection to a JMS provider for application-managed authentication.

This property provides a list of the J2C authentication data entry aliases that have been defined to WAS. We can select a data entry alias to be used to authenticate the creation of a new connection to the JMS provider.

If we have enabled administrative security for WAS, select the alias that specifies the user ID and password used to authenticate the creation of a new connection to the JMS provider. The use of this alias depends on the resource authentication (res-auth) setting declared in the connection factory resource reference of the deployment descriptors for an application component.

Container-managed Authentication Alias

This alias specifies a user ID and password to be used to authenticate connection to a JMS provider for container-managed authentication.

This property provides a list of the J2C authentication data entry aliases that have been defined to WAS. We can select a data entry alias to be used to authenticate the creation of a new connection to the JMS provider.

If we have enabled administrative security for WAS, select the alias that specifies the user ID and password used to authenticate the creation of a new connection to the JMS provider. The use of this alias depends on the resource authentication (res-auth) setting declared in the connection factory resource reference of the deployment descriptors for an application component.

Mapping-Configuration Alias

The module used to map authentication aliases.

This field provides a list of the modules that have been configured on the Global Security > JAAS Configuration > Application Logins Configuration property.

See about the mapping configurations, see Java™ Authentication and Authorization service configuration entry settings.

Data type Enum
Default Null
Range

ClientContainer

The client container maps authentication aliases.

WSLogin

The WSLogin module maps authentication aliases.

DefaultPrincipalMapping

The JAAS configuration maps an authentication alias to its userid and password.

Connection pool

Specifies an optional set of connection pool settings.

Connection pool properties are common to all J2C connectors.

The appserver pools connections and sessions with the messaging provider to improve performance. we have to configure the connection and session pool properties appropriately for the applications, otherwise you may not get the connection and session behavior that you want.

Change the size of the connection pool if concurrent server-side access to the JMS resource exceeds the default value. The size of the connection pool is set on a per queue or topic basis.

Session pool

An optional set of session pool settings.

This link provides a panel of optional connection pool properties, common to all J2C connectors.

The appserver pools connections and sessions with the messaging provider to improve performance. we have to configure the connection and session pool properties appropriately for the applications, otherwise you may not get the connection and session behavior that you want.

Custom properties

An optional set of name and value pairs for custom properties passed to the messaging provider.





 

Related tasks


Manage Java 2 Connector Architecture authentication data entries for JAAS
Secure messaging
Tuning the application serving environment
Set a JMS connection factory for a third-party messaging provider

 

Related information


JMS interfaces - explicit polling for messages