WebSphere Message Broker バージョン 8.0.0.5 オペレーティング・システム: AIX、HP-Itanium、Linux、Solaris、Windows、z/OS

製品の最新バージョンについては、IBM Integration Bus バージョン 9.0 をご覧ください。

TimeoutNotification ノード

タイムアウトに依存するメッセージ・フローを管理するには、TimeoutNotification ノードを使用します。

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

目的

TimeoutNotification ノードは、以下の 2 つの方法で使用可能な入力ノードです。

  • TimeoutNotification ノードは、1 つ以上の TimeoutControl ノードと対にすることができます。

    TimeoutNotification ノードは、 対になっている TimeoutControl ノードによって送信された タイムアウト要求メッセージを処理して、メッセージ (または選択されたメッセージのフラグメント) の コピーをメッセージ・フロー内の次のノードに伝搬します。

  • TimeoutNotification ノードは、スタンドアロン・ノードとして使用できます。

    生成されるメッセージは、このノードの構成に指定された時間間隔でメッセージ・フロー内の次のノードに伝搬されます。

TimeoutNotification ノードはパレットの「タイマー」ドロワーに含まれていて、WebSphere® Message Broker Toolkit 内では次のアイコンによって表されます。

Timeout Notification ノード・アイコン

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

イベントが特定の時期にまたは一定の間隔で生じるようにする必要のあるアプリケーションでは、 TimeoutControl ノードと TimeoutNotification ノードをメッセージ・フロー内で一緒に使用します。 例えば、バッチ・ジョブを毎日深夜に実行する場合や、通貨の為替レートに関する情報を 1 時間ごとに銀行に送信する場合などです。

複数の TimeoutControl ノードを 1 つの TimeoutNotification ノードと一緒に使用できます。 そのような複数の TimeoutControl ノードによって開始されたタイムアウト要求は、同じ固有 IDTimeoutNotification ノードおよび各 TimeoutControl ノードに対して使用されている場合、 同一の TimeoutNotification ノードによってすべて処理されます。 ただし、複数の TimeoutNotification ノードに同じ固有 ID 使用しないでください。

変更の始まり以下の条件を満たしている場合にのみ、TimeoutControl ノードを、別のメッセージ・フローにある TimeoutNotification ノードと共に使用できます。
  • 同じ固有 IDTimeoutNotification ノードと各 TimeoutControl ノードに使用されている。
  • TimeoutControl ノードを含むメッセージ・フローと、TimeoutNotification ノードを含むメッセージ・フローが同じ実行グループにデプロイされている。
変更の終わり

タイムアウト要求メッセージは、TimeoutNotification ノードによって使用されるキューでの処理のために保管されます。 デフォルトでは、このキューは SYSTEM.BROKER.TIMEOUT.QUEUE です。 ただし、Timer 構成可能サービスを使用して、代わりのタイムアウト・キューを指定することができ、そうすればメッセージの保管に関する制御範囲が広がります。 代わりのタイムアウト・キューの使用について詳しくは、タイムアウト・ノードに関するイベントのストレージの構成を参照してください。

ブローカーが開始された結果として、またはノードの含まれているメッセージ・フローが開始することによって、 TimeoutNotification ノードが開始されるとき、 それはその内部タイムアウト・ストアをスキャンして、非持続タイムアウト要求をすべてパージします。 経過済みであり、IgnoreMissed プロパティーが「False」に設定された持続タイムアウト要求に対しては、通知が発行されます。

TimeoutNotification ノードを使用して、MQOutput ノードなどの出力ノードに対して WebSphere MQ メッセージを生成する場合は、有効な MQMD を指定してください。 また、TimeoutNotification ノードが (スタンドアロン・ノードとして) 自動モードで実行されている場合も、有効な MQMD を指定する必要があります。 TimeoutNotification ノードが「制御」モードで実行している場合 (つまり、1 つ以上の TimeoutControl ノードと対になっている場合)、 保管されたメッセージにまだ MQMD がない場合に限り、有効な MQMD を指定する必要があります。 以下の ESQL は、有効な MQMD を指定する方法を示しています。
CREATE NEXTSIBLING OF OutputRoot.Properties DOMAIN 'MQMD';
SET OutputRoot.MQMD.Version = MQMD_CURRENT_VERSION;
SET OutputRoot.MQMD.Format = 'XML';
タイムアウト処理ノードの使用法の詳細については、以下のサンプルを参照してください。

サンプルに関する情報は、WebSphere Message Broker Toolkit に統合されているインフォメーション・センター、またはオンライン・インフォメーション・センターを使用する場合にのみ表示できます。 サンプルは、WebSphere Message Broker Toolkit に統合されているインフォメーション・センターを使用する場合にのみ実行できます。

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

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

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

ターミナル 説明
Failure このノード内の処理で障害が検出された場合に、メッセージが伝搬される出力ターミナル。 ノードをこのターミナルに接続して、これらの障害を処理することができます。 このターミナルが他のノードに接続されていない場合、メッセージは伝搬されません。 また、データのロギングまたは安全な保管は生じません。
Out タイムアウトの満了後に、メッセージが伝搬される出力ターミナル。
  • TimeoutNotification ノードが「自動」モードで実行している (つまり、 このノードと対になっている TimeoutControl ノードがない) 場合、 伝搬されるメッセージには「プロパティー」フォルダーだけが含まれて、 LocalEnvironment にはタイムアウト情報のデータが取り込まれます。
  • TimeoutNotification ノードが「制御」モードで実行している (つまり、 このノードと対になっている TimeoutControl ノードがタイムアウト要求を保管している) 場合、 伝搬されるメッセージには TimeoutControl ノードによって保管されたものが含まれます。 これは要求メッセージの全体、またはその断片であることがあります。
TimeoutNotification ノードが WebSphere MQ メッセージを (MQOutput ノードを使用するなどして) 生成するメッセージ・フローへの入力ノードとして使用される場合、 そのメッセージ・フローは必要な MQ ヘッダーおよびデータ (MQMD など) を作成する必要があります。
Catch 例外がダウンストリームでスローされた場合にメッセージが伝搬される出力ターミナル。 このターミナルが他のノードに接続されていない場合、以下のイベントが生じます。
  1. TimeoutNotification ノードはエラーをローカル・エラー・ログに書き込みます。
  2. TimeoutNotification ノードは、例外を生じさせた問題が解決するまで要求の処理を繰り返し試行します。

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

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

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

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

プロパティー M C デフォルト 説明 mqsiapplybaroverride コマンド・プロパティー
固有 ID はい はい なし このプロパティーは、ブローカー内で固有であり、このノードと組み合された TimeoutControl ノード (存在する場合) に指定された ID と同じ値を指定します。 この ID の最大長は 12 文字です。

さらにこの名前は、ノードによって使用される Timer 構成可能サービス (存在する場合) を識別するために使用されます。

複数の TimeoutNotification ノードで同じ固有 ID を使用しないでください。

uniqueIdentifier
トランザクション・モード いいえ いいえ はい ノードのトランザクション・モードです。 トランザクション・モードが「自動」の場合、 トランザクションは、対になっている TimeoutControl ノードの「要求の持続性」プロパティーによって制御される保管されたメッセージのタイムアウト要求の持続性を基にします。 このプロパティーを以下の値のうちの 1 つに設定することができます。
  • トランザクションを開始する場合には、「はい」を選択します。
  • トランザクションを開始しない場合には、「いいえ」を選択します。
  • 「動作モード」「制御」に設定した場合に限り、「自動」を選択します。 トランザクションが開始されるかどうかは、保管されたタイムアウト要求の持続性に依存します。 これは、対になっている TimeoutControl ノード内の「要求の持続性」の 値によって制御されます。
 
動作モード いいえ いいえ 自動 このプロパティーは、このノードが組み合されている TimeoutControl ノードと対になっているかどうかを示します。 有効な値は以下のとおりです。
  • 「自動」を選択する場合、ノードは TimeoutControl ノードと対になっていません。 ノードは、「タイムアウト値」 (正整数でなければなりません) プロパティーの設定値によって間隔が制御されるタイムアウト要求を生成します。
  • 「制御」を選択する場合、ノードは、対になっている TimeoutControl ノードによって保管されたすべてのタイムアウト要求を処理します。
 
タイムアウト間隔 いいえ はい 1 タイムアウト要求の間隔 (秒数)。 このプロパティーが関係するのは、「動作モード」「自動」に設定されている場合だけです。

このプロパティーの値は、正整数でなければなりません。

「動作モード」「自動」に設定されている場合は、「タイムアウト間隔」プロパティーの値は、タイマー構成可能サービス内の「タイムアウト間隔」プロパティー (設定されている場合) によって指定変更されます。

timeoutInterval

TimeoutNotification ノードのパーサー・オプションのプロパティーについては、次の表に説明されています。

プロパティー M C デフォルト 説明
構文解析のタイミング いいえ いいえ 要求時 このプロパティーは、タイムアウト・メッセージをいつ解析するかを制御します。 有効な値は、「要求時」「即時」、および「完全」です。

デフォルトでは、このプロパティーは「要求時」 に設定されます。これにより、メッセージの構文解析が遅延されます。 メッセージが即時に解析されるようにするには、要求時の構文解析を参照してください。

XML スキーマ・データ・タイプを使用してツリーを構築する いいえ いいえ 選択されていない このプロパティーは、XML スキーマから取得されたデータ・タイプを使って、XMLNSC パーサーがメッセージ・ツリー内に構文エレメントを作成するかどうかを制御します。 「妥当性検査」タブ上の「妥当性検査」プロパティーを「内容」 または 「内容と値」 に設定した場合にのみ、このプロパティーを選択できます。
MQRFH2C コンパクト・パーサーを MQRFH2 ドメインに使用 いいえ いいえ 選択されていない このプロパティーは、MQRFH2 パーサーの代わりに、MQRFH2C コンパクト・パーサーを MQRFH2 ヘッダーに使用するかどうかを制御します。
XMLNSC コンパクト・パーサーを XMLNS ドメインに使用 いいえ いいえ 選択されていない このプロパティーは、XMLNS ドメイン内のメッセージに XMLNSC コンパクト・パーサーを使用するかどうかを制御します。 このプロパティーを設定すると、入力 RFH2 ヘッダーまたはデフォルト・プロパティー・ドメインが XMLNS の場合、出力ターミナルに接続されているノードの XMLNSC の下にメッセージ・データが表示されます。
混合内容の保存 いいえ いいえ なし このプロパティーは、XMLNSC パーサーがタイムアウト・メッセージ内で混合テキストを検出したときに、メッセージ・ツリー内にエレメントを作成するかどうかを制御します。 チェック・ボックスを選択すると、混合テキスト用のエレメントが作成されます。 このチェック・ボックスのチェックを外した場合、混合テキストは無視されて、エレメントは作成されません。
コメントの保存 いいえ いいえ なし このプロパティーは、XMLNSC パーサーがタイムアウト・メッセージ内でコメントを検出したときに、メッセージ・ツリー内にエレメントを作成するかどうかを制御します。 チェック・ボックスを選択すると、コメント用のエレメントが作成されます。 このチェック・ボックスのチェックを外した場合、コメントは無視されて、エレメントは作成されません。
処理命令の保存 いいえ いいえ なし このプロパティーは、XMLNSC パーサーがタイムアウト・メッセージ内で処理命令を検出したときに、メッセージ・ツリー内にエレメントを作成するかどうかを制御します。 チェック・ボックスを選択すると、処理命令用のエレメントが作成されます。 このチェック・ボックスのチェックを外した場合、処理命令は無視されて、エレメントは作成されません。
不透明エレメント いいえ いいえ ブランク XMLNSC パーサーによって不透明解析されるタイムアウト・メッセージ内のエレメントのリストを指定するときに、このプロパティーを使用します。 不透明解析が実行されるのは、妥当性検査が使用不可に設定されている場合のみ (つまり、「妥当性検査」「なし」の場合) です。妥当性検査が使用可能な場合、「不透明エレメント」で指定される項目は無視されます。

TimeoutNotification ノードの「妥当性検査」プロパティーについては、次の表に説明されています。

メッセージがノードの Failure ターミナルに伝搬される場合には、妥当性検査は行われません。 詳しくは、メッセージの妥当性検査および妥当性検査プロパティーを参照してください。
プロパティー M C デフォルト 説明 mqsiapplybaroverride コマンド・プロパティー
妥当性検査 いいえ はい なし このプロパティーは、妥当性検査を行うかどうかを制御します。 有効な値は、「なし」「内容」、および「内容と値」です。 validateMaster
失敗時の処置 いいえ いいえ 例外 このプロパティーは、妥当性検査が失敗した場合の動作を制御します。 「妥当性検査」「内容」または「内容と値」に設定した場合にのみ、このプロパティーを設定できます。 有効な値は、「ユーザー・トレース」「ローカル・エラー・ログ」「例外」、および「例外リスト」です。  
ノードのモニター・プロパティーが、次の表に説明されています。
プロパティー M C デフォルト 説明
イベント いいえ いいえ なし ノードに対して定義したイベントが、このタブに表示されます。 デフォルトでは、メッセージ・フローのどのノードに対してもモニター・イベントは定義されません。 ノードのモニター・イベントを作成、変更、または削除するには、「追加」「編集」、および「削除」を使用します。詳しくは、モニター・プロパティーを使用したモニター・イベント・ソースの構成を参照してください。

「使用可能」チェック・ボックスを選択またはクリアすることによって、ここに表示されているイベントを使用可能および使用不可に設定できます。

特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        最終更新:
        
        最終更新: 2015-02-28 17:45:40


参照トピック参照トピック | バージョン 8.0.0.5 | ac20802_