fteSetupCommands(「MFT command.propertiesファイルを作成する)
fteSetupCommands コマンドは、 Managed File Transfer command.properties ファイルを作成します。 このプロパティー・ファイルは、コマンド発行時に IBM® MQ ネットワークに接続するキュー・マネージャーの詳細を指定します。
AIX®, Linux®, and Windows システムで、 サーバーのインストールイメージを使用している場合、コマンドを実行するには、次の2つの条件を両方とも満たす必要があります。 IBM MQ - IBM MQ の管理者になる。
- mqm グループのメンバーである (システムに mqm グループが定義されている場合)。
z/OS® システムでは、コマンドを実行するには、これらの条件のうち少なくとも1つを満たす必要があります- mqm グループのメンバーである (システムに mqm グループが定義されている場合)。
- BFG_GROUP_NAME環境変数で指定されたグループのメンバーになる(グループが指定されている場合)。
- コマンドを実行する際に、BFG_GROUP_NAME環境変数に値が設定されていない。
目的
fteSetupCommands コマンドは、調整キュー・マネージャー構成ディレクトリーに command.properties ファイルを作成するために使用します。 このコマンドは MQ_DATA_PATH 環境変数および installation.properties ファイルを使用して、command.properties ファイルを見つける場所を判別します。 fteSetupCommands コマンドを発行する前に、調整キュー・マネージャーを既に作成および構成してあることを確認してください。
プロパティー・ファイルについて詳しくは、 MFT command.properties ファイルを参照してください。
Syntax
パラメーター
- -connectionQMgr connection_qmgr_name
- 必須。 IBM MQ ネットワークに接続してコマンドを発行するために使用されるキュー・マネージャーの名前。
- -connectionQMgrHost connection_qmgr_host
- オプション。 接続キュー・マネージャーのホスト名または IP アドレス。
-connectionQMgrHostパラメーターを指定しない場合、バインディング・モード接続が想定されます。 このため、クライアント・モードでの接続を使用する場合、このパラメーターは必須です。
-connectionQMgrHost パラメーターに値を指定し、-connectionQMgrPortプロパティーと-connectionQMgrChannelプロパティーには値を指定しない場合は、デフォルトでポート番号 1414 とチャネル SYSTEM.DEF.SVRCONN が使用されます。
- -connectionQMgrPort connection_qmgr_port
- オプション。 クライアント・モードの接続キュー・マネージャーとの接続に使用されるポート番号。 -connectionQMgrPortパラメーターを指定する場合は、-connectionQMgrHostパラメーターも指定する必要があります。
- -connectionQMgrChannel connection_qmgr_channel
- オプション。 接続キュー・マネージャーとの接続に使用されるチャネル名。 -connectionQMgrChannelパラメーターを指定する場合は、-connectionQMgrHostパラメーターも指定する必要があります。
- -p configuration_options
- オプション。 このパラメーターは、コマンド・キュー・マネージャーをセットアップするために使用される構成オプションのセットを決定します。 このパラメーターの入力には、デフォルト調整キュー・マネージャー以外の名前を使用します。 これで、fteSetupCommands コマンドは、デフォルト以外の調整キュー・マネージャーと関連付けられたプロパティー・ファイルのセットを使用します。
このパラメーターを指定しない場合、デフォルトの調整キュー・マネージャーに基づいた構成オプションのセットが使用されます。
- -credentialsFile file_path
- オプション。 IBM MQ 認証の詳細が追加される既存または新規の資格情報ファイルの絶対ファイル・パス。
このコマンドは、指定されたManaged File Transfer資格情報ファイルへの一連のIBM MQ認証詳細の追加をサポートします。 このコマンドは、 IBM MQ 接続認証が有効になっている場合に使用します。 既存の詳細を更新する場合は、-fforce パラメーターを使用する必要があります。
- -ユーザーID ユーザーID
- オプション。 資格情報の詳細を関連付けるために使用するユーザー ID。 ユーザー ID を指定しない場合、資格情報の詳細はすべてのユーザーに適用されます。 -credentialsFileパラメーターも指定する必要があります。
- -f
- オプション。 既存の command.properties ファイルを、このコマンドで指定された詳細で強制的に上書きします。
- - ? または -h
- オプション。 コマンド構文を表示します。
例
fteSetupCommands -connectionQMgr QM_NEPTUNE -connectionQMgrHost 9.146.157.241
-connectionQMgrPort 1414 -connectionQMgrChannel SYSTEM.DEF.SVRCONN
戻りコード
- 0
- コマンドは正常に完了しました。
- 1
- コマンドは失敗しました。
