mqsicreateexecutiongroup 命令

支持的平台

用途

使用 mqsicreateexecutiongroup 命令将新执行组添加到代理中。

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

必须先在配置管理器中定义代理,然后才可以使用该命令。

语法

参数

-b BrokerName
(必填)用于创建执行组的代理的名称。
-e ExecutionGroupName
(必填)新执行组的名称。
-l
(可选)创建 64 位执行组。
-n cfgParameterFileName
(可选)描述配置管理器连接参数的 .configmgr 文件的名称。
该文件为 XML 格式,使用 工作台 保存的 .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 参数,则必须指定 -connection 参数。

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

权限

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

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

响应

该命令返回下列响应:
0
(成功)表示已成功完成请求,并且已在配置管理器的存储库中成功创建执行组。下次部署代理时,将在代理上初始化新的执行组列表。
2
(失败)表示由于各种原因无法创建执行组。
98
表示无法连接配置管理器
99
表示向实用程序提供的自变量无效。

示例

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

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

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

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

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

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