mqsistopmsgflow 命令

支持的平台

用途

使用 mqsistopmsgflow 命令停止消息流。

语法

参数

-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 的执行组 default 上的所有消息流,该过程由配置管理器进行控制,cm1.configmgr 中对此配置管理器的连接进行了详细描述。当执行组中的所有消息流已报告为停止状态,或到达 60 秒的缺省时间(达到其中的一个条件),控制将返回到调用者。

   mqsistopmsgflow –n cm1.configmgr –b B1 -e default

停止代理 B1 的执行组 default 上的消息流 flow1,该过程由配置管理器进行控制,cm1.configmgr 中对此配置管理器的连接进行了详细描述。当消息流报告为停止状态,或到达 60 秒的缺省时间(达到其中的一个条件),控制将返回到调用者。

   mqsistopmsgflow –n cm1.configmgr –b B1 -e default -m flow1

输入 mqsistopmsgflow 以显示使用信息:

> mqsistopmsgflow
BIP1025I: Stops message flows.

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