LocalEnvironment でのスクラッチパッド領域の使用

LocalEnvironment ツリーには、Variables という名前のサブツリーが含まれています。 このサブツリーは必ず作成されますが、メッセージ・フローには決して移植されません。 この領域は、あるノードから別のノードへと情報を受け渡すなどの、独自の目的に使用します。 必要であれば、LocalEnvironment ツリーに他のサブツリーを作成することができます。

変更の始まりLocalEnvironment のスクラッチパッドに独自のデータを作成する利点は、メッセージ・フロー内の後続のノードに、このデータが論理ツリーの一部として伝搬できることです。 Compute ノードに新規出力メッセージを作成する場合には、入力メッセージからの LocalEnvironment ツリーのすべてまたは一部をその新規出力メッセージに含めることもできます。変更の終わり

変更の始まりLocalEnvironment 中の情報がフローのさらに下流に確実に伝搬されるようにするには、Compute ノードの「計算モード」プロパティーを、出力ツリーの一部として LocalEnvironment を組み込むように設定する必要があります (例えば、「LocalEnvironment とメッセージ」 を指定)。「計算モード」の詳細については、モードの設定を参照してください。変更の終わり

しかしそのメッセージ・フローが取り消されてまったく始めに戻る場合には (例えば、例外がスローされる場合)、ノードで更新または追加された任意のデータは保存されません。独自のデータを作成し、データをメッセージ・フロー全体で保持する場合には、Environment ツリーを使用する必要があります。

Compute ノードの Variables サブツリーに値を設定し、メッセージ・フローを構成する際に定めた特定の目的で他のノード (Compute、Database、または Filter) が後ほど使用するようにできます。

変更の始まりLocalEnvironment は Compute ノードの有効範囲内にないので、代わりに InputLocalEnvironment および OutputLocalEnvironment を使用しなければなりません。変更の終わり

変更の始まり例えば、LocalEnvironment でスクラッチパッドを使用して、出力メッセージの宛先をメッセージ・フロー中の後続ノードに伝搬することもできます。最初の Compute ノードは、このメッセージ・フローからの出力メッセージが WebSphere MQ キューに到達するものであることを判別します。 次の ESQL を組み込んで、OutputLocalEnvironment 中の OutputLocation の値を設定することにより、この情報を LocalEnvironment に挿入します。
SET OutputLocalEnvironment.Variables.OutputLocation = 'MQ';
変更の終わり
変更の始まり2 番目の Compute ノードは、その入力メッセージからこの情報にアクセスできます。 このノードの ESQL で、相関名 InputLocalEnvironment を使用して、このデータに含まれる入力メッセージ内の LocalEnvironment ツリーを識別します。 以下の ESQL は、InputLocalEnvironment を使用して、LocalEnvironment 中の OutputLocation の内容に基づいて、queueManagerName および queueName を設定します。
IF InputLocalEnvironment.Variables.OutputLocation = 'MQ' THEN
   SET OutputLocalEnvironment.Destination.MQ.DestinationData.queueManagerName = 'myQManagerName';
   SET OutputLocalEnvironment.Destination.MQ.DestinationData.queueName = 'myQueueName';
END IF;
変更の終わり

変更の始まりこの例では、出力メッセージの Destination サブツリーに関する queueManagerNamequeueName が設定されています。2 番目の Compute ノードの「計算モード」を、出力メッセージの LocalEnvironment ツリーを組み込むように設定しなければなりません。「宛先モード」プロパティーを「宛先リスト」に設定して、LocalEnvironment ツリー内で作成された宛先リストを使用するように MQOutput ノードを構成します。変更の終わり

DestinationData サブツリー内のエレメントの完全なリストについては、DestinationData サブツリー内のエレメントのデータ・タイプを参照してください。

関連概念
メッセージ・フローの概要
LocalEnvironment ツリー構造
ESQL の概要
関連タスク
メッセージ・フローの設計
関連資料
Compute ノード
Database ノード
Filter ノード
DestinationData サブツリー内のエレメントのデータ・タイプ
ESQL 参照
SET ステートメント
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック
Copyright IBM Corporation 1999, 2006 最終更新: 08/21/2006
ac16870_