Throw ノード

メッセージ・フローで例外をスローするには、Throw ノードを使用します。

このトピックには、以下のセクションが含まれています。

目的

例外は以下によりキャッチされて、処理されます。

  • 前にある TryCatch ノード
  • メッセージ・フロー入力ノード (たとえば、組み込みノード HTTPInput および MQInput は Catch ターミナルを持っています)
  • 前にある AggregateReply ノード

メッセージの内容に予期しないデータが含まれている場合に、 メッセージ・フローを通してエラー・パスを強制する Throw ノードを組み込みます。 例えば、メッセージに特定のフィールドが含まれていない場合にメッセージをバックアウトするために、 フィールドが存在することを (Filter ノードを使用して) 確認することができます。フィールドが存在しない場合には、 メッセージは、メッセージ内の ExceptionList サブツリーの例外に関する詳細を記録する Throw ノードに渡されます。

Throw ノードはパレットの「構造」ドロワーに含まれていて、ワークベンチ内では次のアイコンによって表されます。

Throw ノード・アイコン

メッセージ・フロー内でのこのノードの使用

このノードが使用される方法に関しては、次のサンプルを参照してください。 サンプルは、Message Brokers Toolkit と統合されているインフォメーション・センターを使用する場合にのみ表示できます。

メッセージ・フローに Throw ノードを TryCatch ノードと共に組み込み、 エラーが発生する可能性のある状態についてシステム管理者に警告するようにします。 たとえば、数を計算する Compute ノードがある場合、この計算の結果をテストして、結果が特定の数値を超える場合に例外をスローします。 TryCatch ノードはこの例外をキャッチして、エラーを処理するノードのシーケンスにメッセージを伝搬します。

ターミナルおよびプロパティー

Throw ノードのインスタンスをメッセージ・フローに入れると、それを構成することができます。メッセージ・フロー・ノードの構成を参照してください。 ノードのプロパティーが、「プロパティー」ビューに表示されます。ノードのプロパティーを「プロパティー」ダイアログに表示するには、ノードをダブルクリックするか、またはノードを右クリックしてから「プロパティー」をクリックします。 値を入力する必要のある (デフォルト値が定義されていない) すべての必須プロパティーには、アスタリスクが表示されます。

Throw ノードのターミナルについては、次の表に説明されています。

ターミナル 説明
In ノードが処理するメッセージを受け入れる入力ターミナル。

以下の表は、ノード・プロパティーについて説明しています。 M の見出しの列は、プロパティーが必須 かどうかを示します (デフォルトが定義されていない場合に値を入力することが必要なら、アスタリスクのマークが付きます)。 C の見出しの列は、プロパティーが構成可能 かどうかを示します (メッセージ・フローを BAR ファイルに追加してデプロイするとき、値を変更できます)。

Throw ノードの「説明」プロパティーについては、次の表に説明されています。

プロパティー M C デフォルト 説明
ノード名 いいえ いいえ ノード・タイプ: Throw ノードの名前。
簡略説明 いいえ いいえ   ノードの簡単な説明
詳細説明 いいえ いいえ   メッセージ・フロー内のノードの目的を説明するテキスト

Throw ノードの「基本」プロパティーについては、次の表に説明されています。

プロパティー M C デフォルト 説明
メッセージ・カタログ いいえ いいえ   例外のエラー番号のエラー・テキストを取り出す元のメッセージ・カタログの名前。メッセージ送信元が含まれるメッセージ・カタログの完全修飾パスおよびファイル名を入力します。 独自のメッセージ・カタログ、または WebSphere® Message Broker で提供されるデフォルトのメッセージ・カタログをこのファイルとして使用できます。 デフォルト提供のカタログを使用するには、このプロパティーをブランクのままにします。
メッセージ番号 いいえ いいえ 3001 スローされる例外のエラー番号。
  • 独自のメッセージ・カタログを作成した場合は、この例外がスローされる時に使用したいカタログ内のメッセージの番号を入力します。
  • デフォルトのメッセージ・カタログを使用する場合は、3001 (デフォルト) から 3049 の範囲内の番号を指定してください。 これらの番号は、使用できるようにデフォルトのカタログで予約されています。 これらの各デフォルト・メッセージ・カタログのテキストは同一ですが、例外をスローする各状態ごとにこの範囲内の番号を使用することができます。 この番号を使用して、エラーの正確な原因を特定します。
メッセージ・テキスト いいえ いいえ   エラーの原因を説明する追加のテキスト。ローカル・エラー・ログに出力する際にメッセージと共に組み込む情報を含めた追加のテキストを自由形式で入力します。例えば、メッセージに特定のフィールドが含まれているかどうかを調べ、そのフィールドが見つからなかったときに例外をスローする場合は、以下のテキストを含めることができます。
メッセージに必須フィールド: 支店番号が含まれていませんでした
デフォルトのメッセージ・カタログを使用している場合には、メッセージ・テキストにこのテキストが &1 のように挿入されます。
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

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

ac04830_