Use this task to configure the Share non-durable subscriptions
option; an attribute of the connection factory that clients use to connect to the bus.
About this task
The
Share non-durable subscriptions option controls whether
non-durable subscriptions are shared between subscribers in a cluster. To set this option, use the
administrative console to complete the following steps.
Procedure
- In the navigation pane, click .
- In the content pane, click Default messaging provider.
- In the content pane, under Additional Properties, click Connection
factories.
- Select the connection factory you want to configure, or click New to
create one.
- Select Subscription home for the subscription.
- Subscription home
- The name of the messaging engine used to store messages delivered to subscriptions for objects created from this JMS connection factory.
This identifies the messaging engine where durable
subscriptions are localized on the service integration bus. Administrators can manage the runtime
state of durable subscriptions through publication points for that messaging engine.
Note: 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>.
- Under General Properties, in the Advanced section, set the Share non-durable
subscriptions property. Select one of the following options from the list:
- In cluster
- Clients that a re connected to the bus in a cluster member can use the same client identifier
and non-durable subscription name, and can retrieve messages from the non-durable subscription.
- Always shared
- All clients, regardless of where they are connected to the bus, can use the same client
identifier and non-durable subscription name, and can retrieve messages from the non-durable
subscription.
- Never shared
- Clients cannot use the same client identifier and non-durable subscription name as an existing
session.
See the administrative console help for information about the other fields on this page.
- Click OK.
- Save your changes to the master configuration.