JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle GlassFish Server Message Queue 4.5 Administration Guide
search filter icon
search icon

Document Information


Part I Introduction to Message Queue Administration

1.  Administrative Tasks and Tools

2.  Quick-Start Tutorial

Part II Administrative Tasks

3.  Starting Brokers and Clients

4.  Configuring a Broker

5.  Managing a Broker

6.  Configuring and Managing Connection Services

7.  Managing Message Delivery

Configuring and Managing Physical Destinations

Command Utility Subcommands for Physical Destination Management

Creating and Destroying Physical Destinations

Naming Destinations

Setting Property Values

Destroying Destinations

Pausing and Resuming a Physical Destination

Purging a Physical Destination

Updating Physical Destination Properties

Viewing Physical Destination Information

Managing Physical Destination Disk Utilization

Using the Dead Message Queue

Managing the Dead Message Queue

Enabling Dead Message Logging

Managing Broker System-Wide Memory

Managing Durable Subscriptions

Managing Transactions

8.  Configuring Persistence Services

9.  Configuring and Managing Security Services

10.  Configuring and Managing Broker Clusters

11.  Managing Administered Objects

12.  Configuring and Managing Bridge Services

13.  Monitoring Broker Operations

14.  Analyzing and Tuning a Message Service

15.  Troubleshooting

Part III Reference

16.  Command Line Reference

17.  Broker Properties Reference

18.  Physical Destination Property Reference

19.  Administered Object Attribute Reference

20.  JMS Resource Adapter Property Reference

21.  Metrics Information Reference

22.  JES Monitoring Framework Reference

Part IV Appendixes

A.  Distribution-Specific Locations of Message Queue Data

B.  Stability of Message Queue Interfaces

C.  HTTP/HTTPS Support

D.  JMX Support

E.  Frequently Used Command Utility Commands


Managing Durable Subscriptions

Message Queue clients subscribing to a topic destination can register as durable subscribers. The corresponding durable subscription has a unique, persistent identity and requires the broker to retain messages addressed to it even when its message consumer (the durable subscriber) becomes inactive. Ordinarily, the broker may delete a message held for a durable subscriber only when the message expires.

The Message Queue Command utility provides subcommands for managing a broker’s durable subscriptions in the following ways:

To list durable subscriptions for a specified physical destination, use the imqcmd list dur subcommand:

imqcmd list dur -d topicName

For example, the following command lists all durable subscriptions to the topic SPQuotes on the default broker (host localhost at port 7676):

imqcmd list dur -d SPQuotes

The resulting output lists the name of each durable subscription to the topic, the client identifier to which it belongs, its current state (active or inactive), and the number of messages currently queued to it. Example 7-6 shows an example.

Example 7-6 Durable Subscription Information Listing

Name        Client ID       Number of   Durable Sub
                            Messages      State
myDurable   myClientID       1           INACTIVE

The imqcmd purge dur subcommand purges all messages for a specified durable subscriber and client identifier:

imqcmd purge dur -n subscriberName -c clientID

For example, the following command purges all messages for the durable subscription listed in Example 7-6:

imqcmd purge dur -n myCurable -c myClientID

The imqcmd destroy dur subcommand destroys a durable subscription, specified by its subscriber name and client identifier:

imqcmd destroy dur -n subscriberName -c clientID

For example, the following command destroys the durable subscription listed in Example 7-6:

imqcmd destroy dur -n myCurable -c myClientID