ExceptionList ツリー

ExceptionList ツリーは、メッセージ・フローがメッセージを処理する際に発生する例外に関する情報を書き込む、論理メッセージ・ツリーの一部です。

ExceptionList ツリーのルートは ExceptionList と呼ばれ、ツリーはゼロ個以上の例外記述のセットから構成されます。 ExceptionList ツリーは、例外が発生した場合に、メッセージ・フローによって移植されます。 メッセージ・フローの処理中に例外条件が発生しない場合には、そのメッセージに関連した例外リストは、ルート・エレメントのみから構成されます。 これは、実際には、例外の空のリストです。

ExceptionList ツリーは、例外の発生後にメッセージを受信する、 メッセージ・フロー内の他のノードがアクセスすることができます。 その内容は、Compute ノードでのみ変更することができます。

例外条件が発生した場合、メッセージ処理は中断され、例外がスローされます。 制御は高位、つまりエンクロージング・キャッチ・ブロックに戻されます。 障害条件を記述する ExceptionList が作成され、 メッセージ全体が LocalEnvironment および新たに移植された ExceptionList と共に、 例外処理メッセージ・フロー・パスを介して伝搬します。

ExceptionList の子は常に RecoverableException です。 ある環境では複数生成されることがありますが、このルートの子は、通常は 1 つだけです。 ExceptionList の子には、多数の子が含まれており、 その最後のものは、例外のタイプに特定の詳細情報を提供します。例外のタイプは、以下のいずれか 1 つです。

以下に、RecoverableException の例外リスト・ツリーの構造を示します。



例外記述構造は、ExceptionList ツリーを生成するために、反復やネストが可能です。 このツリーでは、

ツリー内の子は、例外の詳細を与える、多数の名前値エレメント、およびその名前が Insert である、ゼロ個以上の名前エレメントの形式を取ります。 名前値エレメントで識別される、NLS (各国語サポート) メッセージ番号は、WebSphere Business Integration Message Broker エラー・メッセージを識別します。 Insert 値を使用して、このメッセージ内の変数を置換し、例外の原因の詳細を提供します。

上の図に示された例外リスト内の名前値エレメントを、下記の表で説明します。

氏名 タイプ 説明
File1 ストリング C++ ソース・ファイル名
Line1 整数 C++ ソース・ファイル行番号
Function1 ストリング C++ ソース関数名
Type2 ストリング ソース・オブジェクト・タイプ
Name2 ストリング ソース・オブジェクト名
Label2 ストリング ソース・オブジェクト・ラベル
Text1 ストリング 追加テキスト
Catalog3 ストリング NLS メッセージ・カタログ名4
Severity3 整数

1 = 通知
2 = 警告
3 = エラー

Number3 整数 NLS メッセージ番号4
Insert3 タイプ 整数 値のデータ・タイプ

0 = 不明
1 = ブール
2 = 整数
3 = 浮動小数
4 = 10 進数
5 = 文字
6 = 時刻
7 = GMT 時刻
8 = 日付
9 = タイム・スタンプ
10 = GMT タイム・スタンプ
11 = 間隔
12 = BLOB
13 = ビット配列
14 = ポインター

テキスト ストリング データ値
Notes:
  1. File、Line、Function、および Text エレメントは、例外処理の意思決定には使用しないでください。 これらのエレメントは、IBM サービス技術員によって使用されるログに、情報が確実に書き込めるようにします。
  2. Type、Name、および Label エレメントは、 例外条件の発生時にメッセージを処理していたオブジェクトを定義します (通常はメッセージ・フロー・ノード)。
  3. Catalog、Severity、および Number エレメントは、NLS メッセージを定義します。 示された 2 つの名前値エレメントを含む Insert エレメントは、その NLS メッセージへの挿入を定義します。
  4. NLS メッセージ・カタログ名および NLS メッセージ番号は、 変換可能なメッセージ・カタログおよびメッセージ番号を参照します。

メッセージ・フロー処理が完了すると、ExceptionList ツリーは廃棄されます。

関連概念
メッセージ・フロー
例外後のツリー内容
メッセージのモデル化

関連タスク
メッセージ・フロー・アプリケーションの開発
メッセージ・フローのエラー処理
ExceptionList ツリーへのアクセス
例外の送出

関連資料
組み込みノード
Compute ノード