dspmq
Display information about queue managers.
Purpose
Use the dspmq command to display names and details of the queue managers on a system.
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 Windows, UNIX and Linux®, 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 - Windows, UNIX and Linux 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. - -x
- Information about queue manager instances are displayed. The possible
values 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. - -c
- Shows the list of processes currently connected to the IPCC, QMGR, and PERSISTENT sub pools 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 following is a list of the
different states a queue manager can be in:
| 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 |
| 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