![[MQ 9.2.2 2021 年 3 月]](ng922.gif)
fteStopMonitor (停止 MFT 资源监视器)
fteStopMonitor 命令从命令行停止 Managed File Transfer 资源监视器。
用途
从 IBM® MQ 9.2.2开始,可以使用 fteStopMonitor 命令来停止资源监视器,而无需停止或重新启动代理程序。
您可以从安装了 Managed File Transfer 命令组件的任何系统运行此命令,这意味着您可以从任何位置停止资源监视器,并且不限于拥有该资源监视器的代理程序正在运行的系统。
Syntax
参数
- - -p 配置选项
- 可选。 此参数确定用于停止资源监视器的配置选项集。 将配置选项集的名称用作 -p 参数的值。 按照约定,这是协调队列管理器的名称。 如果未指定该参数,那么会使用缺省的配置选项集。
- -ma 代理名称
- 必需。 运行资源监视器操作的代理程序的名称。
- -mm 队列管理器
- 可选。 代理连接到的队列管理器的名称。
- -mn monitor_name
- 必需。 要停止的资源监视器的名称。
- - w 超时
- 可选。 如果未指定 timeout 值,那么缺省值为等待代理程序响应最多 5 秒。
- -mquserid user_id
- 可选。 指定要向命令队列管理器进行认证的用户标识。
- -mqpassword 密码
- 可选。 指定要向命令队列管理器进行认证的密码。 此外,还必须指定 -mquserid 参数。 如果指定 -mquserid 但未同时指定 -mqpassword,那么系统会提示您提供关联的密码。 在屏幕上不会显示此密码。
示例 1: 同一机器上的资源监视器和代理程序
以下命令将停止在同一机器上运行的代理程序中的资源监视器:
fteStopMonitor -mn MNTR -ma SOURCE
此命令输出以下消息:
BFGCL0813I: 已发出停止代理程序 "SOURCE" 的资源监视器 "MNTR" 的请求。 BFGCL0251I: 请求已成功完成。
以下事件记录在代理程序的 output0.log中。
BFGDM0069I: 监视器 MNTR 已停止。
示例 2-在不同机器上运行的资源监视器和代理程序
以下命令将停止在其他机器上运行的代理程序中的资源监视器:
fteStopMonitor -mn MNTR -ma SOURCE -mm SRCQM
此命令输出以下消息:
BFGCL0813I: 已发出停止代理程序 "SOURCE" 的资源监视器 "MNTR" 的请求。 BFGCL0251I: 请求已成功完成。
以下事件记录在代理程序的 output0.log中。
BFGDM0069I: 监视器 MNTR 已停止。
其他消息的示例
如果接收到以下任何消息,那么可以使用带有 -v 参数的 fteListMonitors 命令来检查代理程序的状态。 -v 参数生成详细输出,其中包含有关资源监视器状态的其他信息,包括资源监视器是已启动还是已停止,正在监视的目录资源路径以及触发条件。
- 资源监视器已处于 "已停止" 状态
- 此命令输出以下消息:
BFGCL0813I: 已发出停止代理程序 "SOURCE" 的资源监视器 "MNTR" 的请求。 BFGCL0815I: 代理程序 "SOURCE" 的资源监视器 "MNTR" 已停止。
- 资源监视器位于已停止的代理程序中
- 此命令输出以下消息:
BFGCL0813I: 已发出停止代理程序 "SOURCE" 的资源监视器 "MNTR" 的请求。 BFGCL0253W: 未在超时内确认来自代理程序的命令。
- 指定的代理程序未知
- 该命令输出以下消息:
BFGUB0009E: 缺少以下必需属性文件: "/root/mftdata/mqft/config/MFTHAQM/agents/UKNOWNAGENT/agent.properties"
- 在指定的代理程序上找不到指定的资源监视器
- 此命令输出以下消息:
BFGCL0813I: 已发出停止代理程序 "IJQ" 的资源监视器 "UNKNOWNMONITOR" 的请求。 BFGCL0250E: 在给定的代理程序上找不到监视器。
返回码
- 0
- 命令成功完成。
- 1
- 命令结束但未成功。
