fteStopMonitor(停止MFT资源监控器)
fteStopMonitor 命令从命令行停止 Managed File Transfer 资源监视器。
用途
从 IBM® MQ 9.3.0开始,可以使用 fteStopMonitor 命令来停止资源监视器,而无需停止或重新启动代理程序。
您可以从安装了 Managed File Transfer 命令组件的任何系统运行此命令,这意味着您可以从任何位置停止资源监视器,并且不限于拥有该资源监视器的代理程序正在运行的系统。
Syntax
参数
- --p 配置选项
- 可选。 此参数确定用于停止资源监视器的配置选项集。 将配置选项集的名称用作 -p 参数的值。 按照约定,这是协调队列管理器的名称。 如果未指定该参数,那么会使用缺省的配置选项集。
- -ma 代理名称
- 必需。 运行资源监视器操作的代理程序的名称。
- -mm 队列管理器
- 可选。 代理连接到的队列管理器的名称。
- -mn 监视器名称
- 必需。 要停止的资源监视器的名称。
- --w 超时
- 可选。 如果未指定 timeout 值,那么缺省值为等待代理程序响应最多 5 秒。
- -mquserid 用户ID
- 可选。 指定要向命令队列管理器进行认证的用户标识。
- -mqpassword 密码
- 可选。 指定通过协调队列管理器进行认证时所使用的密码。
- -nolpw
- 可选。 如果命令连接到不支持长度超过 12 个字符的密码的队列管理器,请指定此参数。
示例 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 已停止。
其他消息的示例
如果收到以下信息,可以使用带fteListMonitors参数的-v命令检查代理的状态。 -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 | 命令未成功执行 |
