fteSetupCoordination (プロパティー・ファイルおよび調整キュー・マネージャー・ディレクトリーのセットアップ)
fteSetupCoordination コマンドは、 Managed File Transferのプロパティー・ファイルと調整キュー・マネージャー・ディレクトリーを作成します。
重要:
UNIX, Linux®, and Windows システムで、 サーバーのインストールイメージを使用している場合、コマンドを実行するには、次の2つの条件を両方とも満たす必要があります。 IBM® MQ
z/OS® システムでは、コマンドを実行するには、これらの条件のうち少なくとも1つを満たす必要があります
UNIX, Linux®, and Windows システムで、 サーバーのインストールイメージを使用している場合、コマンドを実行するには、次の2つの条件を両方とも満たす必要があります。 IBM® MQ - IBM MQ の管理者になる。
- mqm グループのメンバーである (システムに mqm グループが定義されている場合)。
z/OS® システムでは、コマンドを実行するには、これらの条件のうち少なくとも1つを満たす必要があります- mqm グループのメンバーである (システムに mqm グループが定義されている場合)。
- BFG_GROUP_NAME環境変数で指定されたグループのメンバーになる(グループが指定されている場合)。
- コマンドを実行する際に、BFG_GROUP_NAME環境変数に値が設定されていない。
目的
fteSetupCoordination コマンドを使用して、以下の Managed File Transfer オブジェクトを作成します。
- 調整キュー・マネージャーのディレクトリー
- データ・ディレクトリー mqft (存在しない場合)
- installation.properties file
- coordination.properties file
コーディネーションキューマネージャが 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 を使用している場合は、 コマンドテンプレートPDSEライブラリデータセットから生成されたスクリプトを使用して、JCLから コマンドやその他のコマンドを発行することができます。 Managed File Transfer fteSetupCoordination 詳しくは、 MFT エージェントまたはロガーのコマンド・データ・セットの作成を参照してください。
Syntax
パラメーター
- --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
- オプション。 既存の調整キュー・マネージャー構成を、このコマンドで指定された詳細で強制的に上書きします。
- -デフォルト
- オプション。 デフォルト構成オプションを、このコマンドで指定された調整キュー・マネージャーに関連付けられているオプションに更新します。
- - ? または -h
- オプション。 コマンド構文を表示します。
例
以下の例では、必要なオブジェクトが、クライアント・モードで接続される QM_SATURN という調整キュー・マネージャー用にセットアップされます。fteSetupCoordination -coordinationQMgr QM_SATURN
-coordinationQMgrHost myhost.ibm.com -coordinationQMgrPort 1415
-coordinationQMgrChannel SYSTEM.DEF.SVRCONN戻りコード
- 0
- コマンドは正常に完了しました。
- 1
- コマンドは失敗しました。
