mqsideleteexecutiongroup 命令

支持的平台

用途

使用 mqsideleteexecutiongroup 命令从代理中删除执行组。

您必须使用 mqsistart(在 Windows 平台、 Linux 和 UNIX 系统上),或 startcomponent(在 z/OS 上)启动配置管理器(请参阅 mqsistart 命令)后,才可以发出该命令。

如果您要删除先前已进行部署的执行组,则必须在发出该命令前也启动代理。

语法

参数

-b BrokerName
(必填)用于驻留执行组的代理的名称。
-e ExecutionGroupName
(必填)要删除的执行组的名称。
-n cfgParameterFileName
(可选)描述配置管理器连接参数的 .configmgr 文件的名称。
该文件为 XML 格式,使用 Eclipse GUI 保存的 .configmgr 格式。例如:
<?xml version="1.0" encoding="UTF-8" ?>
<configmgr host="localhost" listenerPort="1414" queueManager="QNAME"
           securityExit="test.myExit"/>
如果在 z/OS 上使用此文件,则必须从第一行除去语句 encoding="UTF-8",让此语句变为:
<?xml version="1.0"?>
并除去主机属性的值,让此语句变为:
<configmgr host="" listenerPort="1414" queueManager="QNAME"
           securityExit="test.myExit"/>
注: 如果不提供此参数,则必须提供 -i-p-q 参数。
-i ipAddress
(可选)配置管理器的主机名或 IP 地址。

如果在 z/OS 上使用此文件,并且要连接到本地主机,则必须将该值设置为 ""

-p Port
(可选)配置管理器的端口号。
-q qMgr
(可选)配置管理器所使用的 WebSphere MQ 队列管理器的名称。

如果不提供 -i-p-q 参数,则必须指定 -n 参数。

-w timeoutValue
(可选)删除执行组前的等待时间(以秒为单位),缺省值为 60 秒。
-v TraceFileName
(可选)将详细的内部跟踪信息发送至指定的文件。

权限

您需要成为“mqm”组中的成员,并且只有在配置管理器的访问控制表中对运行此命令的用户标识定义了正确的权限时,此命令才生效。

要删除执行组,需要对代理对象具有完整的控制权限;请参阅 ACL 许可权以获取有关在配置管理器中可定义的许可权列表。

响应

该命令返回下列响应:
0
(成功)表示已成功完成请求,并且已成功删除执行组。如果此命令用于删除先前已进行部署的执行组,则该返回码表示代理已停止并释放所有与该执行组关联的资源,例如消息流。
2
(失败)表示由于各种原因无法删除执行组。
98
表示无法连接配置管理器
99
表示向实用程序提供的自变量无效。

示例

在由配置管理器控制的域上删除执行组(在“BROKER”代理上称为“EG1”),配置管理器的队列管理器称为 QMGR 并在 fred.abc.com:1414 上进行侦听。

   mqsideleteexecutiongroup -i fred.abc.com -p 1414 -q QMGR -b BROKER –e EG1

在由文件 domain1.configmgr 指定的域上删除执行组(在“BROKER”代理上称为“EG2”)。

   mqsideleteexecutiongroup –n domain1.configmgr –b BROKER –e EG2

在由文件 domain2.configmgr 指定的域上删除执行组(在“FRED”代理上称为“EG3”)。请等候 5 分钟,以便配置管理器对资源进行整理并将输出发送至 trace.txt

  mqsideleteexecutiongroup –n domain2.configmgr –b FRED –e EG3 –w 300 –v trace.txt
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
an26010_