The following figure shows the location of files that are needed to set and manage JEUS and JEUS MQ servers. "JEUS_HOME" is the JEUS installation directory path.

Click [Servers] on the left pane to go to the Servers page. Click [Add] to add a server.

In JEUS WebAdmin, the JEUS MQ Server configuration includes the following menus.

It is recommended to use WebAdmin to configure JEUS MQ servers.

The following describes each JMS configuration screen. Since the [Basic] menu does not contain JMS related settings, its description is omitted.

[Resource]

The Jms Resource screen is used to configure JMS resources. Go to [Servers] > [Server Name] > [Resource] tab, and select the [Jms Resource] menu.

The following is the Jms Resource page. For more information, refer to "3.2. Configuring JMS Resources".

[Engine]

The Jms Resource screen is used to configure JMS MQ servers. Go to [Servers] > [Server Name] > [Engine] tab, and select the [Jms Engine] menu.

The JMS Engine screen contains the following menus.

Like Queues or Topics, JEUS MQ servers register destinations in JEUS JNDI Service by reading the domain configuration. In the Destination section of the Jms Resource screen, select a resource from the list to go to the resource configuration screen.

Enter the Destination settings and then click [OK]. To reset the settings, click [Reset].

Destination Memory Management

If messages, which could not be sent to a client, are accumulated at the destination, an OutOfMemoryError may occur on the JVM and the server may be terminated. To resolve this problem, JEUS MQ applies different memory management policies for each destination.

JEUS MQ servers hold strong references to message contents when the destination does not use a lot of memory. JEUS MQ servers operate according to the Limit and High Mark property settings.

Even after a message at a destination is deleted from the memory, the message will not be lost. Since the message is saved in the storage, a JEUS MQ server can read and process the messages in the storage when necessary. The processing speed is slower when using the storage than memory.

Controlling Message Flow

The "Max Pending Limit" and "Resume Dispatch Factor'" properties in the destination screen are used to control the message flow. If the message listener is registered in a queue or topic, and when messages arrive, the messages will be immediately sent to the consumers. If the client cannot process the messages fast enough, the messages will be accumulated on the client and an OutOfMemory error will be raised. To prevent such error, specify the maximum number of messages that can accumulate on the client after which the server suspends sending messages for a given time.

Since durable subscribers are created by clients, if the message that is sent to the topic arrives before the durable subscriber is created, it does not get delivered to the client. To resolve this problem, JEUS MQ registers a durable subscriber before the server starts so that it can send a message when a client is connected. Similar to invoking the Session.createDurableSubscriber() method, the client ID, subscription name, and topic must be specified when configuring a durable subscriber using JEUS WebAdmin. A message selector can also be configured.

In the Durable Subscriber section of the Jms Resource screen, select a resource from the list to go to the resource configuration screen.

Enter the Durable Subscriber settings and then click [OK]. To reset the settings, click [Reset].

When [Basic] is clicked from the Jms Engine screen, the basic JMS engine information screen appears.

This screen consists of the failover settings and advanced JMS engine options. The failover settings can be configured to recover from a server or network failure. For more information about the failover settings, refer to "Chapter 5. JEUS MQ Failover".

Advanced Options

In the Advanced Options section of the JMS engine screen, configure the broker name and the thread pool information.

When using the asynchronous JMS messaging method, the task of sending, receiving, processing, and storing messages are each performed by a separate thread.

The thread pool property configures the number of threads that can concurrently run on the JEUS MQ server. Since this value can greatly influence the server's performance, it must be properly configured by considering the number of simultaneous user accesses and server loads.

The following is the Advanced Options screen.

A JEUS MQ server communicates with a client through a service channel. Each JEUS MQ server must have one service channel, and it is possible to set a different network (e.g. Service URL) for each service channel.

To set a listener that the service channel uses, go to [Servers] > [Resource] > [Listener]. For more information about listeners, refer to JEUS Server Guide. "2.3.2. Listener Configuration."

Go to [Servers] > [Server Name] > [Engine] > [Jms Engine] > [Service Config] to see the list of listeners for the service channel. When a listener is selected from the list, the following configuration screen appears.

Enter the Service Config settings and then click [OK]. To reset the settings, click [Reset].

A Connection Factory is a JMS management object that contains the connection information needed to access the JMS server and basic information for the client. It is created when the JEUS MQ server boots, and registered in the JEUS JNDI service.

Go to [Servers] > [Server Name] > [Engine] > [Jms Engine] > [Connection Factory] to see the list of Connection Factories. When a Connection Factory is selected from the list, the following configuration screen appears.

Enter the Connection Factory settings and then click [OK]. To reset the settings, click [Reset].

A Persistence Store is needed to restore messages, subscriptions, or transactions to the previous state when the server restarts. If a Persistence Store is not configured, a message that the client sent in the DeliveryMode.PERSISTENT mode cannot be properly delivered if the server fails. JEUS MQ provides two types of Persistence Stores, journal log and database.

To configure a Persistence Store, go to [Servers] > [Engine] > [Jms Engine] > [Persistence Store] in WebAdmin.

Select Journal to use the logging method or select Jdbc to use the database method for the Persistent Store.

For detailed information about each column of the tables created when JDBC is configured, refer to "Appendix B. JDBC Persistence Store Columns".

For more information about message sorting, refer to "6.2. JEUS MQ Message Sort".

The following describes how to manage servers using jeusadmin and WebAdmin.

Using WebAdmin

The Connection Factories, Destinations, and Durable Subscribers that are required for JMS can be managed in WebAdmin. The resources can be added or deleted using [ADD] or [DEL].

Using the Console Tool

The server resources can be managed by executing various commands in the console tool. The console tool can be found in the following directory.

JEUS_HOME/bin/

The following are the jmsadmin commands.

Servers can be monitored using jmsadmin and WebAdmin.

Using WebAdmin

Go to [Monitoring] > [JMS] to monitor the current status of JEUS MQ servers.

Using the Console Tool

Server resources can be checked by executing various commands in the console tool. The console tool is in the following directory.

JEUS_HOME/bin/

The following commands are provided for server monitoring.