Chapter 4. Using AMQ Management Console

Procedure

1. In the left menu, click Artemis.
2. In the folder tree, click addresses.

3. In the main pane, click the Create address tab.

   A page appears for you to create an address, as shown in the figure.

   Figure 4.6. Create Address page

   

4. Complete the following fields:

   Address name

   The routing name of the address.

   Routing type

   Select one of the following options:

   • Multicast: Messages sent to the address will be distributed to all subscribers in a publish-subscribe manner.
   • Anycast: Messages sent to this address will be distributed to only one subscriber in a point-to-point manner.

   • Both: Enables you to define more than one routing type per address. This typically results in an anti-pattern and is not recommended.

     Note

     If an address does use both routing types, and the client does not show a preference for either one, the broker defaults to the anycast routing type. The one exception is when the client uses the MQTT protocol. In that case, the default routing type is multicast.

5. Click Create Address.

Procedure

1. In the left menu, click Artemis.
2. In the folder tree, select an address.

3. On the navigation bar in the main pane, click More Send message.

   A page appears for you to create a message, as shown in the figure.

   Figure 4.7. Send Message page

   
4. If necessary, click the Add Header button to add message header information.
5. Enter the message body.
6. In the Format drop-down menu, select an option for the format of the message body, and then click Format. The message body is formatted in a human-readable style for the format you selected.

7. Click Send message.

   The message is sent.

8. To send additional messages, change any of the information you entered, and then click Send message.

Procedure

1. In the left menu, click Artemis.
2. In the folder tree, select the address to which you want to bind the queue.

3. In the main pane, click the Create queue tab.

   A page appears for you to create a queue, as shown in the figure.

   Figure 4.8. Create Queue page

   

4. Complete the following fields:

   Queue name

   A unique name for the queue.

   Routing type

   Select one of the following options:

   • Multicast: Messages sent to the parent address will be distributed to all queues bound to the address.
   • Anycast: Only one queue bound to the parent address will receive a copy of the message. Messages will be distributed evenly among all of the queues bound to the address.

   Durable

   If you select this option, the queue and its messages will be persistent.

   Filter

   The username to be used when connecting to the broker.

   Max Consumers

   The maximum number of consumers that can access the queue at a given time.

   Purge when no consumers

   If selected, the queue will be purged when no consumers are connected.

5. Click Create Queue.

Procedure

1. In the left menu, click Artemis.
2. In the folder tree, navigate to a queue.

3. In the main pane, click the Chart tab.

   The console displays a chart that shows real-time data for all of the queue attributes.

   Figure 4.9. Chart tab for a queue

   
   Note

   To view a chart for multiple queues on an address, select the anycast or multicast folder that contains the queues.

4. If necessary, select different criteria for the chart:

   1. In the main pane, click Edit.
   2. On the Attributes list, select one or more attributes that you want to include in the chart. To select multiple attributes, press and hold the Ctrl key and select each attribute.
   3. Click the View Chart button. The chart is updated based on the attributes that you selected.

Procedure

1. In the left menu, click Artemis.

2. In the folder tree, navigate to a queue.

   Queues are located within the addresses to which they are bound.

3. On the navigation bar in the main pane, click More Browse queue.

   The messages in the queue are displayed. By default, the first 200 messages are displayed.

   Figure 4.10. Browse Queue page

   

4. To browse for a specific message or group of messages, do one of the following:

   To…​	Do this…​
   Filter the list of messages	In the Filter…​ text field, enter filter criteria. Click the search (that is, magnifying glass) icon.
   Sort the list of messages	In the list of messages, click a column header. To sort the messages in descending order, click the header a second time.

5. To view the content of a message, click the Show button.

   You can view the message header, properties, and body.

Procedure

1. In the left menu, click Artemis.
2. In the folder tree, navigate to a queue.

3. In the main pane, click the Send message tab.

   A page appears for you to compose the message.

   Figure 4.11. Send Message page for a queue

   
4. If necessary, click the Add Header button to add message header information.
5. Enter the message body.
6. In the Format drop-down menu, select an option for the format of the message body, and then click Format. The message body is formatted in a human-readable style for the format you selected.
7. Click Send message. The message is sent.
8. To send additional messages, change any of the information you entered, and click Send message.

Procedure

1. Browse for the message you want to resend.
2. Click the check box next to the message that you want to resend.
3. Click the Resend button. The message is displayed.
4. Update the message header and body as needed, and then click Send message.

Procedure

1. Browse for the messages you want to move.
2. Click the check box next to each message that you want to move.

3. In the navigation bar, click Move Messages.

   A confirmation dialog box appears.

4. From the drop-down menu, select the name of the queue to which you want to move the messages. Click Move.

Procedure

1. Browse for the queue you want to delete or purge.

2. Do one of the following:

   To…​	Do this…​
   Delete a message from the queue	Click the check box next to each message that you want to delete. Click the Delete button.
   Purge all messages from the queue	On the navigation bar in the main pane, click Delete queue. Click the Purge Queue button.
   Delete the queue	On the navigation bar in the main pane, click Delete queue. Click the Delete Queue button.