+

Search Tips   |   Advanced Search

Default Provider connection factory settings

Use this panel to view or change the configuration properties of the selected JMS connection factory for use with the internal product Java Message Service (JMS) provider installed with WebSphere Application Server. These configuration properties control how connections are created between the JMS provider and the service integration bus that it uses

To view this Application Client Resource Configuration Tool (ACRCT) page, click File > Open. After you browse for an EAR file, click Open. Expand the selected JAR file > Messaging Providers > Default Provider. Right-click Connection Factories and click New. The following fields appear on the General tab.

Sets that have a default value display the appropriate value. Any settings that have fixed values have a drop down menu.


Name

The name of the connection factory.

Information Value
Data type String


Description

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

Information Value
Data type String


JNDI Name

The JNDI name used to match this Resource Adapter connection factory definition to the deployment descriptor. This entry is a resource-ref name.

Information Value
Data type String


User Name

The User Name used with the Password property for connecting to an application.

If we specify a value for the User Name property, we must also specify a value for the Password property.

The connection factory User ID and Password properties are used if the calling application does not provide a userid and password explicitly. If a user name and password are specified, then an authentication alias is created for the factory where the password is encrypted.

Information Value
Data type String


Password

The password used to authenticate connection to an application.

If we specify a value for the User Name property, we must also specify a value for the Password property.

Information Value
Data type String


Re-Enter Password

Confirms the password.


Bus Name

The name of the bus to which the connection factory connects.

Information Value
Data type String


Client Identifier

The name of the client. Required for topic subscriptions.

Information Value
Data type String


Nonpersistent Messaging Reliability

The reliability applied to nonpersistent JMS messages sent using this connection factory.

If we want different reliability delivery options for individual JMS destinations, we can set this property to As bus destination. The reliability is then defined by the Reliability property of the bus destination to which the JMS destination is assigned.

Information Value
Default ReliablePersistent
Range

None

There is no message reliability for nonpersistent messages. If a nonpersistent message cannot be delivered, it is discarded.

Best effort nonpersistent

Messages are never written to disk, and are thrown away if memory cache overruns.

Express nonpersistent

Messages are written asynchronously to persistent storage if memory cache overruns, but are not kept over server restarts.

Reliable nonpersistent

Messages can be lost if a messaging engine fails, and can be lost under normal operating conditions.

Reliable persistent

Messages can be lost if a messaging engine fails, but are not lost under normal operating conditions.

Assured persistent

Highest degree of reliability where assured message delivery is supported.

As Bus destination

Use the delivery option configured for the bus destination.


Persistent Message Reliability

The reliability applied to persistent JMS messages sent using this connection factory.

If we want different reliability delivery options for individual JMS destinations, we can set this property to As bus destination. The reliability is then defined by the Reliability property of the bus destination to which the JMS destination is assigned.

Information Value
Default ReliablePersistent
Range

None

There is no message reliability for nonpersistent messages. If a nonpersistent message cannot be delivered, it is discarded.

Best effort nonpersistent

Messages are never written to disk, and are thrown away if memory cache overruns.

Express nonpersistent

Messages are written asynchronously to persistent storage if memory cache overruns, but are not kept over server restarts.

Reliable nonpersistent

Messages can be lost if a messaging engine fails, and can be lost under normal operating conditions.

Reliable persistent

Messages can be lost if a messaging engine fails, but are not lost under normal operating conditions.

Assured persistent

Highest degree of reliability where assured message delivery is supported.

As Bus destination

Use the delivery option configured for the bus destination.


Subscription Home

The name of the subscription home.

Information Value
Data type String

For shared non-durable subscription, the connection factory should be connected to the SubscriptionHome messaging engine during connection factory creation. To ensure that the connection factory is connected always to the SubscriptionHome messaging engine, set the Target field as the SubscriptionHome messaging engine name, Target type field as the Messaging engine name, and Target significance field as Required in the connection factory configuration.

When connection factory is not connected to the SubscriptionHome messaging engine due to improper connection factory settings, an attempt to create a shared non-durable subscription (createSharedConsumer API) results in the following exception: 

WSIC8025E: Unable to create a shared nondurable subscription for destination <destination name> 
because the connection factory is not connected to the SubscriptionHome messagaing engine <subscription home messaging engine name>, but connected to the messaging engine <the messaging engine which the connection factory is connecting to>.


Share subscriptions

Controls whether or not subscriptions are shared across connections with members of a server cluster.

Normally, only one session at a time can have a TopicSubscriber for a particular subscription. Enable you to override this behavior, to enable a subscription to have multiple simultaneous consumers.

Information Value
Data type Selection list
Default In cluster
Range

In cluster

Allows sharing of subscriptions when connections are made from within a server cluster.

Always shared

Subscriptions can be shared across connections.

Never shared

Subscriptions are never shared across connections.


Read Ahead

Controls the read-ahead optimization during message delivery.

Information Value
Default Default
Range Default, AlwaysOn and AlwaysOff


Related:

  • Resource adapters for the client


    Target

    The name of the Workload Manager target group containing the messaging engine.

    Information Value
    Data type String


    Target Type

    The type of Workload Manager target group containing the messaging engine.

    Information Value
    Default BusMember
    Range BusMember, Custom, ME


    Target Significance

    The priority of significance for the target specified.

    Information Value
    Default Preferred
    Range Preferred, Required


    Target Inbound Transport Chain

    The name of the protocol that resolves to a group of messaging engines.

    Information Value
    Data type String


    Provider Endpoints

    The list of comma separated endpoints used to connect to a bootstrap server.

    Type a comma-separated list of endpoint triplets with the syntax: host:port:protocol.

    Information Value
    Example merlin:7276:BootstrapBasicMessaging,Gandalf: 5557:BootstrapSecureMessaging where

    BootstrapBasicMessaging corresponds to the remote protocol InboundBasicMessaging (JFAP-TCP/IP).

    Default

    • If the host name is not specified, then the default localhost is used as a default value.

    • If the port number is not specified, then 7276 is used as a default value.

    • If the chain name is not specified, a predefined chain, such as BootstrapBasicMessaging, is used as a default value.


    Connection Proximity

    The proximity that the messaging engine should have to the requester.

    Information Value
    Default Bus
    Range Bus, Host, Cluster, Server


    Temporary Queue Name Prefix

    The prefix to apply to the names of temporary queues. This name is a maximum of 12 characters.

    Information Value
    Data type String


    Temporary Topic Name Prefix

    The prefix to apply to the names of temporary topics. This name is a maximum of 12 characters.

    Information Value
    Data type String

  • Use application clients