dspmq (display queue managers)
Display information about queue managers on Multiplatforms.
Purpose
Use the dspmq command to display names and details of the queue managers on a system.
The equivalent utility to dspmq on z/OS® is CSQUDSPM.
Syntax
Required parameters
None
Optional parameters
- -a
- Displays information about the active queue managers only.
A queue manager is active if it is associated with the installation from which the dspmq command was issued and 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
- The queue manager for which to display details. If you give no name, all queue manager names are displayed.
- -n
- Suppresses translation of output strings.
- -s
- The operational status of the queue managers is displayed. This parameter is the default status setting.
The parameter -o status is equivalent to -s.
- -o all
- The operational status of the queue managers is displayed, and whether any are the default queue
manager.
On AIX®, Linux®, and Windows, the installation name (INSTNAME), installation path (INSTPATH), and installation version (INSTVER) of the installation that the queue manager is associated with is also displayed.
- -o default
- Displays whether any of the queue managers are the default queue manager.
- -o installation
- AIX, Linux, and Windows only.
Displays the installation name (INSTNAME), installation path (INSTPATH), and installation version (INSTVER) of the installation that the queue manager is associated with.
- -o status
- The operational status of the queue managers is displayed.
- -o standby
- Displays whether a queue manager currently permits starting a standby instance. The possible values are shown in Table 1.
Table 1. Standby values Value Description Permitted The queue manager is running and is permitting standby instances. Not permitted The queue manager is running and is not permitting standby instances. Not applicable The queue manager is not running. You can start the queue manager and this instance becomes active if it starts successfully. - -o ha | HA
- Indicates whether a queue manager is an HA RDQM (high availability replicated data queue
manager) or not. If the queue manager is an HA RDQM, one of the following responses is displayed:
- HA(Replicated)
- Indicates that the queue manager is an HA RDQM.
- HA()
- Indicates that the queue manager is not an HA RDQM.
- -o dr | DR
- Indicates whether a queue manager is a DR RDQM (disaster recovery replicated data queue manager)
or not. One of the following responses is displayed:
DRROLE()
- Indicates that the queue manager is not configured for disaster recovery.
DRROLE(Primary)
- Indicates that the queue manager is configured as the DR primary.
DRROLE(Secondary)
- Indicates that the queue manager is configured as the DR secondary.
- -o nativeha | NATIVEHA
- Displays operational information for an instance in a Native HA configuration. Used on its own,
displays ROLE, INSTANCE, INSYNC, and QUORUM fields. Combine with the
-x
parameter to view additional information on all the instances in the Native HA configuration (see Native HA instance values). - -x
- Information about multi-instance queue manager instances is displayed. Displays information about Native HA queue manager instances
if combined with the
-o nativeha
parameter.The possible values for multi-instance queue manager instances are shown in Table 2.Table 2. Instance values Value Description Active The instance is the active instance. Standby The instance is a standby instance. The possible values for Native HA queue manager instances are shown in Native HA instance valuesFor examples of dspmq output for Native HA instances, see Viewing the status of Native HA queue managers for IBM MQ certified containers.Table 3. Native HA instance values Name Description ROLE Specifies the current role of the instance and is one of Active
,Replica
, orUnknown
.INSTANCE The name provided for this instance of the queue manager when it was created using the -lr option of the crtmqm command. INSYNC Indicates whether the instance is able to take over as the active instance if required. QUORUM Reports the quorum status in the form number_of_instances_in-sync/number_of_instances_configured. REPLADDR The replication address of the queue manager instance. CONNACTV Indicates whether the instance is connected to the active instance. BACKLOG Indicates the number of KB that the node is behind. CONNINST Indicates whether the named instance is connected to this instance. ALTDATE Indicates the date on which this information was last updated (blank if it has never been updated). ALTTIME Indicates the time at which this information was last updated (blank if it has never been updated). - -c
- Shows the list of processes currently connected to the IPCC, QMGR, and PERSISTENT subpools for a
queue manager. For example, this list typically includes:
- Queue manager processes
- Applications, including those that are inhibiting shutdown
- Listeners
Queue manager states
The different states that a queue manager can be in are as follows:
- 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
Return codes
Return code | Description |
---|---|
0 | Command completed normally |
5 | Queue manager running |
36 | Invalid arguments supplied |
58 | Inconsistent use of installations detected |
71 | Unexpected error |
72 | Queue manager name error |
Examples
- The following command displays queue managers on this server:
dspmq -o all
- The following command displays standby information for queue managers on this server that have ended immediately:
dspmq -o standby
- The following command displays standby information and instance information for queue managers on this server:
dspmq -o standby -x