fteCreateEnvironment（'Redistributable Managed File Transfer Agent用の環境をセットアップする）

fteCreateEnvironment コマンドは、 Redistributable Managed File Transfer Agentのファイルの構成および転送のための環境を設定します。

目的

fteCreateEnvironment コマンドを使用して、 Redistributable Managed File Transfer Agentを使用するための環境をセットアップします。

[MQ 9.2.1 Dec 2020] IBM® MQ 9.2.1以降、この環境は Redistributable Managed File Transfer Loggerと共有されます。

-dパラメーターを指定してこのコマンドを実行すると、MFTエージェント・データ・ファイルの場所を指定できます。 -dパラメーターを指定しない場合、コマンドはRedistributable Managed File Transfer Agentダウンロード・ロケーションにデータ・ファイルを作成し、データ・パスを設定します。

[MQ 9.2.0 Jul 2020] IBM MQ 9.2.0 から、パラメータには、インストール名を指定するオプションがあります。 -n IBM MQ このオプションに指定した値は、同じコンソール・セッションから実行される残りの MFT コマンドに使用される。

Syntax

fteCreateEnvironment

パラメーター

-d data_location

オプション。このパラメーターは、環境のセットアップ時にデータ・ファイルの場所を指定するために使用します。

このパラメーターを指定しない場合、 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シェル上で実行する必要がある。 bash シェルでは、このコマンドをさまざまな方法で実行できますが、コマンド・ファイルをソースとして使用することが必要です。

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 (M) に更新されます。

この例では、 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

戻りコード

0: コマンドは正常に完了しました。
1: コマンドは失敗しました。