fteStopMonitor(停止MFT资源监控器)

fteStopMonitor 命令从命令行停止 Managed File Transfer 资源监视器。

用途

IBM® MQ 9.3.0开始,可以使用 fteStopMonitor 命令来停止资源监视器,而无需停止或重新启动代理程序。

您可以从安装了 Managed File Transfer 命令组件的任何系统运行此命令,这意味着您可以从任何位置停止资源监视器,并且不限于拥有该资源监视器的代理程序正在运行的系统。

Syntax

fteStopMonitor

Read syntax diagramSkip visual syntax diagramfteStopMonitor -pconfiguration_options-maagent_name -mmqueue_manager-mn-- monitor_name-wtimeout-mquseriduser_id-nolpw-mqpasswordpassword-nolpw

参数

--p 配置选项
可选。 此参数确定用于停止资源监视器的配置选项集。 将配置选项集的名称用作 -p 参数的值。 按照约定,这是协调队列管理器的名称。 如果未指定该参数,那么会使用缺省的配置选项集。
-ma 代理名称
必需。 运行资源监视器操作的代理程序的名称。
-mm 队列管理器
可选。 代理连接到的队列管理器的名称。
fteStopMonitor 命令连接到命令队列管理器。 如果命令队列管理器也是监视代理的代理队列管理器,那么 -mm 参数是可选的,否则必须使用 -mm 参数指定代理队列管理器。
-mn 监视器名称
必需。 要停止的资源监视器的名称。
--w 超时
可选。 如果未指定 timeout 值,那么缺省值为等待代理程序响应最多 5 秒。
timeout 值指定代理程序响应的值 (以秒计)。 如果指定的超时值为 -1 ,那么该命令将永远等待代理程序响应。
-mquserid 用户ID
可选。 指定要向命令队列管理器进行认证的用户标识。
-mqpassword 密码
可选。 指定通过协调队列管理器进行认证时所使用的密码。
指定 -mqpassword 参数时,还必须指定 -mquserid 参数。 如果指定 -mquserid,但未指定 -mqpassword,那么系统将提示您提供关联的密码,不会显示该密码。

该命令缺省为使用 MQCSP 认证,并将要认证的用户标识和密码发送到 MQCSP 结构中的队列管理器。

-nolpw
可选。 如果命令连接到不支持长度超过 12 个字符的密码的队列管理器,请指定此参数。
指定 -nolpw 参数时,还必须指定 -mquserid 参数。 如果指定 -mquserid-nolpw,但未指定 -mqpassword,那么系统会提示您提供关联的密码,不会显示该密码。
注: 如果指定 -nolpw 选项,并且密码长度超过 12 个字符,那么命令将失败并返回错误消息 BFGCL0829E

示例 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: 在给定的代理程序上找不到监视器。

返回码

表 1. 返回代码名称和描述
返回码 描述
0 命令成功完成
1 命令未成功执行