Configuring General Properties for the JMS Provider

Use the JMS Service page to configure properties to be used by all JMS connections. Follow these steps:

  1. In the tree component, select the Configurations node.
  2. Select the instance to configure:
    1. To configure a particular instance, select the instance’s config node. For example, for the default instance, server, select the server-config node.
    2. To configure the default settings for future instances that use a copy of default-config, select the default-config node.
  3. Select the Java Message Service node to open the JMS Service page.
  4. Edit the value in the Startup Timeout field to change the time the Application Server waits for the JMS service to start before aborting the startup. On a slow or overloaded system, increase the value from the default (60).
  5. From the Type drop-down list:
  6. In the Start Arguments field, type arguments to customize the JMS service startup. Use any arguments available through the install_dir/imq/bin/imqbrokerd command.
  7. Use the Reconnect checkbox to specify whether the JMS service attempts to reconnect to a message server (or the list of addresses in the AddressList) when a connection is lost.
  8. By default, reconnection is enabled.

  9. In the Reconnect Interval field, type the number of seconds between reconnect attempts. This 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.
  10. The default value is 60 seconds.

  11. 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).
  12. The default value is 3.

  13. Choose a host from the Default JMS Host drop-down list. The default is default_JMS_host.
  14. In the Address List Behaviour drop-down list, choose whether connection attempts are in the order of addresses in the AddressList (priority) or in a random order (random).
  15. 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.

    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.

    The default is random.

  16. In the Address List Iterations field, type the number of times the JMS service iterates through the AddressList in an effort to establish (or re-establish) a connection). A value of -1 indicates that the number of attempts is unlimited.
  17. The default value is 3.

  18. In the MQ Scheme and MQ Service fields, type the Message Queue address scheme name and the MQ connection service name if you need to use a nondefault scheme or service. The full syntax for a message service address is
  19. scheme://address_syntax

    where the scheme and address_syntax are described in the table below.

    The MQ Scheme and MQ Service are the values shown in the first two columns of the following table.

    Table 0-28  Message Server Address Schemes and Syntax 

    Scheme Name

    Connection Service

    Description

    Address Syntax

    mq

    jms and ssljms

    MQ client runtime makes a connection to the MQ Port Mapper at the specified host and port. The Port Mapper returns a list of the dynamically established connection service ports, and the MQ client runtime then makes a connection to the port hosting the specified connection service.

    [hostName][:port][/serviceName]

    Defaults:
    hostName = localhost
    port = 7676
    serviceName = jms

    Defaults only apply to the jms connection service. For the ssljms connection service, all variables need to be specified

    Example:
    mq:MyHost:7677/ssljms

    mqtcp

    jms

    MQ client runtime makes a TCP connection to the specified host and port (bypassing the MQ Port Mapper) to establish a connection.

    hostName:port/jms

    Example:
    mqtcp:localhost:7676/jms

    mqssl

    ssljms

    MQ client runtime makes a secure SSL connection to the specified host and port (bypassing the MQ Port Mapper) to establish a connection.

    hostName:port/ssljms

    Example:
    mqssl:localhost:7676/ssljms

    http

    httpjms

    MQ client runtime makes an HTTP connection to an MQ tunnel servlet at the specified URL. (The broker must be configured to access the HTTP tunnel servlet, as described in the MQ Administrator’s Guide.)

    hostName:port/
    contextRoot/tunnel

    If multiple broker instances are using the same tunnel servlet, then the syntax for connecting to a specific broker instance (rather than a randomly selected one) is: http://hostName:port/
    contextRoot/tunnel?serverName=hostName:instanceName

    https

    httpsjms

    MQ client runtime makes a secure HTTPS connection to the specified MQ tunnel servlet URL. (The broker must be configured to access the HTTPS tunnel servlet, as described in the MQ Administrator’s Guide.)

    hostName:port/
    contextRoot/tunnel

    If multiple broker instances are using the same tunnel servlet, then the syntax for connecting to a specific broker instance (rather than a randomly selected one) is: http://hostName:port/
    contextRoot/tunnel?serverName=hostName:instanceName

  20. In the Additional Properties area, click Add Property to add a property. The following table lists the available Message Queue broker configuration properties.

    Table 0-29  Additional Properties for JMS Providers 

    Property Name

    Description

    instance-name

    Specifies the full Sun Java System Message Queue broker instance name. The default is imqbroker.

    instance-name-suffix

    Specifies a suffix to add to the full Sun Java System Message Queue broker instance name. The suffix is separated from the instance name by an underscore character (_). For example, if the instance name is imqbroker, appending the suffix xyz changes the instance name to imqbroker_xyz.

    append-version

    If true, appends the major and minor version numbers, preceded by underscore characters (_), to the full Sun Java System Message Queue broker instance name. For example, if the instance name is imqbroker, appending the version numbers changes the instance name to imqbroker_8_0. The default is false.

  21. Click Save to save the changes, or click Load Defaults to restore the default values for the service.
  22. Click Ping to see if the JMS service is up and running. If it is, the message “Ping succeeded: JMS service is running” appears.

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.

Equivalent asadmin command: jms-ping

See Also:


Legal Notices