fteCreateEnvironment（为Redistributable Managed File Transfer Agent 设置环境）

fteCreateEnvironment 命令用于设置 Redistributable Managed File Transfer Agent的文件配置和传输环境。

用途

您可以使用 fteCreateEnvironment 命令来设置环境以使用 Redistributable Managed File Transfer Agent。

从 IBM® MQ 9.3.0开始，此环境与 Redistributable Managed File Transfer Logger共享。

您可以使用 -d 参数运行此命令，以指定 MFT 代理程序数据文件的位置。如果未指定 -d 参数，那么该命令将在 Redistributable Managed File Transfer Agent 下载位置中创建数据文件并设置数据路径。

-n 参数提供了指定 IBM MQ 安装名称的选项。您为此选项指定的值用于从同一控制台会话运行的其余 MFT 命令。

--d 数据位置

可选。在设置环境时，此参数用于指定数据文件的位置。

如果未指定此参数，那么将在抽取 Redistributable Managed File Transfer Agent 的位置中创建数据目录 (如果尚不存在) ，并为此位置设置环境变量 (BFG_DATA)。

-或-h

可选。显示命令语法。

--n 安装名称

可选。此参数用于指定 IBM MQ 安装的名称或唯一名称。唯一名称必须遵循与 IBM MQ 安装名称相同的命名标准。有关命名标准的更多信息，请参阅 AIX®, Linux®, and Windows上的安装名称。

您可能希望使用此参数的情况示例如下:

如果要快速测试新功能或功能部件，请将可再分发包与现有配置配合使用，其中已将代理程序配置为仅以客户机方式连接到队列管理器。 (请注意，此参数不适用于配置为以绑定方式连接到队列管理器的任何代理程序。)
如果要从标准 Managed File Transfer 安装迁移到 Redistributable Managed File Transfer Agent 软件包，并且要使用与标准安装所创建的配置相同的配置。在这种情况下，已安装标准 Managed File Transfer ，但正在连接到另一台机器上运行的代理队列管理器。

缺省安装名称变量为 BFG_INSTALLATION_NAME。

在本例中，在 Windows 上， -d 参数指定了创建数据文件夹的位置：

fteCreateEnvironment -d C:\mftRedistributable\mftData

在 Linux 上，前提条件是必须在 bash shell 上运行该命令。在 Bash shell 中，可通过多种方式来运行此命令，并且必须指定命令文件的来源：

source Path_of_MFTZipBin/fteCreateEnvironment

替代方法为：

. Path_of_MFTZipBin/fteCreateEnvironment

或者，如果从命令文件所在的目录中运行：

. ./fteCreateEnvironment

注意: 注意第一个句点字符 (.) 后面的空格

此示例创建一个环境，您可以在此环境中指定 MFT 配置数据路径和安装名称环境变量:

fteCreateEnvironment -d C:/ProgramData/IBM/mq/mqft -n MFTPROD

此命令的输出为:

5724-H72 Copyright IBM Corp. 2008, 2025.  ALL RIGHTS RESERVED
BFG_DATA is C:\ProgramData\IBM\MQ
BFG_INSTALLATION_NAME is MFTPROD

BFG_INSTALLATION_NAME 和 BFG_DATA 环境变量都将更新为新值。

此示例仅为安装名称创建新的环境变量。数据路径在 C:\ProgramData\IBM\MQ处保持不变。

fteCreateEnvironment -n MFTPROD

该命令的输出为:

5724-H72 Copyright IBM Corp. 2008, 2025.  ALL RIGHTS RESERVED
BFG_DATA is C:\ProgramData\IBM\MQ
BFG_INSTALLATION_NAME is MFTPROD

BFG_INSTALLATION_NAME 环境变量将更新为新值 MFTPROD。

此示例仅为 MFT 配置数据的路径创建新的环境变量。安装名称在 MFTPROD处保持不变:

fteCreateEnvironment -d C:/ProgramData/IBM/MQ2

该命令的输出为:

5724-H72 Copyright IBM Corp. 2008, 2025.  ALL RIGHTS RESERVED
BFG_DATA is C:\ProgramData\IBM\MQ2
BFG_INSTALLATION_NAME is MFTPROD

表 1. 返回代码标识符和描述
返回码	描述
0	命令成功完成
1	命令未成功执行