28.7. Administering HornetQ Resources Using the Admin Console

To create a new JMS queue click on the JMS Queues item to reveal the available queues. On the right hand panel you will see an Add a New Resource button. Click on this and then choose the default (JMS Queue) template. Click Continue. The important things to fill in here are the name of the queue and the JNDI name of the queue. The JNDI name is what you will use to look up the queue in JNDI from your client. For most queues this will be the only info you will need to provide, as sensible defaults are provided for the others. You will also see a security roles section near the bottom. If you do not provide any roles for this queue then the server's default security configuration will be used. After you have created the queue these will be shown in the configuration. All configuration values, except the name and JNDI name, can be changed via the configuration tab after clicking on the queue in the admin console. The following section explains these in more detail.

After highlighting the configuration you will see the following screen:

The name and JNDI name cannot be changed. Recreate the queue with the appropriate settings if you want to change these names. The rest of the configuration options, apart from security roles, relate to address settings for a particular address. The default address settings are picked up from the server configuration. If you change any of these settings or create a queue via the console, a new Address Settings entry will be added. For a full explanation on Address Settings, see Section 23.3, “Configuring Queues Through Address Settings”

To delete a queue, click on the Delete button beside the queue name in the main JMS queues screen. This will also delete any address settings or security settings previously created for the queue address.

The last part of the configuration options are security roles. If none are provided on creation then the server's default security settings will be shown. If these are changed or updated, new security settings are created for the address of this queue. For more information on security settings, see Chapter 29, Security.

It is also possible to view statistics for this queue via the metrics tab. This will show statistics such as message count, consumer count, and so on.

Operations can be performed on a queue via the control tab. This will allow you to start and stop the queue, list, move, expire, and delete messages from the queue and other useful operations. To invoke an operation, click on the button for the operation you want. This will take you to a screen where parameters for the operation can be set. Once set, click the OK button to invoke the operation. Results will appear at the bottom of the screen.