mqsistartmsgflow 命令

支持的平台

用途

使用 mqsistartmsgflow 命令启动消息流。

语法

参数

-b BrokerName
(必填)用于启动消息流的代理的名称。

如果您不指定 -e-m 标志,则会启动代理上的所有消息流。

-e ExecutionGroupName
(可选)启动消息流的执行组的名称。
-m msgFlowName
(可选)正在启动的消息流的名称。

在单个命令中只能指定一个消息流。但是,如果您不指定该参数,则会启动执行组或代理上的所有消息流。

如果指定了此标志,则必须也指定 -e 标志。

-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
(可选)将内部调试跟踪信息发送至指定的文件。

权限

要启动消息流,则需要在配置管理器的访问控制表中定义足够的权限。

所需的许可权与在 Message Brokers Toolkit 中执行相同功能所需的许可权相同,请参阅 ACL 许可权以获取有关在配置管理器中可定义的许可权列表。

响应

该命令返回下列响应:
0
(成功)表示已成功完成请求,并且所有消息流的状态已更新。
2
(失败)表示由于各种原因至少有一个消息流无法进入正确状态。
98
表示无法连接配置管理器
99
表示向实用程序提供的自变量无效。

示例

配置管理器控制对代理 B1 上所有消息流的启动,cm1.configmgr 中对此配置管理器连接进行了详细描述。当代理中的所有消息流都已报告为启动状态,或到达 60 秒的缺省时间(达到其中的任一条件),控制将返回到调用者。

   mqsistartmsgflow –n cm1.configmgr –b B1

配置管理器控制对代理 B1 上所有消息流的启动,cm1.configmgr 中对此配置管理器连接进行了详细描述。当代理中的所有消息流都已报告为启动状态,或到达 2 分钟(达到其中的任一条件),控制将返回到调用者。

   mqsistartmsgflow –n cm1.configmgr –b B1 –w 120

配置管理器控制对代理 B1 上所有消息流的启动。配置管理器是由队列管理器 QM1 托管的,该队列管理器位于本地主机的 1414 端口。

 mqsistartmsgflow –q QM1 –i localhost –p 1414 –b B1

输入 mqsistartmsgflow 以显示使用信息:

> mqsistartmsgflow
BIP1024I: Starts message flows.

> Syntax:
mqsistartmsgflow (-n cfgParameterFileName | (-i ipAddress -p port -q qMgr))
 -b brokerName [-e executionGroupName [-m flowName]] [-w timeoutValue]
[-v traceFileName]
Command Options:
'-n cfgParameterFileName' File containing 配置管理器 connection parameters (.configmgr)
'-i ipAddress' IP address or host name of the 配置管理器
'-p port' port number of the 配置管理器
'-q qMgr' queue manager of the 配置管理器
'-b brokerName' name of the broker on which to start message flows
'-e executionGroupName' name of the execution group on which to start message flows.
If this is not specified, all message flows on the broker will be started.
'-m flowName' name of the message flow to start.
If this is not specified, all message flows on the execution group will be started.
'-w timeoutValue' time to wait (in seconds) for message flows to start (Default=60)
'-v traceFileName' send verbose internal trace to the specified file.
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
an26100_