Administration Console Online Help

Previous Next Open TOC in new window
Content starts here

Configure connection factory client parameters

After you configure a connection factory, you can define various client parameters concerning how a JMS server should behave with regard to its clients. For example, you can specify the Client ID a durable subscriber should have when using a connection factory, or you can define how the JMS client reconnect framework should behave.

To configure client parameters on a connection factory:

  1. If you have not already done so, in the Change Center of the Administration Console, click Lock & Edit (see Use the Change Center).
  2. In the Administration Console, navigate to the connection factory resource that you want to configure:
  3. Click the Configuration > Client tab.
  4. On the Client page:
    1. In Client ID, specify an optional client ID uses this JMS connection factory. Configuring this value prevents more than one JMS client from using a connection from the factory.
    2. In Client ID Policy, specify an optional client ID policy that indicates whether the client Id is used by more than one application. Select Restricted if only one connection that uses this same policy can exist in the cluster at any given time for a particular Client ID.
    3. In Subscription Sharing Policy, specify the subscription sharing policy on this connection. Select Exclusive if all subscribers created using this connection factory do not share subscriptions with any other subscribers..
    4. In Message Maximum per Session, specify the maximum number of messages that can exist for an asynchronous session and that have not yet been passed to the message listener. When the Prefetch Mode for Synchronous Consumers field is enabled, this value also affects synchronous sessions with a message consumer that will prefetch messages in one server access.
    5. In Multicast Overrun Policy, select the policy to use (Keep Old or Keep New) when the number of outstanding multicast messages reaches the value specified in the Messages Maximum per Session field and some messages must be discarded.
    6. In Allow Close() Within onMessage(), select whether the connection factory creates message consumers that allow a close() or stop() method to be issued within its onMessage() method call.
    7. In Prefetch Mode for Synchronous Consumers, specify whether a synchronous message consumer will prefetch messages using the maximum number of messages defined in the Message Maximum per Session field.
    8. In Client Acknowledge Policy, specify the acknowledge policy (All or Previous) for non-transacted sessions that use the CLIENT_ACKNOWLEDGE mode.
    9. To configure the JMS Client Reconnect feature parameters:

      In Reconnect Policy, select which types of JMS clients that you want implicitly refreshed upon a network disconnect or server reboot. The default value of Producer refreshes only producer-based client objects derived from this connection factory. This value does not include consumers, queue browsers, and JMS connections with a configured Client ID for a durable subscriber. Select All to refresh all consumer and producer-based clients derived from this connection factory, except for queue browsers. Select None to disable the JMS client reconnect feature on this connection factory.

      In Reconnect Blocking Time, specify how long synchronous JMS calls should block the calling thread before giving up on a JMS client reconnect in progress.

      In Total Reconnect Period, specify how long asynchronous consumers should keep retrying to reconnect to the server after either the initial network disconnect or the last synchronous JMS call attempt (whichever occurred most recently), before giving up.

    For more information about these fields, see Configuration Options.

  5. Save your changes:
  6. To activate these changes, in the Change Center of the Administration Console, click Activate Changes.
    Not all changes take effect immediately—some require a restart (see Use the Change Center).

Back to Top