MQGet ノード

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

目的

WebSphere MQ Enterprise Transport を使用してブローカーに接続し、 MQI および AMI アプリケーション・プログラミング・インターフェースを使用するクライアントからのメッセージを受信するには、 MQGet ノードを使用します。 MQGet ノードを使用して、ブローカーのキュー・マネージャーに定義された WebSphere MQ メッセージ・キューに以前に入れられていたメッセージを検索することもできます。

MQGet ノードでは、特定のキューからメッセージを読み取り、メッセージの処理環境を確立します。 適切な場合には、入力キューを WebSphere MQ クラスター・キューまたは共有キューとして定義することができます。

メッセージ・フロー内の最初のノードとしてだけ使用できる MQInput ノードとは異なり、 MQGet ノードはメッセージ・フロー内の任意の場所で使用できます。 MQGet ノードからの出力メッセージ・ツリーは、入力ツリーと MQGet 呼び出しからの結果ツリーとを結合して構成されます。 MQGet ノードのプロパティーを設定すると、メッセージの受信方法を制御できます。 例えば、メッセージをトランザクション制御下で処理するように指示すること、 または結果ツリーが作成されているとき、入力メッセージを受信するたびにデータ変換を実行するように要求することができます。

MQGet ノードは、次のメッセージ・ドメインのメッセージを処理します。

  • MRM
  • XML
  • XMLNS
  • XMLNSC
  • JMSMap
  • JMSStream
  • MIME
  • BLOB
  • IDOC

ワークベンチでは、MQGet ノードは次のアイコンで表されます。

MQGet ノード・アイコン

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

MQGet ノードをメッセージ・フロー内で使用する方法については、次の説明およびサンプルを参照してください。

MQGet ノードの構成

MQGet ノードのインスタンスをメッセージ・フローに入れると、MQGet ノードを構成することができます。

エディター・ビューでノードを右クリックし、「プロパティー」をクリックします。ノードの基本プロパティーが、プロパティー・ダイアログに表示されます。

すべての必須プロパティーは、プロパティー・ダイアログ内でアスタリスクでマークされます。

以下の方法で、MQGet ノードを構成します。

  1. キュー名」に、メッセージの取得元となるキューの名前を入力します。 この WebSphere MQ キューを、 メッセージ・フローをデプロイするブローカーのホストとして機能するキュー・マネージャーに対して事前定義する必要があります。 このキューが有効なキューではない場合、ノードは例外を生成して、メッセージは failure ターミナルに伝搬されます。
  2. プロパティー・ダイアログ・ナビゲーターで「デフォルト」を選択して、着信メッセージの構文解析方法を決定するのにノードが使用するメッセージ・ドメイン、メッセージ・セット、メッセージ・タイプおよびメッセージ形式を記述するプロパティーの値を設定し、メッセージに関連したデフォルト・トピックの値を設定します。
    • 着信メッセージに MQRFH2 ヘッダーがある場合には、その MQRFH2 ヘッダーの <mcd> フォルダーから値を取り込めるため、「デフォルト」プロパティーの値を設定する必要はありません。以下に例を示します。
      <mcd><Msd>MRM</Msd><Set>DHM4UO906S001</Set><Type>receiptmsg1</Type>
      <Fmt>XML</Fmt></mcd>

      MQRFH2 ヘッダーの値とは異なる値を設定すると、MQRFH2 ヘッダーが優先されます。

    • メッセージ・ドメイン」では、ドロップダウン・リストから使用するパーサーの名前を選択します。以下の名前から選択できます。
      • MRM
      • XML
      • XMLNS
      • XMLNSC
      • JMSMap
      • JMSStream
      • MIME
      • BLOB
      • IDOC
    • MRM または IDOC パーサーを使用する場合は、「メッセージ・セット」のドロップダウン・リストから、適切なメッセージ・セットを選択します。

      XML、XMLNS、XMLNSC、JMS、MIME、および BLOB パーサーの場合、「メッセージ・セット」はブランクのままにしてください。

    • MRM パーサーを使用する場合は、「メッセージ・タイプ」のドロップダウン・リストから、適切なメッセージ・タイプを選択します。このリストには、選択したメッセージ・セットで定義されたメッセージが取り込まれます。

      XML、XMLNS、XMLNSC、JMS、IDOC、MIME、および BLOB パーサーの場合、「メッセージ・タイプ」はブランクのままにしてください。

    • MRM または IDOC パーサーを使用する場合は、「メッセージ形式」のドロップダウン・リストから、メッセージの形式を選択します。 このリストには、このメッセージ・セット用に定義されたすべての物理形式が含まれます。

      XML、XMLNS、XMLNSC、JMS、MIME、および BLOB パーサーの場合、「メッセージ形式」はブランクのままにしてください。

  3. プロパティー・ダイアログ・ナビゲーターで「拡張」を選択し、「拡張」プロパティーの値を設定します。
    • このメッセージの処理方法についてのトランザクション特性を定義するには、 ドロップダウン・リストから「トランザクション・モード」の値を選択します。
      • 「自動」を選択した場合、メッセージに持続のマークがない場合には同期点下で受信されます。 メッセージに持続のマークがない場合、そのメッセージは同期点下で受信されません。 出力ノードによってその後に伝搬される派生メッセージのトランザクション特性は、 出力ノードまたはメッセージ・フロー内の後続の他のノードが明示的にトランザクション特性をオーバーライドしない限り、入力メッセージが持続または非持続のどちらであるかによって判別されます。
      • 「はい」を選択すると、着信メッセージが同期点下で受信されます。メッセージ・フローと同じインスタンスの出力ノードによってその後に伝搬される派生メッセージは、 出力ノードまたはメッセージ・フロー内の後続の他のノードが明示的にトランザクションをオーバーライドしない限り、トランザクションとして送信されます。
      • 「いいえ」を選択すると、着信メッセージが同期点下で受信されません。メッセージ・フローと同じインスタンスの出力ノードによってその後に伝搬される派生メッセージは、 出力ノードまたはメッセージ・フロー内の後続の他のノードがメッセージを同期点下に置くことを指定していない限り、非トランザクションとして送信されます。
    • ドロップダウン・リストから「生成モード」の値を選択して、 出力メッセージに含まれるどのコンポーネントが MQGet ノード内で生成され、 どのコンポーネントが入力メッセージから取得されるのかを定義します。
      • 「なし」を選択した場合、 入力ツリーからのメッセージ内のすべてのコンポーネントは変更されないで伝搬されます。
      • 「メッセージ」を選択した場合、 新規のメッセージ・コンポーネントがノードによって生成されますが、 入力ツリーからの LocalEnvironment、Environment、および ExceptionList コンポーネントは変更されないで伝搬されます。 これは「生成モード」のデフォルト値です。
      • 「LocalEnvironment」 を選択した場合、 新規の LocalEnvironment コンポーネントがノードによって生成されますが、 入力ツリーからのメッセージ、Environment、および ExceptionList コンポーネントは変更されないで伝搬されます。
      • 「メッセージと LocalEnvironment」を選択した場合、 新規のメッセージ・コンポーネントおよび LocalEnvironment コンポーネントがノードによって生成されて、 入力ツリーからの Environment および ExceptionList コンポーネントは変更されないで伝搬されます。
    • 生成モード」を「メッセージ」また は「メッセージと LocalEnvironment」のどちらかに指定した場合、 「メッセージのコピー」の値をドロップダウン・リストから選択して、 メッセージのどの部分が MQGet ノード内で生成され、どの部分が入力メッセージから取得されるのかを定義します。
      • 「なし」を選択した場合、 伝搬される入力ツリーからの入力メッセージの部分はありません。 これは「メッセージのコピー」のデフォルト値です。
      • 「ヘッダーのコピー」を選択した場合、 入力ツリー内の入力メッセージにあるヘッダーがコピーされます。
      • 「メッセージ全体のコピー」を選択した場合、 入力ツリーからの入力メッセージ全体がコピーされます。
    • 生成モード」を「LocalEnvironment」また は「メッセージと LocalEnvironment」のどちらかに指定した場合、 「ローカル環境のコピー」の値をドロップダウン・リストから選択して、 ローカル環境のどの部分が MQGet ノード内で生成され、どの部分が入力メッセージから取得されるのかを定義します。
      • 「なし」を選択した場合、コピーされるローカル環境の部分はありません。
      • 「LocalEnvironment 全体のコピー」を選択した場合、 入力メッセージで定義されたローカル環境全体がコピーされます。 これは、「ローカル環境のコピー」プロパティーのデフォルト値です。
    • 待機間隔」プロパティーの値を指定して、 MQGET 呼び出しからメッセージを受け取るための待機時間をミリ秒単位で設定します。 値を指定しない場合、デフォルト値の 1000 ミリ秒が使用されます。
    • 最小メッセージ・バッファー・サイズ」プロパティーの値を指定して、 MQGET 呼び出しのための初期バッファーの大きさをキロバイト単位で設定します。 このバッファーは自動的に拡張して任意のサイズのメッセージを受け入れますが、 すべてのメッセージが大きいことが予想される場合は、適切な値を指定すると バッファーがサイズ変更される頻度が少なくなります。 値を指定しない場合、バッファーの初期サイズは 4 キロバイトになります。
  4. MRM パーサーの場合、メッセージ・セットから生成されたディクショナリーに対してメッセージ本体の妥当性検査を行いたいのであれば、プロパティー・ダイアログ・ナビゲーターの「妥当性検査」を選択します。(メッセージがターミナルの failure ノードに伝搬される場合には、妥当性検査は行われません。)

    詳細については、メッセージの妥当性検査およびMRM ドメインのメッセージの妥当性検査プロパティーを参照してください。

  5. プロパティー・ダイアログ・ナビゲーターで「要求」を選択し、 要求パラメーターの構成方法を決定するプロパティーに値を設定します。
    • MQGET 呼び出しに使用される MQMD がデフォルト・ロケーションの InputRoot.MQMD ではない場合、 「入力 MQMD のロケーション」に MQMD のロケーションを指定します。
    • MQGET 呼び出しのパラメーターのロケーション (MQGMO オーバーライドなど) が デフォルト・ロケーション InputLocalEnvironment.MQ.GET ではない場合、 そのロケーションを「入力 MQ パラメーターのロケーション」に指定します。
    • 相関 ID で取得」チェック・ボックスにチェック・マークを付けた場合、検索するメッセージの「CorrelId」フィールドは 「入力 MQMD のロケーション」の「CorrelId」フィールドと一致する必要があります。 デフォルトでは、このチェック・ボックスはクリアされています。
    • メッセージ ID で取得」チェック・ボックスにチェック・マークを付けた場合、検索するメッセージの「MsgId」フィールドは 「入力 MQMD のロケーション」の「MsgId」フィールドと一致する必要があります。 デフォルトでは、このチェック・ボックスはクリアされています。
    • 完全入力 MQMD の使用」チェック・ボックスにチェック・マークを付けた場合、検索するメッセージの MQMD 全体は、 「入力 MQMD のロケーション」の値とビットごとに一致する必要があります。 デフォルトでは、このチェック・ボックスはクリアされています。
  6. プロパティー・ダイアログ・ナビゲーターで「結果」を選択し、 MQGET 呼び出しの結果を処理する方法を決定するプロパティーに値を設定します。
    • 出力データのロケーション」に、 出力メッセージ・ツリー内で検索されたメッセージのビット・ストリングから構文解析されたエレメントが保管される開始位置を入力します。 デフォルトは、「OutputRoot」です。 このロケーションにあるすべてのエレメントは削除されて、 デフォルトでは入力ツリー・メッセージが検索されたメッセージに置き換わります。

      入力ツリーから伝搬したメッセージに応答を挿入するために、 メッセージ・ツリー内に新規ノードを作成するための新規フィールド・リファレンスを含む、 任意の有効な ESQL フィールド・リファレンスを入力できます。このリファレンスには式を含めることができます。

      例えば、OutputRoot.XMLNS.ABC.DEF および Environment.GotReply は有効なフィールド・リファレンスです。 詳細については、要求-応答フロー内での MQGet ノードの使用を参照してください。

      検索されたメッセージのビット・ストリングが構文解析されてメッセージ・ツリーの内容が作成されるとき、ノードのデフォルト・プロパティーに指定したメッセージ・プロパティーが使用されます。

    • 結果データのロケーション」に値を設定して、 検索されたメッセージ内のどのサブツリーが出力メッセージ内に入れられるかを制御します。 デフォルトは、検索されたメッセージ全体が出力メッセージに入れられることを示す ResultRoot です。 例えば、検索されたメッセージから MQMD だけが必要であれば、ResultRoot.MQMD を使用します。 その後、このサブツリーは、「出力データのロケーション」で指定したロケーションに配置されます。
    • 出力 MQ パラメーターのロケーション」に値を設定して、 CC (完了コード)、RC (戻りコード)、および他の MQ パラメーター (MQGET 呼び出しで使用される MQMD など) が、出力ツリー内のどこに配置されるかを制御します。 デフォルトは、OutputLocalEnvironment.MQ.GET です。
    • 警告データのロケーション」に値を設定して、 MQGET 呼び出しが警告コードを戻すときに検索されたメッセージがどこに配置されるかを制御します。 デフォルトは、OutputRoot です。

      任意の有効な ESQL フィールド・リファレンスを入力することができます (「出力データのロケーション」プロパティーについての説明を参照してください)。 このロケーションに配置されるデータは常に、本体が BLOB エレメントの、完全な結果ツリーとなります。 「結果データのロケーション」は、警告データには使用されません。

  7. プロパティー・ダイアログ・ナビゲーターで「一般メッセージ・オプション」を選択します。 「解析のタイミング」は、デフォルトで、「要求時」に設定されます。 この設定では、部分構文解析によって構文解析されるまで、妥当性検査が遅延します。

    設定を「即時」に変更すると、部分構文解析はオーバーライドされて、メッセージ内のすべてのものが構文解析および妥当性検査されます。ただし、「構成」が「選択」または「メッセージ」に指定された複合タイプで、この時点で解決できないものは除きます。 設定を「完全」に変更すると、部分構文解析はオーバーライドされて、メッセージ内のすべてのものが構文解析および妥当性検査されます。「構成」が「選択」または「メッセージ」に指定された複合タイプで、この時点で解決できないものでは妥当性検査障害が生じます。

    詳細については、MRM ドメインのメッセージの妥当性検査プロパティーを参照してください。

    MQRFH2C パーサーが使用されるようにするには、「MQRFH2C コンパクト・パーサーを使用」チェック・ボックスを選択します。 デフォルトでは、このチェック・ボックスはクリアされていて、コンパクト・パーサーが使用されないことを示します。

  8. プロパティー・ダイアログ・ナビゲーターで「XMLNSC パーサー・オプション」を選択し、 要求パラメーターの構成方法を決定するプロパティーに値を設定します。

    詳細については、XMLNSC パーサーを使用したメッセージの操作を参照してください。

  9. 簡略説明または詳細説明 (あるいはその両方) を入力するには、プロパティー・ダイアログ・ナビゲーターの「説明」を選択します。
  10. 「適用」をクリックして、プロパティー・ダイアログを閉じずに MQGet ノードを変更するか、 または「OK」をクリックして、変更を適用してからプロパティー・ダイアログを閉じます。

    「キャンセル」をクリックすると、ダイアログを閉じてプロパティーに対して行った変更をすべて破棄します。

ターミナルの接続

メッセージをさらに処理したい場合、エラーを処理したい場合、あるいはメッセージを追加の宛先に送信したい場合は、 このノードの Out、Warning、Failure、および No Message 出力ターミナルをメッセージ・フローの別のノードに接続します。

各出力ターミナルに何が伝搬するかは、MQGET によって生成される条件コード (CC) に依存します。

MQGET 呼び出しが成功した場合、MQGet ノードは構文解析された各出力メッセージを Out ターミナルに経路指定します。

MQGET 呼び出しが失敗して、CC が警告を示している場合、 構文解析されていない出力メッセージが Warning ターミナルに伝搬されます。

MQGET 呼び出しが失敗して、CC が警告よりも重大な状況を示している場合、 入力メッセージが Failure ターミナルに伝搬されます。

変更の始まりMQGET 呼び出しが失敗して、理由コード MQRC_NO_MSG_AVAILABLE が出された場合、 出力メッセージは結果本文なしで No Message ターミナルに伝搬されます。 No Message ターミナルに伝搬される出力メッセージは、「生成モード」と「メッセージのコピー」、または「ローカル環境のコピー」プロパティーの値に従って、入力メッセージのみで構成されます。変更の終わり

Out、Warning、または No Message ターミナルをメッセージ・フロー内の別のノードに接続しない場合、それらのターミナルに伝搬するものはすべて廃棄されます。

メッセージ・フロー内の別のノードに Failure ターミナルを接続しない場合には、 そのターミナルに何かが伝搬されるとブローカーによって例外がスローされます。

詳細については、failure ターミナルの接続を参照してください。

整合トランザクションの構成

メッセージ・フローに MQGet ノードを組み込む場合、 「トランザクション・モード」で設定した値が、 メッセージを同期点下で受信するかどうかを定義します。

  • 「はい」(デフォルト) に設定した場合、メッセージは同期点下 (WebSphere MQ 作業単位内) で受信されます。 メッセージ・フローと同じインスタンスの出力ノードによってその後に送信されるメッセージは、 出力ノードまたは後続の他のノードがこれを明示的にオーバーライドしない限り、同期点の下に置かれます。
  • 「自動」に設定した場合、メッセージは、着信メッセージに持続のマークが付けられている場合に同期点下で受信されます。そうでない場合、メッセージは同期点下で受信されません。 出力ノードによってその後に送信されるメッセージは、出力ノードまたは後続の他のノードがこれを明示的にオーバーライドしない限り、着信持続プロパティーによって判別されたとおりに同期点の下に置かれます。
  • 「いいえ」に設定した場合、メッセージは同期点下で受信されません。フロー内の出力ノードによってその後に送信されるメッセージは、 個々の出力ノードまたは後続の他のノードがメッセージを同期点の下に置くように指定しない限り、同期点の下には置かれません。

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

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

ターミナル 説明
In メッセージ・フローによって処理されているメッセージを受け入れる入力ターミナル。
Warning キューからメッセージを取得しようとしてノード内にエラー (警告を示す CC が付加) が発生した場合に、 出力ツリーが伝搬される出力ターミナル。 メッセージの MQMD 部分は構文解析されますが、メッセージの他の部分は構文解析されていない BLOB エレメントです。 ターミナルが接続されていない場合、この警告は廃棄され、ノードからの出力の伝搬はまったくありません。
Failure キューからメッセージを取得しようとしてノード内にエラー (警告よりも深刻なエラーを示す CC が付加) が発生した場合に、 入力メッセージがルーティングされる出力ターミナル。
Out WebSphere MQ キューからメッセージが正常に取り出された場合に、メッセージがルーティングされる出力ターミナル。
メッセージなし 変更の始まりキューにメッセージが存在しない場合、入力メッセージがルーティングされる出力ターミナル。No Message ターミナルに伝搬される出力メッセージは、「生成モード」と「メッセージのコピー」、または「ローカル環境のコピー」プロパティーの値に従って、入力メッセージのみで構成されます。変更の終わり

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

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

プロパティー M C デフォルト 説明
キュー名 はい はい なし このノードが、メッセージを取り出す WebSphere MQ メッセージ・キューの名前。

MQGet ノードのデフォルト・プロパティーについては、次の表に説明されています。

プロパティー M C デフォルト 説明
メッセージ・ドメイン いいえ いいえ なし メッセージ・キューから取得されるメッセージを構文解析するために使用されるドメイン。
メッセージ・セット いいえ いいえ なし メッセージ・キューから取得されたメッセージが定義されているメッセージ・セットの名前または ID 。
メッセージ・タイプ いいえ いいえ なし メッセージ・キューから取得されるメッセージの名前。
メッセージ形式 いいえ いいえ なし メッセージ・キューから取得されるメッセージの物理形式の名前。

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

プロパティー M C デフォルト 説明
トランザクション・モード いいえ いいえ はい 着信メッセージが同期点下で受信されるかどうか。 有効な値は、「自動」「はい」、および「いいえ」です。
生成モード いいえ いいえ メッセージ 入力ツリーからのメッセージのどの部分がコピーされるかを示します。 有効な値は、「メッセージ」「LocalEnvironment」「メッセージと LocalEnvironment」、および「なし」です。
メッセージのコピー いいえ いいえ なし 入力ツリーからのメッセージのどの部分がコピーされるかを示します。 有効な値は、「なし」「ヘッダーのコピー」、および「メッセージ全体のコピー」です。
ローカル環境のコピー いいえ いいえ   入力ツリーからのメッセージのどの部分がコピーされるかを示します。 有効な値は、「なし」、および「LocalEnvironment 全体のコピー」です。デフォルト値は「LocalEnvironment 全体のコピー」です。
待機間隔 はい いいえ 1000 メッセージをメッセージ・キューから取得できるまで待機する最大時間をミリ秒で示します。
最小メッセージ・バッファー・サイズ はい いいえ  4 取得バッファーの最小サイズをキロバイトで示します。 このプロパティーの最小値は、1 キロバイトです。

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

これらのプロパティーの詳細については、MRM ドメインのメッセージの妥当性検査プロパティーを参照してください。
プロパティー M C デフォルト 説明
妥当性検査 いいえ はい なし 妥当性検査が行われるかどうか。有効な値は、「なし」「内容」「内容と値」、および「継承」です。
失敗処置 いいえ いいえ 例外 妥当性検査に障害が発生した場合の動作。 「妥当性検査」を「内容」または「内容と値」に設定した場合にのみ、このプロパティーを設定できます。有効な値は、「ユーザー・トレース」「ローカル・エラー・ログ」「例外」、および「例外リスト」です。
すべての値制約を含める いいえ いいえ True このプロパティーは編集できません。 チェック・ボックスが選択されていることにより示されるデフォルトのアクションは、基本値制約検査が「内容と値」妥当性検査に含まれるということです。
修正 いいえ いいえ なし このプロパティーは編集できません。

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

プロパティー M C デフォルト 説明
入力 MQMD のロケーション いいえ いいえ   MQGET に使用する MQMD が入力メッセージ・アセンブリーのどこにあるかを指定します。 デフォルトの場所は InputRoot.MQMD です。
入力 MQ パラメーターのロケーション いいえ いいえ   MQ パラメーター (初期バッファー・サイズや MQGMO オーバーライドなど) が、 入力メッセージ・アセンブリーのどこにあるかを指定します。 デフォルトの場所は InputLocalEnvironment.MQ.GET です。
相関 ID で取得 いいえ いいえ False このチェック・ボックスを選択すると、指定の相関 ID があるメッセージだけが取得されます。
メッセージ ID で取得 いいえ いいえ False このチェック・ボックスを選択すると、指定のメッセージ ID があるメッセージだけが取得されます。
完全入力 MQMD の使用 いいえ いいえ False このチェック・ボックスを選択すると、完全な MQMD が使用されます。 選択しないときには、メッセージ ID および相関 ID だけが使用されます。

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

プロパティー M C デフォルト 説明
出力データのロケーション いいえ いいえ OutputRoot 出力データが配置される場所を指定します。 ブランクのままにした場合、デフォルトとして OutputRoot が使用されます。
結果データのロケーション いいえ いいえ ResultRoot どのサブツリー (検索されたメッセージの) を使用するかを指定します。 ブランクのままにした場合、デフォルトとして ResultRoot が使用されて、検索されたメッセージ全体が使用されます。 例えば、ResultRoot.MQMD.ReplyToQ を指定した場合は、そのサブツリーだけが使用されます。
出力 MQ パラメーターのロケーション いいえ いいえ   出力 MQ パラメーターが配置される場所を指定します。 ブランクのままにした場合、デフォルトとして OutputLocalEnvironment.MQ.GET が使用されます。 更新された値が下流のノードで可視となるようにするために、 「生成モード」を LocalEnvironment が含まれるように設定する必要があります。 デフォルトの場所は OutputLocalEnvironment.MQ.GET です。
警告データのロケーション いいえ いいえ OutputRoot MQGET が警告コードを戻す場合に、出力データが配置される場所を指定します。 ブランクのままにした場合、デフォルトとして OutputRoot が使用されます。

MQGet ノードの汎用メッセージ・オプションのプロパティーについては、次の表に説明されています。

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

このプロパティーの詳細については、要求時の構文解析を参照してください。

MQRFH2C コンパクト・パーサーを MQRFH2 ドメインに使用 いいえ いいえ 「False」 このプロパティーは、MQRFH2 パーサーの代わりに、MQRFH2C コンパクト・パーサーを MQRFH2 ヘッダーに使用するかどうかを制御します。

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

プロパティー M C デフォルト 説明
XMLNSC コンパクト・パーサーを XMLNS ドメインに使用 いいえ いいえ 「False」 変更の始まりこのプロパティーは、XMLNS ドメイン内のメッセージに XMLNSC コンパクト・パーサーを使用するかどうかを制御します。このプロパティーを設定すると、入力 RFH2 ヘッダーまたはデフォルト・プロパティー・ドメインが XMLNS の場合、出力ターミナルに接続されているノードの XMLNSC の下にメッセージ・データが表示されることに注意してください。変更の終わり
混合内容保存モード いいえ いいえ なし このプロパティーは、XMLNSC パーサーが入力メッセージ内に混合テキストを検出したとき、メッセージ・ツリー内にエレメントを作成するかどうかを制御します。 有効な値は、「なし」および「すべて」です。「すべて」を選択すると、混合テキストに対してエレメントが作成されます。 「なし」を選択すると、混合テキストは無視されて、エレメントは作成されません。
コメント保存モード いいえ いいえ なし このプロパティーは、XMLNSC パーサーが入力メッセージ内にコメントを検出したとき、メッセージ・ツリー内にエレメントを作成するかどうかを制御します。 有効な値は、「なし」および「すべて」です。「すべて」を選択すると、コメントに対してエレメントが作成されます。 「なし」を選択すると、コメントは無視されて、エレメントは作成されません。
処理命令保存モード いいえ いいえ なし このプロパティーは、XMLNSC パーサーが入力メッセージ内に処理命令を検出したとき、これらのメッセージ・ツリー内にエレメントを作成するかどうかを制御します。 有効な値は、「なし」および「すべて」です。「すべて」を選択すると、処理命令に対してエレメントが作成されます。 「なし」を選択すると、処理命令は無視されて、エレメントは作成されません。

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

プロパティー M C デフォルト 説明
簡略説明 いいえ いいえ ブランク ノードの簡単な説明
詳細説明 いいえ いいえ ブランク メッセージ・フロー内のノードの目的を説明するテキスト
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック
Copyright IBM Corporation 1999, 2006 最終更新: 08/21/2006
ac20806_