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

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

相関名

相関名は、論理メッセージ・ツリー内の定義済みの開始点を識別するフィールド参照であり、フィールド参照の中で、ツリー・フォーマットを構成する標準的な構成部分を記述するために使用されます。

4 つのツリー (メッセージ、環境、ローカル環境、または例外リスト) のいずれかのデータにアクセスする際には、使用できる相関名は、ESQL またはマッピングを作成した対象のノードと、ノードが出力メッセージを作成するかどうかによって異なります。 例えば、Trace ノードでは、メッセージがノードを通過する際にメッセージの内容が変更されることはありませんが、Compute ノードでは、新しい出力メッセージが構成される可能性があります。

SELECT 式、比較述部、および FOR ステートメントによって新しい相関名を導入できます。 参照変数を使用して、ノードに非相関名を作成できます。

出力メッセージを作成しないノードでの相関名

ほとんどのメッセージ・フロー・ノードは、出力メッセージを作成しません。これらのノード内の ESQL モジュールやマッピングで作成される ESQL 式はすべて、入力メッセージのみを参照します。 Database および Filter ノード用に作成する ESQL モジュールでは次の相関名を使用してください。

Root
ノードを通過するメッセージのルート。
Body
メッセージのルートの最後の子、つまり、メッセージの本体。 この名前は Root.*[<] の別名です。

フィールド参照におけるアスタリスク (*) の使い方の詳細については、無名フィールド参照の使用を参照してください。

Properties
入力メッセージの標準プロパティー。
Environment
ノードにおいて利用可能な現行のグローバル環境変数を含む構造。 Environment は、ESQL コードまたはマッピングを作成できるどのノードからでも、読み取りおよび更新できます。
LocalEnvironment
ノードにおいて利用可能な現行のローカル環境変数を含む構造。 LocalEnvironment は、ESQL コードまたはマッピングを作成できるどのノードからでも、読み取りおよび更新できます。
DestinationList
ノードにおいて利用可能な現行のローカル環境変数を含む構造。 好ましいのは LocalEnvironment という名前ですが、以前のバージョンとの互換性を保つために DestinationList という相関名も使用可能です。
ExceptionList
ノードがアクセスする現行の例外リストを含む構造。

以下の相関名は、Mapping ノードのマッピングの式に使用できません。

出力メッセージを作成するノードでの相関名

Compute ノードのための ESQL をコーディングしている場合には、相関名は、関係している 2 つのメッセージ・ツリー (入力メッセージと出力メッセージ) を識別する必要があります。 それらのノードでの ESQL の相関名は、次のとおりです。

InputBody
入力メッセージのルートの最後の子。 この名前は InputRoot.*[<] の別名です。

* の使い方の詳細については、無名フィールド参照の使用を参照してください。

InputRoot
入力メッセージのルート。
InputProperties
入力メッセージの標準プロパティー。
Environment
ノードにおいて利用可能な現行のグローバル環境変数を含む構造。 Environment は、読み取りおよび更新できます。
InputLocalEnvironment
ノードを通過するメッセージ用のローカル環境変数を含む構造。
InputDestinationList
ノードを通過するメッセージ用のローカル環境変数を含む構造。 以前のバージョンとの互換性を保つには、相関名 InputDestinationList を使用してください。互換性が必要とされない場合には、推奨名 InputLocalEnvironment を使用してください。
InputExceptionList
ノードを通過するメッセージ用の例外リストを含む構造。
OutputRoot
出力メッセージのルート。

Compute ノードでは、相関名 OutputBody は無効です。

OutputLocalEnvironment
ノードから送信されるローカル環境変数を含む構造。

相関名は常に有効ですが、それが意味を持つのは、Compute ノードが LocalEnvironment を伝搬していることを、Compute ノードの「計算モード」プロパティーが示す場合だけです。

OutputDestinationList
ノードから送信されるローカル環境変数を含む構造。 以前のバージョンとの互換性を保つには、相関名 OutputDestinationList を使用してください。互換性が必要とされない場合には、推奨名 OutputLocalEnvironment を使用してください。
OutputExceptionList
ノードが生成している例外リストを含む構造。

相関名は常に有効ですが、それが意味を持つのは、Compute ノードが ExceptionList を伝搬していることを、Compute ノードの「計算モード」プロパティーが示す場合だけです。

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

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

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


概念トピック概念トピック | バージョン 8.0.0.5 | ac00510_