DISPLAY QUEUE (显示队列属性)

使用 MQSC 命令 DISPLAY QUEUE 可显示任何类型的一个或多个队列的属性。

使用 MQSC 命令

有关如何使用 MQSC 命令的信息，请参阅使用 MQSC 命令管理 IBM® MQ。

[z/OS] 您可以从源发出此命令 2CR。有关源符号的说明，请参阅可在 IBM MQ for z/OS®上发出 MQSC 和 PCF 命令的源。

语法图
使用说明
DISPLAY QUEUE 的参数描述
请求的参数

同义词: DIS Q

DISPLAY QUEUE

请求的参数

注：

¹ 仅在 z/OS上有效。
² 在 z/OS上，无法从 CSQINP2发出此消息。
³ 仅当队列管理器是队列共享组的成员时，才在 z/OS 上有效。
⁴ 仅在别名队列上有效。
⁵ 在 z/OS上无效。
⁶ 在 z/OS 或 IBM i上无效。

使用说明

您可以使用以下命令 (或其同义词) 作为显示这些属性的替代方法。
- DISPLAY QALIAS
- DISPLAY QCLUSTER
- DISPLAY QLOCAL
- DISPLAY QMODEL
- DISPLAY QREMOTE
这些命令生成与 DISPLAY QUEUE TYPE(queue-type) 命令相同的输出。如果以这种方式输入命令，请勿使用 TYPE 参数。
在 z/OS上，通道启动程序必须正在运行，然后才能显示有关集群队列的信息 (使用 TYPE(QCLUSTER) 或 CLUSINFO 参数)。
在部分存储库上发出该命令时，该命令可能不会显示集群中的每个集群队列，因为部分存储库仅在尝试使用该队列后才知道该队列。

DISPLAY QUEUE 的参数描述

必须指定要显示的队列定义的名称。这可以是特定队列名称或通用队列名称。通过使用通用队列名称，可以显示下列其中一项:

所有队列定义
一个或多个与指定名称匹配的队列

队列名称

要显示的队列定义的局部名 (请参阅用于命名 IBM MQ 对象的规则)。尾部星号 * 与后跟零个或多个字符的指定主干的所有队列匹配。它自己的星号 (*) 指定所有队列。

WHERE

指定过滤条件以仅显示满足过滤条件的选择条件的那些队列。过滤条件分为三个部分: filter-keyword， operator和 filter-value:

过滤关键词

几乎任何可用于显示此 DISPLAY 命令的属性的参数。但是，不能将 [z/OS]

CMDSCOPE ， QDPHIEV， QDPLOEV， QDPMAXEV， [z/OS]

QSGDISP ，或 QSVCIEV 参数用作过滤器关键字。不能使用 [z/OS]

CFSTRUCT ， CLUSTER， [z/OS]

PSID ，

STGCLASS ，或 CLUSNL(如果这些也用于选择队列)。不显示过滤器关键字不是有效属性的类型的队列。

操作员

这用于确定队列是否满足给定过滤器关键字上的过滤器值。运算符是：

LT: 小于
GT: 大于
EQ: 等于
NE: 不等于
LE: 小于或等于
GE: 大于或等于
LK: 与作为 filter-value 提供的通用字符串匹配
NL: 与作为 filter-value 提供的通用字符串不匹配

过滤器值

一个值，必须使用运算符针对该值来测试属性值。根据过滤关键字，它可为：

确切值，对于要测试的属性，它是有效值。
只能使用运算符 LT ， GT， EQ ， NE ， LE 或 GE。但是，如果属性值是参数上可能存在的一组值 (例如， CLUSQT 参数上的值 QALIAS) 中的一个值，那么只能使用 EQ 或 NE。对于 HARDENBO ， SHARE 和 TRIGGER 参数，请使用 EQ YES 或 EQ NO。
通用值。这是一个在末尾带有星号 (例如 ABC*) 的字符串 (例如，您为 DESCR 参数提供的字符串)。如果运算符是 LK，那么列出属性值以此字符串（在此示例中是 ABC）开始的所有项。如果运算符是 NL，那么列出属性值不以此字符串开始的所有项。只允许单个拖尾通配符（星号）。
您不能将参数的通用过滤器值与数字值或一组值中的一个值配合使用。

全部

指定此项以显示所有属性。如果指定了此参数，那么还专门请求的任何属性都不起作用; 仍将显示所有属性。

在所有平台上，如果未指定通用名称并且未请求任何特定属性，那么这是缺省值。

[z/OS] 在 z/OS 上，如果使用 WHERE 参数指定过滤条件，那么这也是缺省值，但在其他平台上仅显示请求的属性。

CFSTRUCT ( 通用名称)

此参数是可选的，并将显示的信息限制为那些在方括号中指定了耦合设施结构值的队列。

该值可以是通用名称。如果未为此参数输入值，那么会将 CFSTRUCT 视为请求的参数。

CLUSINFO

这将请求除了显示有关此队列管理器上定义的队列的属性的信息外，还显示有关集群中与选择条件匹配的这些队列和其他队列的信息。在这种情况下，可能会显示多个具有相同名称的队列。从此队列管理器上的存储库获取集群信息。

[z/OS] 请注意，在 z/OS上，不能从 CSQINP2发出 DISPLAY QUEUE CLUSINFO 命令。

CLUSNL ( 通用名称 )

这是可选的，如果在方括号中输入了值，那么将限制显示的信息:

对于在本地队列管理器上定义的队列，只有那些具有指定集群列表的队列。该值可以是通用名称。仅以这种方式限制 CLUSNL 是有效参数的队列类型; 将显示满足其他选择标准的其他队列类型。
对于集群队列，仅当值不是通用名称时，才属于指定集群列表中的集群。如果该值是通用名称，那么不会对集群队列应用任何限制。

如果未输入值来限定此参数，那么会将其视为所请求的参数，并返回有关所显示的所有队列的集群列表信息。

注: 如果请求的处置是 SHARED，那么 CMDSCOPE 必须为空或本地队列管理器。

CLUSTER ( 属名 )

这是可选的，如果在括号中输入了值，那么会将显示的信息限制为具有指定集群名称的队列。该值可以是通用名称。此参数仅以此方式限制 CLUSTER 为有效参数的队列类型; 将显示满足其他选择条件的其他队列类型。

如果未输入值来限定此参数，那么会将其视为所请求的参数，并返回有关所显示的所有队列的集群名称信息。

CMDSCOPE

此参数仅适用于 z/OS ，并指定当队列管理器是队列共享组的成员时该命令的运行方式。

如果 QSGDISP 设置为 GROUP 或 SHARED，那么 CMDSCOPE 必须为空白或本地队列管理器。

'': 该命令在输入该命令的队列管理器上运行。这是缺省值。
qmgr-名称: 如果队列管理器在队列共享组中处于活动状态，那么该命令将在您指定的队列管理器上运行。
仅当您正在使用队列共享组环境并且启用了命令服务器时，才能指定队列管理器名称 (输入了命令的队列管理器除外)。
*: 该命令在本地队列管理器上运行，并且还会传递到队列共享组中的每个活动队列管理器。其效果与在队列共享组中的每个队列管理器上输入命令相同。

不能将 CMDSCOPE 用作过滤器关键字。

PSID ( 整数 )

队列所在页集的标识。这是可选操作。指定值会将显示的信息限制为与指定页集具有活动关联的队列。该值由两个数字字符组成，范围为 00-99。其自身的星号 * 指定所有页集标识。如果未输入值，那么将返回有关所显示的所有队列的页集信息。

仅当队列与页集之间存在活动关联时 (即，队列已成为 MQPUT 请求的目标之后) ，才会显示页集标识。在下列情况下，队列与页集的关联处于不活动状态:

队列刚刚定义
队列的 STGCLASS 属性已改变，并且没有针对队列的后续 MQPUT 请求
队列管理器已重新启动，并且队列上没有消息

此参数仅在 z/OS上有效。

QSGDISP

指定要显示其信息的对象的处置。这些值是：

实时

这是缺省值，并显示使用 QSGDISP(QMGR) 或 QSGDISP(COPY)定义的对象的信息。如果存在共享队列管理器环境，并且正在发出该命令的队列管理器上执行该命令，那么还将显示使用 QSGDISP(SHARED)定义的对象的信息。

全部

显示使用 QSGDISP(QMGR) 或 QSGDISP(COPY)定义的对象的信息。

如果存在共享队列管理器环境，并且正在发出该命令的队列管理器上执行该命令，那么此选项还会显示使用 QSGDISP(GROUP) 或 QSGDISP(SHARED)定义的对象的信息。

在共享队列管理器环境中:

DISPLAY QUEUE(name) CMDSCOPE(*) QSGDISP(ALL)

此命令列出队列共享组中与 name 匹配的对象，而不复制共享存储库中的对象。

COPY

仅显示使用 QSGDISP(COPY)定义的对象的信息。

GROUP

仅显示使用 QSGDISP(GROUP)定义的对象的信息。仅当存在共享队列管理器环境时，才允许执行此操作。

PRIVATE

仅显示使用 QSGDISP(QMGR) 或 QSGDISP(COPY)定义的对象的信息。

QMGR

仅显示使用 QSGDISP(QMGR)定义的对象的信息。

SHARED

仅显示使用 QSGDISP(SHARED)定义的对象的信息。这仅在共享队列管理器环境中允许。

注: 对于集群队列，此参数始终被视为请求的参数。返回的值是集群队列所代表的实际队列的处置。

如果指定了 QSGDISP(LIVE) 或缺省值，或者在共享队列管理器环境中指定了 QSGDISP(ALL) ，那么该命令可能会提供重复的名称 (具有不同的处置)。

注: 在 QSGDISP(LIVE) 情况下，仅当共享队列和非共享队列具有相同名称时才会发生此情况; 这种情况不应在受管良好的系统中发生。

QSGDISP 显示下列其中一个值:

QMGR: 对象是使用 QSGDISP(QMGR)定义的。
GROUP: 对象是使用 QSGDISP(GROUP)定义的。
COPY: 对象是使用 QSGDISP(COPY)定义的。
SHARED: 对象是使用 QSGDISP(SHARED)定义的。

不能将 QSGDISP 用作过滤器关键字。

STGCLASS ( 通用名称)

这是可选的，如果在方括号中输入了值，那么会将显示的信息限制为具有指定存储类的队列。该值可以是通用名称。

如果未输入值来限定此参数，那么会将其视为所请求的参数，并返回有关所显示的所有队列的存储类信息。

此参数仅在 z/OS上有效。

TARGTYPE ( 目标类型 )

这是可选的，用于指定要显示的别名队列的目标类型。

类型 ( queue-type )

这是可选的，并指定要显示的队列类型。如果指定 ALL(缺省值) ，那么将显示所有队列类型; 这包括集群队列 (如果还指定了 CLUSINFO )。

除 ALL外，您还可以指定 DEFINE 命令所允许的任何队列类型: QALIAS， QLOCAL， QMODEL， QREMOTE或其同义词，如下所示:

QALIAS: 别名队列
QLOCAL: 本地队列
QMODEL: 模型队列
QREMOTE: 远程队列

可以指定队列类型 QCLUSTER 以仅显示集群队列信息。如果指定了 QCLUSTER ，那么将忽略由 CFSTRUCT， PSID或 STGCLASS 参数指定的任何选择标准。请注意，不能从 CSQINP2发出 DISPLAY QUEUE TYPE(QCLUSTER) 命令。

[UNIX、Linux、Windows、IBM i] 在 Multiplatforms上， QTYPE ( type ) 可用作此参数的同义词。

将始终显示队列名称和队列类型 [z/OS] (以及在 z/OS上显示队列处置) 。

请求的参数

指定用于定义要显示的数据的一个或多个参数。可以按任何顺序指定参数，但不要多次指定相同的参数。

大多数参数仅与特定类型的队列相关。与特定类型的队列不相关的参数不会导致输出，也不会产生错误。

下表显示了与每种类型的队列相关的参数。表后有每个参数的简要描述，但有关更多信息，请参阅针对每个队列类型的 DEFINE 命令。

表 1. DISPLAY QUEUE 命令可返回的参数
	本地队列	模型队列	别名队列	远程队列	集群队列
ACCTQ			不适用	不适用	不适用
ALTDATE
ALTTIME
BOQNAME			不适用	不适用	不适用
BOTHRESH			不适用	不适用	不适用
资本支出					不适用
资本支出
CFSTRUCT			不适用	不适用	不适用
CLCHNAME			不适用	不适用	不适用
截止日期	不适用	不适用	不适用	不适用
CLUSNL		不适用			不适用
CLUSQMGR	不适用	不适用	不适用	不适用
CLUSQT	不适用	不适用	不适用	不适用
集群		不适用
聚时	不适用	不适用	不适用	不适用
CLWLPRTY		不适用
CLWLRANK		不适用
CLWLUSEQ		不适用	不适用	不适用	不适用
CRDATE			不适用	不适用	不适用
CRTIME			不适用	不适用	不适用
CURDEPTH		不适用	不适用	不适用	不适用
定制
DEFBIND		不适用
DEFPRESP
DEFPRTY
DEFPSIST
DEFREADA				不适用	不适用
DEFSOPT			不适用	不适用	不适用
DEFTYPE			不适用	不适用	不适用
DESCR
DISTL			不适用	不适用	不适用
GET				不适用	不适用
HARDENBO			不适用	不适用	不适用
IMGRCOVQ			不适用	不适用	不适用
INDXTYPE			不适用	不适用	不适用
INITQ			不适用	不适用	不适用
IPPROCS		不适用	不适用	不适用	不适用
MAXDEPTH			不适用	不适用	不适用
MAXFSIZE			不适用	不适用	不适用
MAXMSGL			不适用	不适用	不适用
MONQ			不适用	不适用	不适用
MSGDLVSQ			不适用	不适用	不适用
NPMCLASS			不适用	不适用	不适用
OPPROCS			不适用	不适用	不适用
流程			不适用	不适用	不适用
PROPCTL				不适用	不适用
PSID		不适用	不适用	不适用	不适用
PUT
QDEPTHHI			不适用	不适用	不适用
QDEPTHLO			不适用	不适用	不适用
QDPHIEV			不适用	不适用	不适用
QDPLOEV			不适用	不适用	不适用
QDPMAXEV			不适用	不适用	不适用
QMID	不适用	不适用	不适用	不适用
QSGDISP
QSVCIEV			不适用	不适用	不适用
QSVCINT			不适用	不适用	不适用
QTYPE
RETINTVL			不适用	不适用	不适用
RNAME	不适用	不适用	不适用		不适用
RQMNAME	不适用	不适用	不适用		不适用
SCOPE		不适用			不适用
SHARE			不适用	不适用	不适用
STATQ			不适用	不适用	不适用
STGCLASS			不适用	不适用	不适用
STREAMQ			不适用	不适用	不适用
STRMQOS			不适用	不适用	不适用
目标	不适用	不适用		不适用	不适用
TARGTYPE	不适用	不适用		不适用	不适用
TPIPE		不适用	不适用	不适用	不适用
TRIGDATA			不适用	不适用	不适用
TRIGDPTH			不适用	不适用	不适用
TRIGGER			不适用	不适用	不适用
TRIGMPRI			不适用	不适用	不适用
TRIGTYPE			不适用	不适用	不适用
用途			不适用	不适用	不适用
XMITQ	不适用	不适用	不适用		不适用

ACCTQ

是否对队列启用记帐 (在 z/OS上，线程级和队列级记帐) 数据收集。

ALTDATE

上次更改定义或信息的日期，格式为 yyyy-mm-dd。

ALTTIME

上次更改定义或信息的时间，格式为 hh.mm.ss。

BOQNAME

回退重新排队队列名称。

BOTHRESH

回退阈值。

CAPEXPRY( 整数 )

在解析路径中使用此对象打开的对象句柄上放入消息之前的最长时间 (以十分之一秒为单位) 将保留在系统中，直到该消息符合到期处理条件为止。

重要提示：若完整存储库位于本地 z/OS，则无法在集群 IBM MQ 9.3.1 环境中使用中引入的 CAPEXPRY 属性。

CLCHNAME

CLCHNAME 是将此队列用作传输队列的集群发送方通道的通用名称。该属性指定哪些集群发送方通道将消息从此集群传输队列发送到集群接收方通道。

日期

定义可供本地队列管理器使用的日期，格式为 yyyy-mm-dd。

CLUSNL

定义队列在其中的集群的名称列表。

CLUSQMGR

主管队列的队列管理器的名称。

CLUSQT

集群队列类型。这可以是：

QALIAS: 该集群队列表示别名队列。
QLOCAL: 该集群队列表示本地队列。
QMGR: 该集群队列表示队列管理器别名。
QREMOTE: 该集群队列表示远程队列。

集群

队列所在的集群的名称。

聚时

定义可供本地队列管理器使用的时间，格式为 hh.mm.ss。

CLWLPRTY

队列的优先级，用于集群工作负载分发。

CLWLRANK

用于集群工作负载分发的队列的列组。

CLWLUSEQ

是否允许放入除本地队列定义以外的其他队列定义。

CRDATE

定义队列的日期 (格式为 yyyy-mm-dd)。

CRTIME

定义队列的时间 (格式为 hh.mm.ss)。

CURDEPTH

当前的队列深度。

[z/OS] 对于处置方式为 z/OSGROUP 的队列， CURDEPTH 返回值为零。对于使用 SHARED 处置定义的队列，如果它们所使用的 CF 结构不可用或已失败，那么也会将其返回为零。

放入队列中的消息在放入消息时向当前深度计数。从队列获取的消息不计入当前深度。无论是否在同步点下执行操作，都是如此。落实对当前深度没有影响。因此：

放在同步点下 (但尚未落实) 的消息包含在当前深度中。
在同步点 (但尚未落实) 下获取的消息不会包括在当前深度中。

CUSTOM

该属性包含名称-值对，其形式为 NAME(VALUE)。值是一个由零个或多个属性-值对组成的列表，采用 MQSC 风格的语法，至少用一个空格隔开。以 IBM, AMQ, CSQ 或 MQ 开头的属性名称仅供 IBM 使用。附加保留属性为 CAPEXPRY、 SQGETTMR 和 PAGEVAL。

DEFBIND

缺省消息绑定。

DEFPRESP

缺省 put 响应; 定义当 MQPMO 选项中的 put 响应类型设置为 MQPMO_RESPONSE_AS_Q_DEF 时应用程序应使用的行为。

DEFPRTY

放入此队列的消息的缺省优先级。

DEFPSIST

放入此队列的消息的缺省持久性是设置为 NO 还是 YES。 NO 表示在重新启动队列管理器时丢失消息。

DEFREADA

这指定传递到客户机的非持久消息的缺省预读行为。

DEFSOPT

打开以输入的队列中的缺省共享选项。

DEFTYPE

队列定义类型。这可以是：

预定义 (预定义)
队列是由操作员或向服务队列发送命令消息的适当授权应用程序使用 DEFINE 命令创建的。
PERMDYN (永久动态)
队列是由发出 MQOPEN 的应用程序使用对象描述符 (MQOD) 中指定的模型队列的名称创建的，或者 (如果这是模型队列) 这将确定可从中创建的动态队列的类型。

队列 z/OS 是通过创建 QSGDISP(QMGR)的。
TEMPDYN (临时动态)
队列是由发出 MQOPEN 的应用程序使用对象描述符 (MQOD) 中指定的模型队列的名称创建的，或者 (如果这是模型队列) 这将确定可从中创建的动态队列的类型。

队列 z/OS 是通过创建 QSGDISP(QMGR)的。
共享 (SHAREDYN)
当应用程序发出具有在对象描述符 (MQOD) 中指定的此模型队列的名称的 MQOPEN API 调用时，创建了永久动态队列。

在 z/OS上，在队列共享组环境中，使用 QSGDISP(SHARED)创建了队列。

DESCR

说明性注释。

DISTL

伙伴队列管理器是否支持分发列表。仅在 Multiplatforms上受支持。

GET

是否为获取启用队列。

HARDENBO

是否固化回退计数以确保已回退消息的次数的计数是准确的。

注: 此参数仅影响 IBM MQ for z/OS。可以在其他平台上设置和显示，但没有效果。

IMGRCOVQ

如果正在使用线性日志记录，那么是从介质映像恢复本地动态队列对象还是永久动态队列对象。

注意：此参数在 IBM MQ for z/OS. 上无效。

INDXTYPE

索引类型 (仅在 z/OS上受支持)。

INITQ

启动队列名称。

IPPROCS

当前连接到队列以从队列获取消息的应用程序数。

[z/OS] 对于处置方式为 z/OSGROUP 的队列， IPPROCS 返回值为零。通过处置 SHARED，将仅返回发送回信息的队列管理器的句柄，而不返回整个组的信息。

MAXDEPTH

队列的最大深度。

MAXFSIZE

显示的队列文件的大小 (以兆字节为单位)。

此属性的缺省值为 DEFQFS，表示缺省队列文件大小，并等同于 2,088,960 MB 的硬编码值。

MAXMSGL

最大消息长度。

MONQ

在线监控数据收集。

MSGDLVSQ

消息传递顺序。

NPMCLASS

分配给放入队列的非持久消息的可靠性级别。

OPPROCS

当前连接到队列以将消息放入队列的应用程序数。

[z/OS] 对于处置方式为 z/OSGROUP 的队列， OPPROCS 返回值为零。通过处置 SHARED，将仅返回发送回信息的队列管理器的句柄，而不返回整个组的信息。

PROCESS

进程名称。

PROPCTL

属性控制属性。

此参数适用于本地队列，别名队列和模型队列。

此参数是可选的。

指定使用带有 MQGMO_PROPERTIES_AS_Q_DEF 选项的 MQGET 调用从队列中检索消息时如何处理消息属性。

允许的值为:

全部: 要包含除消息描述符（或扩展）中包含的属性之外的所有消息属性，请选择全部。全部值使无法更改的应用程序能够从 MQRFH2 头访问所有消息属性。
COMPAT: 如果消息包含前缀为 mcd.， jms.， usr.或 mqext.的属性，那么所有消息属性都将通过 MQRFH2 头传递到应用程序。否则，将废弃除消息描述符（或扩展）中包含的属性之外的所有消息属性，并且应用程序再也无法访问这些属性。; 这是缺省值; 它允许期望 JMS 相关属性位于消息数据中的 MQRFH2 头中的应用程序继续在未修改的情况下工作。
FORCE: 无论应用程序是否指定消息句柄，都将始终在 MQRFH2 头中的消息数据中返回属性。; 将忽略 MQGET 调用上 MQGMO 结构的 MsgHandle 字段中提供的有效消息句柄。无法通过该消息句柄访问消息的属性。
NONE: 在将消息传递到应用程序之前，将从消息中除去消息的所有属性 (消息描述符 (或扩展) 中的属性除外)。

PUT

是否启用队列以进行放置。

QDEPTHHI

队列深度上限事件生成阈值。

QDEPTHLO

队列深度下限事件生成阈值。

QDPHIEV

是否生成队列深度上限事件。

不能将 QDPHIEV 用作过滤器关键字。

QDPLOEV

是否生成队列深度下限事件。

不能将 QDPLOEV 用作过滤器关键字。

QDPMAXEV

是否生成 "队列已满" 事件。

不能将 QDPMAXEV 用作过滤器关键字。

QMID

托管队列的队列管理器的内部生成的唯一名称。

QSVCIEV

是否生成服务时间间隔事件。

不能将 QSVCIEV 用作过滤器关键字。

QSVCINT

服务时间间隔事件生成阈值。

QTYPE

队列类型。

将始终显示队列类型。

[UNIX、Linux、Windows、IBM i] 在多平台环境中，TYPE( type ) 可作为此参数的同义词使用。

RETINTVL

保留时间间隔。

RNAME

远程队列管理器知道的本地队列的名称。

RQMNAME

远程队列管理器名称。

SCOPE

队列定义的作用域 (在 z/OS上不受支持)。

SHARE

是否可以共享队列。

STATQ

是否要收集统计数据信息。

STGCLASS

存储类。

STREAMQ

放置每条消息副本的辅助队列的名称。

STRMQOS

将消息传递到重复队列时要使用的服务质量。

目标

此参数请求显示别名队列的基本对象名。

TARGTYPE

此参数请求显示别名队列的目标 (基本) 类型。

TPIPE

用于在网桥处于活动状态时使用 IBM MQ - IMS 网桥与 OTMA 通信的 TPIPE 名称。此参数仅在 z/OS上受支持。

[z/OS] 有关 TPIPE 的更多信息，请参阅《控制 IMS 桥接》。

TRIGDATA

触发器数据。

TRIGDPTH

触发器深度。

TRIGGER

触发器是否处于活动状态。

TRIGMPRI

触发器的阈值消息优先级。

TRIGTYPE

触发器类型。

USAGE

此队列是否是传输队列。

XMITQ

传输队列名称。

有关这些参数的更多详细信息，请参阅 DEFINE 队列。