en.help.ref-jmsservice.html Maven / Gradle / Ivy
Show all versions of console-jms-plugin-help
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.
The JMS Service page contains the following options.
- Load Defaults
Button to restore the default values of all the settings.
- Ping
Button 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.
- Configuration Name
The name of the configuration to which the settings on this page apply. This field is read only.
- Type
The type of access for the JMS service. Available choices are:
- EMBEDDED
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.
- LOCAL
Access the JMS service on the local host. The JMS provider is started along with the GlassFish Server.
- REMOTE
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.
- Startup Timeout
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.
- Start Arguments
Arguments to customize the JMS service startup. Use any arguments available through the as-install-parent/mq/bin/imqbrokerd command.
- Reconnect Enabled
If the Reconnect Enabled checkbox is selected, the JMS service attempts 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.
- Reconnect Interval
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.
- Reconnect Attempts
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.
- Default JMS Host
The name of the default JMS host. The default value is default_JMS_host.
- Address List Behavior
The order of connection attempts. Available choices are:
- random
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
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.
- Address List Iterations
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.
- MQ Scheme and MQ Service
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.
- Additional Properties
Additional properties for the JMS Service.
For information on available properties, see Properties Specific to the JMS Service.
Related Tasks
Related asadmin Commands
Copyright © 2010, Oracle and/or its affiliates. All rights reserved. Legal Notices