Displaying default object attributes with DISPLAY QUEUE

You can use the DISPLAY QUEUE MQSC command to display attributes that were taken from the default object when an IBM® MQ object was defined.

Before you begin

Note: The steps in this task require you to run MQSC commands. How you do this varies by platform. See Administering IBM MQ using MQSC commands.

About this task

When you define an IBM MQ object, it takes any attributes that you do not specify from the default object. For example, when you define a local queue, the queue inherits any attributes that you omit in the definition from the default local queue, which is called SYSTEM.DEFAULT.LOCAL.QUEUE. You can use the DISPLAY QUEUE command to see exactly what these attributes are.

Procedure

To display the default object attributes for a local queue, use the following command:

DISPLAY QUEUE (SYSTEM.DEFAULT.LOCAL.QUEUE)

The syntax of the DISPLAY command is different from that of the corresponding DEFINE command. On the DISPLAY command you can give just the queue name, whereas on the DEFINE command you have to specify the type of the queue, that is, QLOCAL, QALIAS, QMODEL, or QREMOTE.

You can selectively display attributes by specifying them individually. For example:

DISPLAY QUEUE (ORANGE.LOCAL.QUEUE) +
MAXDEPTH +
MAXMSGL +
CURDEPTH;

This command displays the three specified attributes as follows:

AMQ8409: Display Queue details.
QUEUE(ORANGE.LOCAL.QUEUE)        TYPE(QLOCAL)
CURDEPTH(0)               MAXDEPTH(5000)
MAXMSGL(4194304)

CURDEPTH is the current queue depth, that is, the number of messages on the queue. This is a useful attribute to display, because by monitoring the queue depth you can ensure that the queue does not become full.