DISPLAY CHANNEL (显示通道定义) MQTT

使用 MQSC 命令 DISPLAY CHANNEL (MQTT) 来显示 MQ Telemetry 通道定义。

使用 MQSC 命令

有关如何使用 MQSC 命令的信息，请参阅使用 MQSC 命令执行本地管理任务。

语法图
DISPLAY CHANNEL (MQTT) 的参数描述
请求的参数

同义词:DIS CHL

显示通道 (MQTT)

请求的属性

DISPLAY CHANNEL (MQTT) 命令仅对 MQ Telemetry 通道有效。

DISPLAY CHANNEL (MQTT) 的参数描述

必须指定要显示的通道定义的名称。它可以是特定通道名或通用通道名。通过使用通用通道名称，可以显示以下任一项:

所有通道定义
一个或多个与指定名称匹配的通道定义

(generic-channel-name)

要显示的通道定义的名称 (请参阅用于命名 IBM® MQ 对象的规则 )。结尾星号（*）匹配所有名称为指定词干后跟零个或多个字符的通道定义。只有一个星号 (*) 本身表示指定所有通道定义。

CHLTYPE( type )

该值始终为 MQTT。

TYPE 可用作此参数的同义词。

WHERE

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

filter-keyword

几乎可以用于显示此 DISPLAY 命令的属性的任何参数。但是，不能使用 CMDSCOPE ， QSGDISP 或 MCANAME 参数作为过滤器关键字。如果同时使用 TYPE (或 CHLTYPE) 来选择通道，那么不能使用 TYPE (或 CHLTYPE)。不显示过滤器关键字不是有效属性的类型的通道。

操作员

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

LT: 小于
GT: 大于
EQ: 等于
NE: 不等于
LE: 小于或等于
GE: 大于或等于
LK: 与作为 filter-value 提供的通用字符串匹配
NL: 与作为 filter-value 提供的通用字符串不匹配
CT: 包含指定项。如果 filter-keyword 是列表，那么可以使用此列表来显示其属性包含指定项的对象。
EX: 不包含指定项。如果 filter-keyword 是列表，那么可以使用此列表来显示其属性不包含指定项的对象。
CTG: 包含与作为 filter-value提供的通用字符串匹配的项。如果 filter-keyword 是列表，那么可以使用此列表来显示其属性与通用字符串匹配的对象。
扩展组: 不包含与作为 filter-value提供的通用字符串匹配的任何项。如果 filter-keyword 是列表，那么可以使用此列表来显示属性与通用字符串不匹配的对象。

过滤器值

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

确切值，对于要测试的属性，它是有效值。
您只能使用运算符 LT、GT、EQ、NE、LE 或 GE。但是，如果属性值是参数上可能存在的一组值 (例如， TYPE 参数上的值 SDR) 中的一个值，那么只能使用 EQ 或 NE。
通用值。这是一个在末尾带有星号 (例如 ABC*) 的字符串 (例如，您为 DESCR 参数提供的字符串)。这些字符必须对您正在测试的属性有效。如果运算符是 LK，那么列出属性值以此字符串（在此示例中是 ABC）开始的所有项。如果运算符是 NL，那么列出属性值不以此字符串开始的所有项。只允许单个拖尾通配符（星号）。
您不能将参数的通用过滤器值与数字值或一组值中的一个值配合使用。
值列表中的项。该值可以是显式值，如果它是字符值，那么可以是显式值或通用值。如果是显式的，请使用 CT 或 EX 作为运算符。例如，如果使用运算符 CT 指定 DEF 值，那么列出其中一个属性值是 DEF 的所有项。如果它是通用的，请使用 CTG 或 EXG 作为运算符。如果使用操作程序 CTG 指定 ABC* ，那么将列出其中一个属性值以 ABC 开头的所有项。

ALL

指定 ALL 以显示查询所有参数的结果。如果指定了 ALL ，那么将忽略针对特定参数的任何请求。使用 ALL 查询的结果是返回所有可能的参数的结果。

如果未指定通用名称并且未请求任何特定参数，那么这是缺省值。

如果未指定任何参数 (并且未指定 ALL 参数或缺省参数) ，那么缺省情况是仅显示通道名称。

请求的参数

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

某些参数仅与特定类型的通道相关。与特定类型的通道不相关的属性不会导致输出，也不会产生错误。下表显示了与每种类型的通道相关的参数。表后有每个参数的描述。参数是可选的，除非描述声明它们是必需的。

BACKLOG: 遥测通道在任何时间可以支持的未解决连接请求的数目。当达到积压限制时，尝试进行连接的任何其他客户机将被拒绝连接，直至当前积压得到处理。该值在 0-999999999 范围内。缺省值为 4096。
CHLTYPE: 通道类型。; 此参数只有一个有效值: MQTT。
JAASCFG: JAAS 配置文件中节的名称。
LOCLADDR: 通道的本地通信地址。
MCAUSER: 消息通道代理程序用户标识。
PORT: 遥测 (MQXR) 服务接受客户机连接的端口号。
PROTOCOL: 通道支持的通信协议。
SSLCAUTH: 定义 IBM MQ 是否需要 TLS 客户机的证书。
SSLCIPH: 当 SSLCIPH 与遥测通道配合使用时，表示 TLS 密码套件。
SSLKEYP: 密钥存储库的密码。如果未输入口令，那么必须使用未加密的连接。
SSLKEYR: TLS 密钥存储库的名称。有关完整详细信息，请参阅 ALTER QMGR 命令的 SSLKEYR 参数。
TRPTYPE: 要使用的传输协议。对于遥测通道，这始终是 TCP (即 TCP/IP 协议)。
USECLTID: 指示是否要将连接的 MQTT 客户机标识用作该连接的 IBM MQ 用户标识。

有关这些参数的更多详细信息，请参阅 DEFINE CHANNEL (定义新通道) for MQTT。