mqsiapplybaroverride コマンドを使用して、ブローカー・アーカイブ (BAR) デプロイメント記述子の構成可能値を、プロパティー・ファイルで指定した新しい値に置き換えます。
mqsireadbar コマンドは、mqsiapplybaroverride コマンドで構成できるプロパティーを確認するために使用します。
mqsiapplybaroverride コマンドと mqsicreatebar コマンドを併用することにより、BAR ファイルを作成するスクリプトを記述したり、ブローカー・デプロイメント記述子アーカイブ・ファイルに異なるオーバーライド値を適用したりすることができます。メッセージ・フロー・ノード・プロパティーのリストと、それに対応する mqsiapplybaroverride コマンド・プロパティーについては、構成可能プロパティーを参照してください。 mqsiapplybaroverride コマンドのプロパティーについては、影響を受ける各ノードの参照トピックにあるプロパティー表にもリストされています。
このパラメーターと –p (オーバーライド・ファイル) および –m (手動オーバーライド) パラメーターを一緒に使用して、BAR ファイルの特定のアプリケーションでオーバーライドのターゲットを指定できます。–p パラメーターで指定したオーバーライド・ファイルが BAR ファイルの場合、–k パラメーターを指定すると、アプリケーションとそのすべてのライブラリーのデプロイ記述子が、ソース BAR ファイルに基づいて更新されます。–p パラメーターで指定したオーバーライド・ファイルがデプロイ記述子の場合、–k パラメーターを指定すると、アプリケーションのデプロイ記述子だけが更新されます。–m パラメーターと –k パラメーターを両方設定すると、指定のアプリケーションに手動オーバーライドが適用されます。
アプリケーション内の特定のライブラリーにオーバーライドを適用するには、–k パラメーターと –y (ライブラリー名) パラメーターを併用します。
-k パラメーターを指定しないで、-p パラメーターで指定したファイルがアプリケーションを含む BAR ファイルの場合、ターゲット BAR ファイルに同じアプリケーションがあると、ターゲット BAR ファイルのデプロイ記述子がソース BAR ファイルに基づいて更新されます。
<?xml version="1.0" encoding="UTF-8"?>
その場合は、以下のように変更します。<?xml version="1.0"?>
-p パラメーターで指定したファイルが、アプリケーションまたはライブラリーを含む BAR ファイルの場合、-k パラメーターと -y パラメーターのどちらも設定しないと、ターゲット BAR ファイルに同じアプリケーションまたはライブラリーがある場合には、ターゲット BAR ファイルのデプロイ記述子がソース BAR ファイルに基づいて更新されます。
このパラメーターと –p (オーバーライド・ファイル) および –m (手動オーバーライド) パラメーターを一緒に使用して、BAR ファイルの特定のライブラリーでオーバーライドのターゲットを指定できます。–p パラメーターで指定したオーバーライド・ファイルが BAR ファイルの場合、–y パラメーターを指定すると、ライブラリーのデプロイ記述子が、ソース BAR ファイルに基づいて更新されます。–p パラメーターで指定したオーバーライド・ファイルがデプロイ記述子の場合、–y パラメーターを設定すると、ライブラリーのデプロイ記述子だけが更新されます。–m パラメーターと –y パラメーターを両方設定すると、指定のライブラリーに手動オーバーライドが適用されます。
アプリケーション内の特定のライブラリーにオーバーライドを適用するには、–y パラメーターと –k (アプリケーション名) パラメーターを併用します。
-y パラメーターを指定しないで、-p パラメーターで指定したファイルがライブラリーを含む BAR ファイルの場合、ターゲット BAR ファイルに同じライブラリーがあると、ターゲット BAR ファイルのデプロイ記述子がソース BAR ファイルに基づいて更新されます。
すべてのケースで、BAR ファイル内の既存のデプロイメント記述子は META-INF¥broker.xml.old に名前変更され、その名前の既存ファイルがあれば置き換えられます。
BIP1138I: Overriding BAR File using runtime mqsiapplybaroverride
特権が付与された環境からコマンドを実行しないと、継続するかどうかの確認が表示されます。「OK」をクリックすると、新しく特権を付与されたコマンド・コンソールが作成されてコマンドが完了しますが、この特権が付与された環境にすべての応答が書き込まれ、コマンドが完了してコンソールが閉じるとすべての応答は失われます。
すべてのオペレーティング・システムで、このコマンドを呼び出すのに使用するユーザー ID には、ローカル・システム上の BAR ファイルに書き込む権限がなければなりません。
このコマンドはバッチ・ファイルとして指定されています。
コマンドを自動化システムで、またはスクリプトから実行している場合、次のように Windows CALL コマンドを使用して、正しい ERRORLEVEL が戻されるかを確認してください。...
CALL mqsiapplybaroverride
...
mqsiapplybaroverride -b myflow.bar -p mychanges.properties
mqsiapplybaroverride -b myflow.bar -p myOriginalBarFile.bar
mqsiapplybaroverride -b myflow.bar -k application1 -p myOriginalBarFile.bar
mqsiapplybaroverride -b myflow.bar -k application1 -y library1 -p myOtherBroker.xml
mqsiapplybaroverride -b c:¥test.bar -p c:¥my.properties
mqsiapplybaroverride –b c:¥test.bar –p c:¥previous.bar
mqsiapplybaroverride –b c:¥test.bar –p c:¥broker.xml
mqsiapplybaroverride –b c:\test.bar –m OLDA=NEWA,OLDB=NEWB
mqsiapplybaroverride –b c:\test.bar –m sampleFlow#MQInput.queueName=NEWC
プロパティー・ファイルに含まれている詳細情報の例については、構成可能プロパティーの編集を参照してください。