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:
If you have not already done so, in the Change Center of the Administration Console, click Lock & Edit (see Use the Change Center).
Administration Console, navigate to the connection factory resource
that you want to configure:
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
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.
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
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.
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.
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.
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.
Client Acknowledge Policy, specify the
acknowledge policy (All or Previous) for non-transacted sessions
that use the CLIENT_ACKNOWLEDGE mode.
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
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.