ALTER NAMELIST (改变名称列表)

使用 MQSC 命令 ALTER NAMELIST 来变更名称列表。此列表通常是集群名称或队列名称的列表。

使用 MQSC 命令

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

ALTER NAMELIST 命令中未指定的参数会导致这些参数的现有值保持不变。

[z/OS] 您可以通过源 2CR 发布该命令。有关源符号的解释，请参阅可以从中发出 MQSC 和 PCF 命令的源IBM MQ for z/OS®。

同义词:ALT NL

注：

成功完成命令并不意味着操作已完成。要检查是否真正完成，请参阅检查分布式网络的异步命令是否已完成中的 ALTER NAMELIST 步骤。

(名称)

列表的名称。

该名称不得与当前在此队列管理器上定义的任何其他名称列表名称相同 (除非指定了 REPLACE 或 ALTER )。请参阅用于命名 IBM MQ 对象的规则。

CMDSCOPE

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

CMDSCOPE 必须为空，如果设置为，则必须为本地队列管理器。 QSGDISP GROUP

' ': 该命令在输入它的队列管理器上运行。
队列管理器名称: 该命令在您指定的队列管理器上运行，前提是该队列管理器在队列共享组中处于活动状态。
仅当您使用共享队列环境并且命令服务器已启用时，才可以指定输入队列管理器之外的队列管理器名称。
*: 该命令在本地队列管理器上运行，并且还传递给队列共享组中的每个活动队列管理器。指定 * 的效果与在队列共享组中的每个队列管理器上输入该命令相同。

DESCR(字符串 )

纯文本注释。当操作员发出 DISPLAY NAMELIST 命令时，它将提供有关命名列表的描述性信息（见显示姓名列表（显示姓名列表））。

它必须只包含可显示的字符。最大长度为 64 个字符。在 DBCS 安装中，它可以包含 DBCS 字符（最大长度为 64 个字节）。

注: 如果使用的字符不在此队列管理器的编码字符集标识 (CCSID) 中，那么如果将信息发送到另一个队列管理器，那么可能无法正确转换这些字符。

NAMES(名称，...... ）

名称列表。

这些名称可以是任何类型，但必须符合命名 IBM MQ 对象的规则，最大长度为 48 个字符。

空列表有效: 指定 NAMES()。列表中的最大名称数为 256。

NLTYPE

指示名称列表中的名称类型。

此参数仅在z/OS。

用于聚类的名称列表必须具有NLTYPE(CLUSTER)或者NLTYPE(NONE)。

用于 TLS 的名称列表必须具有NLTYPE(AUTHINFO)。

QSGDISP

此参数适用于z/OS仅有的。

指定应用命令的对象的配置（即，它的定义位置和行为方式）。

表 1. 每个 QSGDISP 值的行为
QSGDISP	更改
COPY	对象定义驻留在执行该命令的队列管理器的页面集上。该对象是使用具有参数的命令定义的QSGDISP(COPY)。任何驻留在共享存储库中的对象，或使用带有参数的命令定义的对象， QSGDISP(QMGR)均不受此命令影响。
GROUP	对象定义驻留在共享存储库中。该对象是使用具有参数的命令定义的QSGDISP(GROUP)。执行该命令的队列管理器的页面集上驻留的任何对象（对象的本地副本除外）都不会受到此命令的影响。如果命令成功，则会生成以下命令并将其发送到队列共享组中的所有活动队列管理器，以尝试刷新页面集零上的本地副本： `DEFINE NAMELIST(name) REPLACE QSGDISP(COPY)` 这ALTER对于组对象，无论生成的命令是否使用QSGDISP(COPY)失败。
PRIVATE	该对象驻留在执行命令的队列管理器的页面集上，并定义为QSGDISP(QMGR)或者QSGDISP(COPY)。驻留在共享存储库中的任何对象均不受影响。
QMGR	对象定义驻留在执行该命令的队列管理器的页面集上。该对象是使用具有参数的命令定义的QSGDISP(QMGR)。驻留在共享存储库中的任何对象或此类对象的任何本地副本均不受此命令的影响。