fteStartAgent

fteStartAgent 命令从命令行启动 Managed File Transfer 代理程序。

用途

使用 fteStartAgent 命令来启动 Managed File Transfer 代理程序。必须先启动代理，才能使用它执行文件传输。 fteStartAgent 命令在您发出命令的系统上启动代理：不能在远程系统上启动代理。

对于 IBM® WebSphere® MQ 7.5 或更高版本，代理进程控制器管理代理程序的启动。但是，在某些情况下，例如当代理运行失败的频率比较高时，代理进程控制器可能会等待一段时间，然后再重新尝试启动代理。作为 IBM MQ 管理员，您可以使用 fteStartAgent 命令来覆盖此等待并启动代理程序。如果代理进程控制器在等待队列管理器变为可用，那么该命令还将启动尝试重新连接到队列管理器的代理进程控制器。

[Windows] If you have configured the agent to run as a Windows service by using the fteCreateAgent or fteModifyAgent command, running the fteStartAgent command starts the Windows service.

如果代理未启动或已启动，那么该命令将返回错误。代理根据 agent.properties 文件中定义的值与其队列管理器通信。

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

注意：代理事件日志文件 output0.log 包含详细信息，有助于理解 fteStartAgent 命令的结果。

Syntax

fteStartAgent

参数

-F: 可选。该参数将代理守护程序作为前台进程运行。缺省值是针对要在后台运行的代理守护程序。
如果您正在 Windows上运行，并且已使用 fteCreateAgent 或 fteModifyAgent 命令将代理程序配置为作为 Windows 服务运行，那么 -F 参数将覆盖此配置。
--p 配置选项: 可选。该参数确定用于发出请求以启动代理的配置选项集。使用非缺省协调队列管理器的名称作为该参数的输入。然后，命令使用与此非缺省协调队列管理器相关联的属性文件集。
如果未指定该参数，那么将使用基于缺省协调队列管理器的配置选项集。
agent_name: 必需。要启动的 Managed File Transfer 代理程序的名称。
-或-h: 可选。显示命令语法。

示例

在本示例中，AGENT2 将启动并在前台运行。

fteStartAgent -F AGENT2

在以下示例中 (对于 UNIX 和 Linux® 系统) ， AGENT2 是使用非缺省协调队列管理器 QM_SATURN 启动的:

./fteStartAgent -p QM_SATURN AGENT2

您还可以按照如下方式指定 fteStartAgent 的路径来运行此命令：

path/fteStartAgent agentname

返回码

0: 命令成功完成。
1: 命令结束但未成功。

响应

在一些情况下，您可能会在运行 fteStartAgent 命令后看到错误消息：

如果运行 fteStartAgent 命令并看到以下错误消息，那么您的环境可能具有与 Managed File Transfer冲突的其他库路径:
```
BFGCL0001E: An internal error has occurred. 异常为："CC=2;RC=2495;AMQ8568: "
 找不到本地 JNI 库 "mqjbnd"。[3=mqjbnd]
```
如果 LD_LIBRARY_PATH 或 LIBPATH 环境变量设置为先引用 64 位版本的库，然后引用 32 位版本的库，而同时正在使用 32 位版本的 Java 运行代理（对于大部分平台，都是这种情况），那么会发生此错误。
要解决这个问题，请设置 "Managed File Transfer代理属性javaLibraryPath，以引用库的正确位置。例如，对于 AIX® 上的 mqjbnd，请设置为：/usr/mqm/java/lib。对于 Linux 上的 mqjbnd，请设置为：/opt/mqm/java/lib