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

dspmq   -m QMgrName  -s   -o all   -o default   -o installation   -o status -o standby-o ha-o dr -x -n -a -c


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 UNIX, 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
    UNIX, 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.

    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. We 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.

    For example:
    dspmq ha 
    
    QMNAME(RDQM8)                                      HA(Replicated)
    QMNAME(RDQM9)                                      HA(Replicated)
    QMNAME(RDQM7)                                      HA(Replicated)
    QMNAME(QM7)                                        HA()
    

    -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:

      DR()
      Indicates that the queue manager is not configured for disaster recovery.

      DR(Primary)
      Indicates that the queue manager is configured as the DR primary.

      DR(Secondary)
      Indicates that the queue manager is configured as the DR secondary.

    For example:
    dspmq dr 
    
    QMNAME(RDQM13)                                      DR(Primary)
    QMNAME(RDQM14)                                      DR(Primary)
    QMNAME(RDQM15)                                      DR(Secondary)
    QMNAME(QM27)                                        DR()
    

    -x
    Information about queue manager instances are displayed. The possible values are shown in Table 2.

    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 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

  1. The following command displays queue managers on this server:
    dspmq -o all
    
  2. The following command displays standby information for queue managers on this server that have ended immediately:
    dspmq -o standby
    
  3. The following command displays standby information and instance information for queue managers on this server:
    dspmq -o standby -x