![JAR search and dependency download from the Maven repository](/logo.png)
en.help.task-jmsservice.html Maven / Gradle / Ivy
To Configure the JMS Service
Use the JMS Service page to configure settings to be used by
all JMS connections.
For more information about configuring the JMS service, see Chapter 17, Using the Java Message Service, in Oracle GlassFish Server 3.1 Application Development Guide.
- In the navigation tree, expand the Configuration node.
- Under the Configuration node, select the Java Message Service node.
The JMS Service page opens.
- From the Type drop-down list:
- Select EMBEDDED to access the JMS service on the local host.
The JMS service is started in the same JVM machine as the
GlassFish Server. Lazy initialization starts the default embedded broker on the first access of
JMS services rather than at GlassFish Server startup. This is the default type
of JMS Service.
- Select LOCAL to access the JMS service on the local host.
The JMS service is started along with the GlassFish Server.
- Select REMOTE to access the JMS service on another system.
If you choose REMOTE, the JMS service is not started by the
GlassFish Server the next time the server starts. Instead, the JMS service is
started and managed by Message Queue, so you must start the Message Queue
broker separately. For information about starting the broker, see the Starting Brokers in Oracle GlassFish Message Queue 4.5 Administration Guide. If you choose
this value and are using a remote host, follow the instructions in To Edit a JMS Host
to specify the name of the remote host.
- In the Startup Timeout field, type the number of seconds the GlassFish
Server waits for the JMS service to start before aborting the startup.
On a slow or overloaded system, increase the value from the default. The
default value is 60.
- In the Start Arguments field, type arguments to customize the JMS service startup.
Use any arguments available through the as-install-parent/mq/bin/imqbrokerd command.
- Select the Reconnect Enabled checkbox to make the JMS service attempt to reconnect
to a message server (or the list of addresses in the AddressList) when
a connection is lost.
This option is enabled by default.
- In the Reconnect Interval field, type the number of seconds between reconnect attempts.
This interval applies for attempts on each address in the AddressList and for
successive addresses in the list. If it is too short, this time interval
does not give a broker time to recover. If it is too long,
the reconnect might represent an unacceptable delay. The default value is 5 seconds.
- In the Reconnect Attempts field, type the number of attempts to connect (or
reconnect) for each address in the AddressList before the client runtime tries the
next address in the list.
A value of -1 indicates that the number of reconnect attempts is unlimited
(the client runtime attempts to connect to the first address until it succeeds).
The default value is 3.
- From the Default JMS Host drop-down list, select the name of the default
JMS host.
The default value is default_JMS_host.
- From the Address List Behavior drop-down list, select the order of connection attempts.
- random means to select an address from the AddressList randomly.
If there are many clients attempting a connection using the same connection factory,
specify random to prevent them from all being connected to the same address.
This option is the default.
- priority means that the reconnect always tries to connect to the first server
address in the AddressList and uses another one only if the first broker
is not available.
- In the Address List Iterations field, type the number of times the JMS
service iterates through the AddressList in an effort to establish (or reestablish) a
connection).
A value of -1 indicates that the number of attempts is unlimited. The
default value is 3.
- In the MQ Scheme and MQ Service fields, type the Message Queue address
scheme name and the Message Queue connection service name if a non-default scheme
or service is to be used.
See MQ Scheme and MQ Service Address Syntax for syntax information.
- (Optional) In the Additional Properties area, specify additional properties for the JMS service.
For information on available properties, see Properties Specific to the JMS Service.
- To add a property, click the Add Property button. In the blank row
that appears, type the property name in the Name field, and type
the property value in the Value field.
- To modify a property, edit that property's Value field.
- To delete a property, select the checkbox to the left of the
Name field of the property that you are deleting, then click the Delete
Properties button.
- Click Ping to verify that the JMS service is running on the
default JMS host.
If the JMS service is up and running, a message reports that the
ping succeeded.
- Click Save.
Tip - To return to the default settings, click the Load Defaults button, then click
Save.
More Information
Accessing Remote Servers
Changing the provider and host to a remote system causes all JMS
applications to run on the remote server. To use both the local server
and one or more remote servers, create a connection factory resource with the
AddressList property to create connections that access remote servers. See To Create a JMS Connection Factory Resource.
Equivalent asadmin commandjms-ping
See Also
-
-
-
-
-
-
-
-
Copyright © 2010, Oracle and/or its affiliates. All rights reserved. Legal Notices