dspmq (display queue managers)

Display information about queue managers.

Purpose

You can use the dspmq command to display the names and details of the queue managers on the IBM® MQ Appliance.

Syntax

Read syntax diagramSkip visual syntax diagram dspmq  -m QMgrName -s  -o all  -o ha -o dr -o fs -o default  -o status  -n -a

Parameters

-a
Specifies that information about only the active queue managers is displayed.
A queue manager is active one or more of the following statements are true:
  • The queue manager is running
  • A listener for the queue manager is running
  • A process is connected to the queue manager
-m QMgrName
Specifies which queue manager to display the details for.
If no queue manager name is specified, all queue managers are displayed.
-n
Specifies that the translation of output strings is suppressed.
-s
Specifies that the operational status of the queue managers is displayed.
This parameter is the default status setting. It is equivalent to -o status.
-o all
Specifies that the operational status of the queue managers is displayed. Specifying all is the equivalent of including all the -o parameters.
-o default
Specifies that the default queue manager status is displayed.
-o ha
Specifies that the HA type is displayed. The type is "replicated" for an HA queue manager, or blank otherwise. Displays the floating IP address and the local interface used for this address, if they have been configured for this queue manager,
-o dr
Specifies that disaster recovery information is displayed. Displays the port that the data replication listener on both appliances uses and the IP address used by the remote appliance.
-o fs
Specifies that information about the queue manager file system is displayed.
Indicates whether the file system is encrypted or not:
ENCRYPTED(yes)
ENCRYPTED(no)
-o status
Specifies that the operational status of the queue managers is displayed.

Usage notes

  • This command must be run from the IBM MQ administration mode. If the system is in the IBM MQ administration mode the prompt includes mqa(mqcli)#. To enter the IBM MQ administration mode, enter mqcli on the command line. To exit the IBM MQ administration mode, enter exit on the command line.
  • The queue manager can be in any of the following states:
    • Starting
    • Running
    • Running as standby
    • Running elsewhere
    • Quiescing
    • Ending immediately
    • Ending pre-emptively
    • Ended normally
    • Ended immediately
    • Ended unexpectedly
    • Ended pre-emptively
    • Status not available
  • For more information about this command in IBM MQ, see dspmq in the IBM MQ documentation.

Examples

  • The following command displays queue managers on the appliance: 
    dspmq -o all