ExceptionList ツリー

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

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

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

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

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

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



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

ツリー内の子は、例外の詳細を与える多数の名前値エレメント、および Insert という名前のゼロ個以上の名前エレメントの形式を取ります。 名前値エレメントで識別される、NLS (各国語サポート) メッセージ番号は、WebSphere 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 = ポインター

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

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

関連概念
メッセージ・フローの概要
例外後のツリー内容
メッセージのモデル化
Java の記述
関連タスク
メッセージ・フローの開発
メッセージ・フローのエラー処理
ExceptionList ツリーへのアクセス
例外のスロー
ESQL の作成
関連資料
組み込みノード
Compute ノード
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック
Copyright IBM Corporation 1999, 2005 Last updated: 11/07/2005
ac00540_