fteSetupCoordination (プロパティー・ファイルおよび調整キュー・マネージャー・ディレクトリーのセットアップ)

fteSetupCoordination コマンドは、 Managed File Transferのプロパティー・ファイルと調整キュー・マネージャー・ディレクトリーを作成します。

重要:
[UNIX、Linux、Windows] UNIX, Linux®, and Windows システムで、 サーバーのインストールイメージを使用している場合、コマンドを実行するには、次の2つの条件を両方とも満たす必要があります。 IBM® MQ
  • IBM MQ の管理者になる。
  • mqm グループのメンバーである (システムに mqm グループが定義されている場合)。
そうでない場合は、エラーメッセージが表示されます。BFGCL0502E: You are not authorized to perform the requested operationこの制限は、 Redistributable Managed File Transfer Agent アーカイブを使用している場合は適用されません。
[z/OS] z/OS® システムでは、コマンドを実行するには、これらの条件のうち少なくとも1つを満たす必要があります
  • mqm グループのメンバーである (システムに mqm グループが定義されている場合)。
  • BFG_GROUP_NAME環境変数で指定されたグループのメンバーになる(グループが指定されている場合)。
  • コマンドを実行する際に、BFG_GROUP_NAME環境変数に値が設定されていない。

目的

fteSetupCoordination コマンドを使用して、以下の Managed File Transfer オブジェクトを作成します。
  • 調整キュー・マネージャーのディレクトリー
  • データ・ディレクトリー mqft (存在しない場合)
  • installation.properties file
  • coordination.properties file
このコマンドは、 Managed File Transferを構成するために調整キュー・マネージャーに対して実行する必要がある以下の MQSC コマンドも提供します。 MQSC コマンドは、トピック、トピック・ストリング、SYSTEM.FTE キュー、およびデフォルト・データベース・ロガーのキューを作成します。 また、これらのコマンドは名前リストを更新して、調整キュー・マネージャーの PSMODE 属性を ENABLED に設定します。
[z/OS]コーディネーションキューマネージャが z/OS にある場合、これらのMQSCコマンドを実行する前に、以下の必須オブジェクトがすでに存在していることを確認する必要があります
  • SYSTEM.BROKER.DEFAULT.STREAM キュー
  • SYSTEM.QPUBSUB.QUEUE.NAMELIST 名前リスト
  • SYSTEM.BROKER.DEFAULT.STREAM および SYSTEM.BROKER.ADMIN.STREAM ストリーム
DEFINE TOPIC('SYSTEM.FTE') TOPICSTR('SYSTEM.FTE') REPLACE
ALTER TOPIC('SYSTEM.FTE') NPMSGDLV(ALLAVAIL) PMSGDLV(ALLAVAIL)
DEFINE QLOCAL(SYSTEM.FTE) LIKE(SYSTEM.BROKER.DEFAULT.STREAM) REPLACE
ALTER QLOCAL(SYSTEM.FTE) DESCR('Stream for WMQFTE Pub/Sub interface')
* Altering namelist: SYSTEM.QPUBSUB.QUEUE.NAMELIST
* Value prior to alteration:
DISPLAY NAMELIST(SYSTEM.QPUBSUB.QUEUE.NAMELIST)
ALTER NAMELIST(SYSTEM.QPUBSUB.QUEUE.NAMELIST) +
 NAMES(SYSTEM.BROKER.DEFAULT.STREAM+
 ,SYSTEM.BROKER.ADMIN.STREAM,SYSTEM.FTE)
* Altering PSMODE.  Value prior to alteration:
DISPLAY QMGR PSMODE
ALTER QMGR PSMODE(ENABLED)

プロパティー・ファイルについて詳しくは、 構成オプションを参照してください。

[z/OS] z/OS を使用している場合は、 コマンドテンプレートPDSEライブラリデータセットから生成されたスクリプトを使用して、JCLから コマンドやその他のコマンドを発行することができます。 Managed File Transfer fteSetupCoordination 詳しくは、 MFT エージェントまたはロガーのコマンド・データ・セットの作成を参照してください。

Syntax

fteSetupCoordination

Read syntax diagramSkip visual syntax diagramfteSetupCoordination -coordinationQMgr  coordination_qmgr_name -coordinationQMgrHost coordination_qmgr_host -coordinationQMgrPort coordination_qmgr_port -coordinationQMgrChannel coordination_qmgr_channel -credentialsFilefilePath-useridusername-f-default

パラメーター

--coordinationQMgr(coordination_qmgr_name)
必須。 調整キュー・マネージャーの名前。 このキュー・マネージャーは、 IBM WebSphere® MQ 7.0 以降のキュー・マネージャーでなければなりません。

--coordinationQMgrHost(coordination_qmgr_host)
オプション。 調整キュー・マネージャーのホスト名または IP アドレス。

-coordinationQMgrHostパラメーターを指定しない場合、バインディング・モード接続が想定されます。

-coordinationQMgrHostパラメーターに値を指定し、-coordinationQMgrPortパラメーターと-coordinationQMgrChannelパラメーターには値を指定しない場合、ポート番号 1414 とチャネル SYSTEM.DEF.SVRCONN がデフォルトで使用されます。

--coordinationQMgrPort(coordination_qmgr_port
オプション。 調整キュー・マネージャーとのクライアント接続で使用されるポート番号。 -coordinationQMgrPortパラメーターを指定する場合は、-coordinationQMgrHostパラメーターも指定する必要があります。

--coordinationQMgrChannel(coordination_qmgr_channel
オプション。 調整キュー・マネージャーとの接続に使用されるチャネル名。 -coordinationQMgrChannelパラメーターを指定する場合は、-coordinationQMgrHostパラメーターも指定する必要があります。

-credentialsFile (filePath)
オプション。 IBM MQ 認証の詳細が追加される既存または新規の資格情報ファイルの絶対ファイル・パス。

このコマンドは、指定されたManaged File Transfer資格情報ファイルへの一連のIBM MQ認証詳細の追加をサポートします。 このコマンドは、 IBM MQ 接続認証が有効になっている場合に使用します。 既存の詳細を更新する場合は、-fforce パラメーターを使用する必要があります。

-userid (ユーザー名)
オプション。 資格情報の詳細を関連付けるために使用するユーザー ID。 ユーザー ID を指定しない場合、資格情報の詳細はすべてのユーザーに適用されます。 -credentialsFileパラメーターも指定する必要があります。
-f
オプション。 既存の調整キュー・マネージャー構成を、このコマンドで指定された詳細で強制的に上書きします。

-デフォルト
オプション。 デフォルト構成オプションを、このコマンドで指定された調整キュー・マネージャーに関連付けられているオプションに更新します。
  • このパラメータを指定した場合、既存のキューマネージャがデフォルトの調整キューマネージャになります。 すべての Managed File Transfer コマンドは、 fteSetupCommands コマンドの -p パラメータを使用してコンフィギュレーション・オプションを設定する必要なく、これを使用する。
  • このパラメータを指定しない場合でも、キューマネージャは設定されますが、 調整キューマネージャを必要とするすべての Managed File Transfer コマンドについて、 fteSetupCommands コマンドの -p パラメータを使用して設定オプションを指定する必要があります。
詳細については、 -p configuration_optionsを参照のこと。
- ? または -h
オプション。 コマンド構文を表示します。

以下の例では、必要なオブジェクトが、クライアント・モードで接続される QM_SATURN という調整キュー・マネージャー用にセットアップされます。
fteSetupCoordination -coordinationQMgr QM_SATURN
-coordinationQMgrHost myhost.ibm.com -coordinationQMgrPort 1415
-coordinationQMgrChannel SYSTEM.DEF.SVRCONN

戻りコード

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