構成マネージャー・プロキシー API を使用したデプロイメントの結果の検査

構成マネージャー・プロキシー・アプリケーションを使用している場合は、以下のようなコードを使用して、パブリッシュ/サブスクライブ・トポロジー・デプロイメント操作の結果を調べることができます。
TopologyProxy t = cmp.getTopology();

boolean isDelta = true;
long timeToWaitMs = 10000;
DeployResult dr = topology.deploy(isDelta, timeToWaitMs);

System.out.println("Overall result = "+dr.getCompletionCode());

// Display overall log messages
Enumeration logEntries = dr.getLogEntries();
while (logEntries.hasMoreElements()) {
  LogEntry le = (LogEntry)logEntries.nextElement();
  System.out.println("General message: " + le.getDetail());
}

// Display broker specific information
Enumeration e = dr.getDeployedBrokers();
while (e.hasMoreElements()) {

  // Discover the broker
  BrokerProxy b = (BrokerProxy)e.nextElement();

  // Completion code for broker
  System.out.println("Result for broker "+b+" = " +
    dr.getCompletionCodeForBroker(b));

  // Log entries for broker
  Enumeration e2 = dr.getLotEntriesForBroker(b);
  while (e2.hasMoreElements()) {
    LogEntry le = (LogEntry)e2.nextElement();
    System.out.println("Log message for broker " + b +
      le.getDetail()));
  }
}
deploy メソッドは、影響のあるすべてのブローカーがデプロイメント要求に対して応答するまで、他のプロセスをブロックします。

このメソッドが戻される場合、その時点で DeployResult はデプロイメントの結果を表します。構成マネージャー・プロキシーによってオブジェクトは更新されません。

デプロイメント・メッセージを構成マネージャーに送信できない場合、デプロイメント時に ConfigManagerProxyLoggedException 例外がスローされます。構成マネージャーがデプロイメント・メッセージを受け取る場合、デプロイメント全体のログ・メッセージが表示され、デプロイメントの影響を受けた各ブローカーに固有の完了コードが示されます。 完了コードは、CompletionCodeType クラスからの以下のいずれかの静的インスタンスとなります。

完了コード 説明
pending デプロイメントはバッチ内で保留され、ConfigManagerProxy.sendUpdates() を発行するまで送信されません。
submitted デプロイ・メッセージは構成マネージャーに送信されましたが、タイムアウト期間が満了する前に応答が受信されませんでした。
initiated 構成マネージャーによりデプロイメントが開始されたことが示されましたが、タイムアウト期間が満了する前にブローカー応答が受信されませんでした。
successSoFar 構成マネージャーによりデプロイメントが開始されたことが示され、一部のブローカー (すべてではない) が、タイムアウト期間が満了する前に正常に応答しました。 否定応答したブローカーはありません。
success 構成マネージャーによりデプロイメントが開始されたことが示され、すべてのブローカーが、タイムアウト期間が満了する前に正常に応答しました。
failure 構成マネージャーによりデプロイメントが開始されたことが示され、少なくとも 1 つのブローカーが否定応答しました。 DeployResult クラスの getLogEntriesForBroker メソッドを使用して、デプロイメントの失敗に関するさらに詳細な情報を入手できます。 このメソッドは、使用可能な LogEntry オブジェクトの列挙を戻します。
notRequired 構成マネージャーに実行依頼されたデプロイメント要求は、ブローカーの構成が既に最新になっているため、送信されませんでした。
関連概念
デプロイメントの概要
構成マネージャー・プロキシー
関連タスク
デプロイ
ブローカー・ドメイン・ログ情報の表示
構成マネージャー・プロキシーのトレース
メッセージ・フローまたはメッセージ・セットのデプロイ時の問題の解決
構成マネージャー・プロキシーのアプリケーションを開発する際の問題の解決
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
最終更新 : 2009-02-20 12:43:47

af35130_