要求-応答フローで MQGet ノードが使用されるシナリオについて、および設定した LocalEnvironment ツリーおよび入力パラメーターの両方の内容に応じて、ノードが入力メッセージを処理して出力メッセージを構成する方法に関して、説明をお読みください。
(要求-応答シナリオをインプリメントしたフローを含む) メッセージ・フロー内のいずれの場所にでも MQGet ノードを含めることができます。このノードは、メッセージ・フロー内のそれより前にあるノードから、入力ターミナル上の入力メッセージを受信します。MQGET 呼び出しを発行して、プロパティー内で構成された WebSphere® MQ キューからメッセージを受信してから、結果メッセージ・ツリーを作成します。最後に、入力ツリーと結果ツリーを使用して出力ツリーを作成してから、これを Output、Warning、または Failure ターミナルに伝搬します。出力先はノードの構成と MQGET 操作の結果に依存します。
MQGet ノードは、前のノードから伝搬される LocalEnvironment ツリーを調べます。 このノードは以下のように、MQGMO (MQ メッセージ取得オプション) と MQMD (MQ メッセージ記述子ヘッダー) に関連する内容を使用して、LocalEnvironment を更新します。
「要求プロパティー」タブの MQGet ノード・プロパティーの「入力 MQ パラメーターのロケーション」内で値を ${inputMQParmsLocation} に設定します。
「結果プロパティー」タブの MQGet ノード・プロパティーの「出力 MQ パラメーターのロケーション」内で値を ${outputMQParmsLocation} に設定します。
これらのプロパティーの詳細は、MQGet ノードを参照してください。
DECLARE ptr REFERENCE TO OutputLocalEnvironment.MyMQParms; CREATE FIRSTCHILD OF ptr DOMAIN('MQMD') PARSE(InputLocalEnvironment.MQ.GET.MQMD)
以下の図は、MQGet ノードが WebSphere MQ への呼び出しに使用する MQMD を構成する方法を示しています。
以下の図は、直前のノードからの入力ツリーと MQGET 呼び出しからの結果ツリーとを結合して、出力メッセージ・ツリーを MQGet ノードが構成する方法を示しています。
プロパティー | アクション |
---|---|
メッセージのコピー | メッセージ全体のコピー |
生成モード | メッセージ |
出力データのロケーション | OutputRoot.XMLNS.A |
結果データのロケーション | ResultRoot.XMLNS.C |
以下の図は、この動作を示しています。
前述の規則に従って MQGet ノードが構成するメッセージ・ツリーの例については、MQGet ノードのメッセージ・ツリーの例を参照してください。