Configure shared non-durable subscriptions for a connection factory

Configure the Share non-durable subscriptions option; an attribute of the connection factory that clients use to connect to the bus.

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.

Tasks

1. In the navigation pane, click...

           Resources -> JMS -> JMS providers.

2. In the content pane, click Default messaging provider.

3. In the content pane, under Additional Properties, click Connection factories.

4. Select the connection factory we want to configure, or click New to create one.

5. 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.

   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>.
   

6. 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.

7. Click OK.

8. Save changes to the master configuration.