dspmq (显示队列管理器)

用途

使用 dspmq 命令来显示系统上队列管理器的名称和详细信息。

z/OS® 上 dspmq 的等效实用程序是 CSQUDSPM。

必需参数

None

可选参数

-a

仅显示有关活动队列管理器的信息。

如果队列管理器与从中发出 dspmq 命令的安装相关联，并且以下一个或多个语句为 true ，那么该队列管理器处于活动状态:

• 队列管理器正在运行
• 队列管理器的侦听器正在运行
• 进程已连接到队列管理器

-m QMgrName

要显示其详细信息的队列管理器。 如果不提供名称，那么将显示所有队列管理器名称。

-n

禁止输出字符串的转换。

-s

将显示队列管理器的操作状态。 此参数是缺省状态设置。

参数 -o status 等同于 -s。

-所有

将显示队列管理器的操作状态，以及是否有缺省队列管理器。

在 AIX®, Linux®, and Windows上，还会显示与队列管理器关联的安装的安装名称 (INSTNAME) ，安装路径 (INSTPATH) 和安装版本 (INSTVER)。

在本机 HA 配置上，还会显示当前 HA 角色 (ROLE) ，此实例的名称 (INSTANCE) ，接管活动角色的准备情况 (INSYNC) 和定额状态 (QUORUM)。

--o 默认

显示是否有任何队列管理器是缺省队列管理器。

-o 安装

仅限 AIX, Linux, and Windows 。

显示与队列管理器关联的安装的安装名称 (INSTNAME) ，安装路径 (INSTPATH) 和安装版本 (INSTVER)。

--o 地位

将显示队列管理器的操作状态。

-备用

显示队列管理器当前是否允许启动备用实例。 可能的值显示在 表 1中。

表 1. 备用值

值	描述
允许	队列管理器正在运行，并且允许备用实例。
不允许	队列管理器正在运行，并且不允许备用实例。
不适用	队列管理器未在运行。 您可以启动队列管理器，如果此实例成功启动，那么它将变为活动状态。

-o 哈 | HA

指示队列管理器是否为 HA RDQM (高可用性复制数据队列管理器)。 如果队列管理器是 HA RDQM ，那么将显示下列其中一个响应:

HA (已复制)

指示队列管理器是 HA RDQM。

HA ()

指示队列管理器不是 HA RDQM。

例如：

dspmq -o ha 

QMNAME(RDQM8)                                      HA(Replicated)
QMNAME(RDQM9)                                      HA(Replicated)
QMNAME(RDQM7)                                      HA(Replicated)
QMNAME(QM7)                                        HA()

-o 钻 | DR

指示队列管理器是否为 DR RDQM (灾难恢复复制数据队列管理器)。 将显示下列其中一个响应:

DRROLE()

指示未配置队列管理器以进行灾难恢复。

DRROLE(Primary)

指示队列管理器已配置为主 DR。

DRROLE(Secondary)

指示队列管理器已配置为 DR 辅助项。

例如：

dspmq -o dr 

QMNAME(RDQM13)                                      DRROLE(Primary)
QMNAME(RDQM14)                                      DRROLE(Primary)
QMNAME(RDQM15)                                      DRROLE(Secondary)
QMNAME(QM27)                                        DRROLE()

-O NATIVEHA | NATIVEHA

显示本机 HA 配置中实例的操作信息。 单独使用，显示 ROLE ， INSTANCE ， INSYNC 和 QUORUM 字段。 与 -x 参数组合以查看有关本机 HA 配置中所有实例的其他信息 (请参阅 本机 HA 实例值)。

-x

将显示有关多实例队列管理器实例的信息。 显示有关本机 HA 队列管理器实例的信息 (如果与 -o nativeha 参数结合使用)。

多实例队列管理器实例的可能值显示在 表 2中。

表 2. 实例值

值	描述
活动	实例是活动实例。
备用	该实例是备用实例。

本机 HA 队列管理器实例的可能值显示在 本机 HA 实例值 中

表 3. 本机 HA 实例值

名称	描述
职能部门	指定实例的当前角色，是 Active， Replica， Unknown或 未配置之一。
INSTANCE	使用 crtmqm 命令的 -lr 选项创建队列管理器时为此实例提供的名称。
INSYNC	指示实例是否能够作为活动实例进行接管 (如果需要)。
QUORUM	以 number_of_instances_in-sync/number_of_instances_configured格式报告定额状态。
REPLADDR	队列管理器实例的复制地址。
连接 ACTV	指示实例是否已连接到活动实例。
BACKLOG	指示节点落后的 KB 数。
连接	指示指定的实例是否已连接到此实例。
ALTDATE	指示上次更新此信息的日期 (如果从未更新此信息，那么为空白)。
ALTTIME	指示上次更新此信息的时间 (如果从未更新此信息，那么为空白)。

有关本机 HA 实例的 dspmq 输出示例，请参阅 查看 IBM MQ 容器的本机 HA 队列管理器的状态。

-c

显示当前连接到队列管理器的 IPCC ， QMGR 和 PERSISTENT 子池的进程列表。

例如，此列表通常包括:

• 队列管理器进程
• 应用程序，包括那些正在禁止关闭的应用程序
• 侦听器

队列管理器状态

返回码