All Downloads are FREE. Search and download functionalities are using the official Maven repository.

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.

  1. In the navigation tree, expand the Configuration node.
  2. Under the Configuration node, select the Java Message Service node.

    The JMS Service page opens.

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

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

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

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

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

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

  9. From the Default JMS Host drop-down list, select the name of the default JMS host.

    The default value is default_JMS_host.

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

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

  13. (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.
  14. 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.

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

jms-ping

See Also
Copyright © 2010, Oracle and/or its affiliates. All rights reserved. Legal Notices




© 2015 - 2025 Weber Informatics LLC | Privacy Policy