fteStopAgent（停止 "MFT代理）

用途

在使用 fteStopAgent 命令停止代理时，您可以允许代理在停止之前完成当前文件传输，或者立即停止代理，即使代理当前正在传输文件。 在代理停止后，您无法使用代理来传输文件，直至重新启动代理。

如果要停止的代理程序已连接到 IBM® MQ 网络，那么可以从可以连接到 IBM MQ 网络并路由到代理队列管理器的任何系统运行 fteStopAgent 命令。 具体而言，要运行该命令，必须已在此系统上安装并配置 Managed File Transfer 组件 (服务或代理程序) 以与 IBM MQ 网络进行通信。 如果没有可用的连接详细信息，那么将建立与本地系统上缺省队列管理器的绑定方式连接。 如果 command.properties 不存在，那么将生成错误。

如果要停止的代理程序未连接到 IBM MQ 网络，例如，如果 IBM MQ 网络当前不可用，那么只能从运行该代理程序的系统运行 fteStopAgent 命令。 要停止未连接到 IBM MQ 网络的代理程序，必须从运行代理程序的用户运行 fteStopAgent 命令。 或者，如果代理在 Windows 系统上运行，那么您可以作为管理员来运行该命令。

仅当希望使用不同于缺省集的配置选项集时，才对该命令指定可选的 -p 参数。 请参阅 MFT agent.properties 文件 以获取更多信息。

如果代理正在作为 Windows 服务运行，那么运行 fteStopAgent 命令将停止 Windows 服务。 有关更多信息，请参阅 将 MFT 代理作为 Windows 服务启动。

参数

--m agent_qmgr_name

可选。 想要停止的代理连接到的队列管理器的名称。

如果代理位于远程系统上，或位于本地系统但您不是启动它的用户，那么必须使用 -m 参数并具有相应的权限。 有关权限的更多信息，请参阅 限制特定于 MFT的资源的组权限。

--p 配置选项

可选。 该参数确定用于发出请求以停止代理的配置选项集。 使用非缺省协调队列管理器的名称作为该参数的输入。 然后，命令使用与此非缺省协调队列管理器相关联的属性文件集。

如果未指定该参数，那么将使用基于缺省协调队列管理器的配置选项集。

-i

可选。 立即停止代理。 代理不会完成当前正在执行的任何传输。

如果未指定 -i 参数，那么代理完成当前正在执行的任何传输，但不会启动任何新传输。

-mquserid user_id

可选。 指定要向命令队列管理器进行认证的用户标识。

-mqpassword 密码

可选。 指定要向命令队列管理器进行认证的密码。 此外，还必须指定 -mquserid 参数。 如果指定了 -mquserid，但未指定 -mqpassword，将会提示您提供相关联的密码。 将不会显示密码。

agent_name

必需。 要停止的 Managed File Transfer 代理程序的名称。

-或-h

可选。 显示命令语法。

返回码

0

命令成功完成。

1

命令结束但未成功。