メッセージ・ツリーの移植方法

メッセージ・ツリーには、メッセージ・フローの入力ノードによって最初にデータが取り込まれます。

入力ノードが入力メッセージを受け取ると、プロパティー・ツリー (メッセージ・ツリーの最初のサブツリー) を作成して完成します。 メッセージ・ツリー構造を参照してください。

このノードは入力メッセージのビット・ストリームの内容を調べ、メッセージ・ツリーの残りを作成してその内容を反映させます。このプロセスはある程度、入力ノード自体に依存しており、メッセージを受信するトランスポートによって制御されます。

WebSphere® MQ Enterprise Transport プロトコル
ご使用のアプリケーションがこうしたプロトコルを介してブローカーと通信しており、メッセージ・フローには、対応する MQInput ノードが組み込まれている場合には、受信するすべてのメッセージが Message Queue Message Descriptor (MQMD) ヘッダーで開始する必要があります。メッセージの開始時に有効な MQMD がない場合には、メッセージは拒否され、それ以上処理されません。

入力ノードはまず MQMD パーサーを起動し、そのヘッダーのサブツリーを作成します。

メッセージは追加のヘッダーをまったく持たないか、MQMD の後に追加のヘッダーを持つことができます。これらのヘッダーは、相互にチェーニングされ、あるヘッダーの「形式」フィールドで、メッセージ本体の形式を定義する最後のヘッダーに至るまでの後続のヘッダーの形式を定義します。チェーン内に MQRFH および MQRFH2 ヘッダーがある場合には、これら 2 つのヘッダーのいずれかの「名前と値」データに、後続のデータの形式に関する情報を含めることができます。 「形式」で指定した値が認識済みパーサーの場合は、この値は、「名前と値」データよりも常に優先されます。

ブローカーは適切なパーサーを呼び出し、メッセージ内のチェーンに従って、それぞれのヘッダーを解釈します。各ヘッダーは、個別に構文解析されます。 単一のヘッダー内のフィールドは、パーサーが定める順序で解析されます。 選択される順序を予測することはできませんが、フィールドが構文解析される順序は、ヘッダー内にフィールドが表示される順序には影響しません。

メッセージ本体に先行するヘッダーの整合性の保守は、ブローカーが行います。 メッセージの各部分の形式は、直前のヘッダーの中の「形式」フィールド (続く部分が認識されている WebSphere MQ 形式の場合) か、MQRFH または MQRFH2 ヘッダー内で設定されている値によって定義されます。

  • 最初のヘッダーの形式は既知であり、MQMD でなければなりません。
  • メッセージ内の後続のヘッダーの形式は、最初のヘッダーの「形式」フィールドで設定されます。
  • 本文の形式は、メッセージ・ドメインと、メッセージ本体のために呼び出す必要のあるパーサー (例えば、XMLNSC) に対応しています。 この情報は、MQRFH または MQRFH2 ヘッダーで設定されるか、またはメッセージを受信する入力ノードの「 メッセージ・ドメイン」プロパティーで設定されます。

この処理は、メッセージ本体に先行するヘッダーの数に必要な回数反復されます。 ユーザー自身がこれらのフィールドにデータを移植する必要はありません。 このシーケンスはブローカーが処理してくれます。

ブローカーは、この処理を完了し、ヘッダーの「形式」フィールドがメッセージの各部分を正確に識別するようにします。ブローカーがこの処理を完了しない場合、WebSphere MQ ではメッセージを送達できない可能性があります。メッセージ本体のパーサーが、認識された WebSphere MQ ヘッダー形式でないため、ブローカーはこの値を最終ヘッダーの「形式」フィールドで値 MQFMT_NONE に置き換えます。そのフィールドの元の値は、MQRFH または MQRFH2 ヘッダー内の「ドメイン」フィールドに保管され、メッセージ本体の内容についての情報が保存されます。

例えば、MQRFH2 ヘッダーのすぐ後にメッセージ本体が続く場合で、ヘッダーの「形式」フィールドが XMLNSC に設定されている (つまり、メッセージ本体は XMLNSC パーサーによって構文解析されなければならない) 場合、MQRFH2 の「ドメイン」フィールドは XMLNSC に設定され、「形式」フィールドは MQFMT_NONE にリセットされます。

これらのアクションの結果、ESQL または Java 式によって明示的に保管された情報がブローカーによって置き換えられることがあります。

CodedCharSetId フィールドと Encoding フィールドには、Format フィールドと同じ方法ではデータが取り込まれません。 特に、メッセージ本体を使って値 CodedCharSetId および Encoding が判別されることはありません。 代わりに、これらの値はメッセージ本体の書き込み方法に影響を与えます。 このため、削除されるヘッダー値でチェーン内の前のヘッダーを更新しないまま、中間ヘッダー (例えば MQRFH2) が削除された場合、予期しない結果が生じることがあります。

すべてのヘッダーが構文解析され、対応するサブツリーがメッセージ・ツリーに作成された場合には、入力ノードは指定されたパーサーとメッセージ本体とを関連付けます。 メッセージのヘッダー (例えば MQRFH2 ヘッダー内の <mcd> フォルダー)、または入力ノード・プロパティー内 (メッセージにヘッダーが組み込まれていない場合) のいずれかでメッセージ本体の内容に関連付けられるパーサーを指定します。入力ノードは、以下のリストに説明されているとおりに関連付けを行います。

  • メッセージに MQRFH または MQRFH2 ヘッダーが付いている場合、そのヘッダーで指定されているドメイン (「形式」または「名前と値」データのいずれか) が、このメッセージに関連付けられるパーサーを判別します。
  • メッセージに MQRFH または MQRFH2 ヘッダーが付いていない場合や、ヘッダーでドメインが識別されていない場合には、入力ノードの「メッセージ・ドメイン」プロパティーによって、使用されるメッセージのドメインとパーサーが指示されます。 ユーザー定義のドメインおよびパーサーを指定できます。
  • 入力ノードのヘッダー値または「メッセージ・ドメイン」プロパティーによってメッセージ・ドメインを認識できない場合には、そのメッセージはバイナリー・オブジェクト (BLOB) として処理されます。 BLOB パーサーがメッセージに関連付けられます。 BLOB は、16 進文字のストリングとして解釈することができ、ストリングのサブセットの位置を指定することによって、メッセージ・フロー内で変更したり調べたりすることができます。

デフォルトでは、メッセージ本体は、パフォーマンス上の理由からすぐには構文解析されません。 メッセージ本体は、メッセージ・フロー中に構文解析が不要の場合があります。その内容に対して参照が行われる際のみ構文解析されます。

例えば、Root.XMLNSC.MyDoc.MyField といった、メッセージ本体内のフィールドを参照すると、メッセージ本体が解析されます。 メッセージ・フロー内のどのパスを通るかによって、さまざまな時点でこれが行われる可能性があります。 この「最初に必要になったときに構文解析する」手法は、「部分構文解析」または「オンデマンド解析」とも呼ばれますが、標準的な処理ではメッセージ・フローの論理に影響を与えません。 ただし、エラー処理のシナリオの場合には、特定の意味を持ちます。メッセージ・フローのエラー処理を参照してください。

メッセージ・フローが複数のメッセージ・ドメインからメッセージを受け入れるようにするには、入力ノードがメッセージ・ドメインおよび関連したメッセージ定義情報 (メッセージ・セット、メッセージ・タイプ、およびメッセージ形式) を抽出するメッセージに MQRFH2 ヘッダーを付けます。

メッセージ・ヘッダーや入力ノード・プロパティーをセットアップして、ユーザー定義のドメインおよびパーサーを指定する場合、メッセージを解釈し論理ツリーを構成する方法は、ここでの説明とは異なる場合があります。

WebSphere Broker File Transport、WebSphere Broker Adapters Transport、WebSphere MQ Web Services Transport、および WebSphere Broker JMS Transport プロトコル
ご使用のアプリケーションがサポートされているプロトコルを介してブローカーと通信し、ご使用のメッセージ・フローには、対応する入力ノードが組み込まれている場合には、受信するメッセージが特定のヘッダーを組み込んでいる必要はありません。 認識済みのヘッダーが組み込まれている場合には、他のサポートされているプロトコルに関して述べられているのと同様、入力ノードは適切なパーサーを呼び出してヘッダーを解釈し、メッセージ・ツリーの関連部分を構築します。

ヘッダーがない場合、または他のヘッダーがメッセージ本体のパーサーを指定していない場合には、入力ノード・プロパティーを設定してメッセージ本体パーサーを定義します。ノード・プロパティーをこのように設定しない場合には、メッセージは BLOB として処理されます。ユーザー定義のパーサーを指定できます。

指定されたパーサーは (WebSphere MQ Enterprise Transport プロトコルの場合と同様に) 入力ノードでメッセージ本体と関連付けられ、デフォルトでは、メッセージ本体は即時には構文解析されません。

メッセージ・ヘッダーや入力ノード・プロパティーをセットアップして、ユーザー定義のドメインおよびパーサーを指定する場合、メッセージを解釈し論理ツリーを構成する方法は、ここでの説明とは異なる場合があります。

他のすべてのプロトコル
WebSphere Message Broker が組み込みサポートを提供していないトランスポート・プロトコルからのメッセージをメッセージ・フローが受け入れるようにしたい場合や、メッセージの受信に関してメッセージ・フローが特定の処理を提供するようにしたい場合には、Java または C 言語プログラミング・インターフェースのいずれかを使用して、新しいユーザー定義の入力ノードを作成します。

このインターフェースでは、メッセージのプロパティー・サブツリー (このサブツリーについては、メッセージ・ツリー構造で説明されています) が自動的に生成されるわけではありません。メッセージにプロパティー・サブツリーを含める必要はありませんが、入力ノードに関係なく、プロパティー・フォルダーを作成して一貫したメッセージ・ツリー構造を用意すると便利かもしれません。ユーザー定義の入力ノードを使用している場合は、自分でメッセージ・ツリーにプロパティー・サブツリーを作成する必要があります。

定義されているどのメッセージ・ドメインにも準拠しないメッセージを処理するには、C 言語プログラミング・インターフェースを使用して新しいユーザー定義パーサーを作成します。

ノード・インターフェースがパーサーを使用する仕組みを理解し、ノード・インターフェースを構成してその動作を変更できるかどうかを確認するために、そのノード・インターフェースを参照します。 ノードでユーザー定義パーサーを使用している場合、メッセージ用に作成したツリー構造は、組み込みパーサー用に作成したツリー構造といくらか異なる場合があります。 ユーザー定義の入力ノードは、入力メッセージを完全に構文解析するか、または必要なときにのみメッセージ本体が構文解析される部分構文解析に加わることができます。

C または Java で、ユーザー独自の出力ノードやメッセージ処理ノードを作成することもできます。

さまざまなトランスポートの場合の、MQMD フォルダーと比較した Properties フォルダーの振る舞い

同一フィールドの場合にどちらのフォルダーが優先されるかという点で、Properties フォルダーと MQMD フォルダーの取り扱い方には相違があります。 その取り扱い方は、使用するトランスポート・タイプ (例えば、HTTP や WebSphere MQ) によって特徴が決まります。

メッセージ・フローのソースが MQInput ノードである場合、MQMD が解析の対象になります。 そのような場合、Properties フォルダーは MQMD 値をソースとするので、フォルダー間の値の伝搬という点で、Properties フォルダーよりも MQMD フォルダーが優先されます。このシナリオは、例えば SET OutputRoot.MQMD.CorrelId といった ESQL を実行できることを意味し、このコマンドによって Properties フォルダーの値が更新されます。

メッセージ・フローが、MQInput ノードではない入力ノード (HTTPInput ノードまたはユーザー定義の入力ノード) をソースとする場合、MQMD はまったく解析されません。このシナリオでは、Properties フォルダーは入力 MQMD をソースとしません。つまり、このフォルダーは、作成されてから、他のトランスポート固有のヘッダーから取られたトランスポート値が取り込まれます。 WebSphere MQ トランスポートをソースとしないメッセージ・フロー内で MQMD フォルダーを作成すると、WebSphere MQ トランスポートによってデータが Properties フォルダーに取り込まれることはないので、MQMD ヘッダーが Properties フォルダーより優先されることはありません。 したがって、そのような場合、Properties フォルダーは MQMD 内のすべて値を上書きします。

Properties フォルダーは、構成されると、トランスポートで受信されるメッセージを表します。 このシナリオでは、それぞれ異なる意味を持っているので Properties フォルダーの要件も異なる 2 つのまったく異なるトランスポートが使用されます。 HTTP ヘッダーが HTTPInput ノードをソースとする場合、同種フィールドの Properties フォルダーは HTTP ヘッダーの制御下に置かれます。 MQMD が MQInput ノードをソースとする場合、同種フィールドの Properties フォルダーは、MQMD の制御下に置かれます。

HTTP トランスポートによって作成されたツリーに MQMD フォルダーを追加すると、この MQMD フォルダーは、Properties フォルダーをその制御下に置くことはなく、値の伝搬は MQMD から Properties への方向ではなく、Properties から MQMD への方向になります。 正しいアプローチは、Properties フォルダーの replyIdentifier フィールドを設定し、これを使用して MQMD を取り込む方法です。
 SET OutputRoot.Properties.ReplyIdentifier = X' ..... '; 
この動作は、CorrelId から ReplyIdentifier のフィールドにのみ固有の動作ではありません。これは、次のような、MQMD と Properties フォルダーの間のすべての同種フィールドにも当てはまります。
  • CorrelId
  • エンコード
  • CodedCharSetId
  • Persistence
  • Expiry
  • Priority
要約すると、以下のようになります。
  1. メッセージ・フローが MQInput ノードをソースとする場合、フォルダー間の値の伝搬という点では、MQMD が Properties フォルダーより優先されます。
  2. メッセージ・フローが、MQInput ノードではない入力ノード (HTTPInput ノードまたはユーザー定義の入力ノード) をソースとする場合、MQMD ヘッダーが Properties フォルダーより優先されることはありません。
  3. HTTP トランスポートによって作成されたツリーに MQMD フォルダーを追加すると、この MQMD は、Properties フォルダーをその制御下に置くことはなく、値の伝搬は MQMD から Properties への方向ではなく、Properties から MQMD への方向になります。

例

SET OutputRoot.Properties = InputRoot.Properties;
SET OutputRoot.MQMD.Version = 2;
SET OutputRoot.MQMD.CorrelId = X'4d454e53414a453320202020202020202020202020202020';
SET OutputRoot.MQMD.Encoding = 785;
SET OutputRoot.MQMD.CodedCharSetId = 500;
SET OutputRoot.MQMD.Persistence = 1;
SET OutputRoot.MQMD.Expiry = 10000;
SET OutputRoot.MQMD.Priority = 9;
SET OutputRoot.BLOB.BLOB = X'01';
HTTPInput ノードがソースである場合、これらの変更が有効になることはなく、Compute ノードからの MQMD 出力は次のようになります。
(0x01000000):MQMD       = (
    (0x03000000):Version        = 2
    (0x03000000):CorrelId       = X'000000000000000000000000000000000000000000000000'
    (0x03000000):Encoding       = 546
    (0x03000000):CodedCharSetId = 1208
    (0x03000000):Persistence    = FALSE
    (0x03000000):Expiry         = -1
    (0x03000000):Priority       = 0
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
最終更新

        最終更新 : 2012-07-13 15:40:10


概念トピック概念トピック | バージョン 8.0.0.1 | ac18520_