DELETE TOPIC (删除管理主题节点)

使用 MQSC 命令DELETE TOPIC删除一个IBM® MQ管理主题节点。

使用 MQSC 命令

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

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

同义词: 无

注：

（话题名称 ）

要删除的管理主题对象的名称。此参数是必需的。

该名称必须是现有管理主题对象的名称。

AUTHREC

此参数不适用于 z/OS

指定是否同时删除关联的权限记录:

CMDSCOPE

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

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

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

QSGDISP

此参数仅适用于 z/OS 。

指定要对其应用命令的对象的处置 (即，定义对象的位置及其行为方式)。

COPY

对象定义位于执行该命令的队列管理器的页集上。使用带有参数 QSGDISP （COPY ）的命令定义对象。任何位于共享存储库中的对象，或使用带有参数 QSGDISP （QMGR ）的命令定义的对象，均不受此命令的影响。

GROUP

对象定义位于共享存储库中。使用带有参数 QSGDISP （GROUP ）的命令定义对象。任何位于队列管理器页面集上的对象（执行命令的对象的本地副本除外）都不会受到此命令的影响。

如果该命令成功，那么将生成以下命令并将其发送到队列共享组中的所有活动队列管理器，以在页集 0 上创建或删除本地副本:

DELETE TOPIC(topic-name) QSGDISP(COPY)

即使使用 QSGDISP(COPY)生成的命令失败，删除组对象的操作也会生效。

QMGR

对象定义位于执行该命令的队列管理器的页集上。使用带有参数 QSGDISP （QMGR ）的命令定义对象。任何位于共享存储库中的对象或此类对象的任何本地副本都不会受到此命令的影响。

这是缺省值。

IGNSTATE

指定如果主题不存在，命令是否失败。该值可以是下列任一值：