MQGet ノード

WebSphere® MQ Enterprise Transport を使用してブローカーに接続し、MQI および AMI アプリケーション・プログラミング・インターフェースを使用するクライアントからのメッセージを受信するには、MQGet ノードを使用します。

また MQGet ノードを使用して、ブローカーのキュー・マネージャーに定義された WebSphere MQ メッセージ・キューに以前に入れられていたメッセージを検索することもできます。

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

このトピックでは、次の用語を使用します。
入力メッセージ
MQGet ノードの In ターミナルに入力されるメッセージ。
キュー・メッセージ
MQGet ノードがキューから読み取るメッセージ。

目的

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

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

MQGet ノードは、次のメッセージ・ドメインのメッセージを処理します。
  • MRM
  • XML
  • XMLNS
  • XMLNSC
  • JMSMap
  • JMSStream
  • MIME
  • BLOB
  • IDOC

MQGet ノードは、パレットの 「WebSphere MQ」ドロワーに含まれていて、ワークベンチ内では、次のアイコンによって表されます。

MQGet ノード・アイコン

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

MQGet ノードをメッセージ・フロー内で使用する方法については、以下のトピックを参照してください。

MQGet ノードの構成

MQGet ノードのインスタンスをメッセージ・フローに入れると、JMSReply ノードを構成することができます。詳しくは、メッセージ・フロー・ノードの構成を参照してください。 ノードのプロパティーが、「プロパティー」ビューに表示されます。ノードのプロパティーを「プロパティー」ダイアログに表示するには、ノードをダブルクリックするか、またはノードを右クリックしてから「プロパティー」をクリックします。

値を入力する必要のある (デフォルト値が定義されていない) すべての必須プロパティーには、アスタリスクが表示されます。

MQGet ノードを構成します。

  1. オプション: 「説明」タブで、簡略説明詳細説明、あるいはその両方を入力します。このタブで、ノードを名前変更することもできます。
  2. 「基本」タブで、「キュー名」に、メッセージの取得元となるキューの名前を入力します。 この WebSphere MQ キューを、 メッセージ・フローをデプロイするブローカーのホストとして機能するキュー・マネージャーに対して事前定義する必要があります。 このキューが有効なキューではない場合、ノードは例外を生成して、入力メッセージは Failure ターミナルに伝搬されます。
  3. 「入力メッセージの構文解析」タブで、キュー・メッセージ の構文解析方法を決定するのにノードが使用するメッセージ・ドメイン、メッセージ・セット、メッセージ・タイプ、およびメッセージ形式を記述するプロパティーの値を設定し、メッセージに関連したデフォルト・トピックの値を設定します。
    • キュー・メッセージに 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 パーサーの場合、「メッセージ形式」はブランクのままにしてください。

  4. パーサー・オプション」サブタブで以下のようにします。
    1. 「解析のタイミング」は、デフォルトによって、「要求時」に設定されます。これにより、メッセージの妥当性検査が遅延されます。 メッセージが即時に解析されるようにするには、要求時の構文解析を参照してください。

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

    2. MQRFH2C パーサーが使用されるようにするには、「MQRFH2 ヘッダーには MQRFH2C コンパクト・パーサーを使用」を選択します。 デフォルトでは、このチェック・ボックスはクリアされていて、コンパクト・パーサーが使用されないことを示します。
    3. XMLNSC パーサーを使用する場合、XMLNSC パーサーの稼働方法を指定するプロパティーの値を設定します。 詳しくは、XMLNSC ドメインでのメッセージの操作を参照してください。
  5. 「拡張」タブで、拡張プロパティーの値を設定します。
    • このメッセージの処理方法についてのトランザクション特性を定義するには、リストから「トランザクション・モード」の値を選択します。
      • 「自動」を選択した場合、キュー・メッセージに持続のマークが付いている場合には同期点下で受信されます。メッセージに持続のマークがない場合、そのメッセージは同期点下で受信されません。出力ノードによってその後に伝搬される派生メッセージのトランザクション特性は、 出力ノードまたはメッセージ・フロー内の後続の他のノードが明示的にトランザクション特性をオーバーライドしない限り、入力メッセージが持続または非持続のどちらであるかによって決定されます。
      • 「はい」を選択すると、キュー・メッセージが同期点下で受信されます。メッセージ・フローと同じインスタンスの出力ノードによってその後に伝搬される派生メッセージは、 出力ノードまたはメッセージ・フロー内の後続の他のノードが明示的にトランザクションをオーバーライドしない限り、トランザクションとして送信されます。
      • 「いいえ」を選択すると、キュー・メッセージが同期点下で受信されません。メッセージ・フローと同じインスタンスの出力ノードによってその後に伝搬される派生メッセージは、出力ノードまたはメッセージ・フロー内の後続の他のノードがメッセージを同期点下に置くことを指定していない限り、非トランザクションとして送信されます。
    • リストから「生成モード」の値を選択して、出力メッセージに入っているどのコンポーネントが MQGet ノード内で生成され、どのコンポーネントが 入力メッセージから取得されるかを定義します。
      • 「なし」を選択した場合、 入力ツリーからのメッセージ内のすべてのコンポーネントは変更されないで伝搬されます。
      • 「メッセージ」を選択した場合 (デフォルト)、新規のメッセージ・コンポーネントがノードによって作成されますが、入力ツリーからの LocalEnvironment、Environment、および ExceptionList コンポーネントは変更されないで伝搬されます。
      • 「LocalEnvironment」 を選択した場合、 新規の LocalEnvironment コンポーネントがノードによって生成されますが、 入力ツリーからのメッセージ、Environment、および ExceptionList コンポーネントは変更されないで伝搬されます。
      • 「メッセージと LocalEnvironment」を選択した場合、 新規のメッセージ・コンポーネントおよび LocalEnvironment コンポーネントがノードによって生成されて、 入力ツリーからの Environment および ExceptionList コンポーネントは変更されないで伝搬されます。
    • 「生成モード」「メッセージ」または「メッセージと LocalEnvironment」のどちらかに指定した場合、「メッセージのコピー」の値をリストから選択して、メッセージのどの部分が MQGet ノード内で生成され、どの部分が 入力メッセージから取得されるかを定義します。
      • 「なし」を選択した場合 (デフォルト)、 伝搬される入力ツリーからの入力メッセージの部分はありません。
      • 「ヘッダーのコピー」を選択した場合、 入力ツリー内の入力メッセージにあるヘッダーが出力メッセージにコピーされます。
      • 「メッセージ全体のコピー」を選択した場合、 入力ツリーからの入力メッセージ全体が出力メッセージにコピーされます。
    • 「生成モード」「LocalEnvironment」 または 「メッセージと LocalEnvironment」 のどちらかに指定した場合、「ローカル環境のコピー」 の値をリストから選択して、ローカル環境のどの部分が MQGet ノード内で生成され、どの部分が入力メッセージから取得されるかを定義します。
      • メッセージ・フロー内の各ノードごとに、「LocalEnvironment 全体のコピー」 (デフォルト) を選択すると、ローカル環境の新しいコピーがツリー内に作成されて、前のノードのローカル環境の内容がそこに取り込まれます。 したがって、ノードによってローカル環境が変更されても、上流のノードは、それぞれ独自のコピーを保有しているので、そのような変更を認知しません。このような動作は、FlowOrder ノードを使用する場合や、Compute ノード上で propagate コマンドを使用する場合に問題になる可能性があります。 入力メッセージ内で定義されているローカル環境全体が、出力メッセージにコピーされます。
      • 「なし」を選択した場合、各ノードがそれぞれ独自のローカル環境のコピーを生成するのではなく、前のノードから渡されたローカル環境が使用されます。 したがって、ノードがローカル環境を変更した場合、その変更は上流のノードで認知されます。
    • 待機間隔 (ミリ秒)」プロパティーの値を指定して、 MQGET 呼び出しからメッセージを受け取るための待機時間をミリ秒単位で設定します。 値を指定しない場合、デフォルト値の 1000 ミリ秒が使用されます。
    • 「最小メッセージ・バッファー・サイズ (KB)」プロパティーの値を指定して、MQGET 呼び出しのための初期バッファーのサイズをキロバイト単位で設定します。 このバッファーは自動的に拡張して任意のサイズのメッセージを受け入れますが、 すべてのメッセージが大きいことが予想される場合は、適切な値を指定して、 バッファーをサイズ変更する頻度を少なくしてください。 値を指定しない場合、バッファーのサイズは 4 キロバイトになります。
  6. 「要求」タブで、要求パラメーターの構成方法を決定するプロパティーに値を設定します。
    • MQGET 呼び出しに使用される MQMD がデフォルト・ロケーションの InputRoot.MQMD ではない場合、 「入力 MQMD のロケーション」に MQMD のロケーションを指定します。
    • MQGET 呼び出しのパラメーターのロケーション (MQGMO オーバーライドなど) が デフォルト・ロケーション InputLocalEnvironment.MQ.GET ではない場合、 そのロケーションを「入力 MQ パラメーターのロケーション」に指定します。
    • 「相関 ID で取得」を選択した場合、検索するメッセージの「CorrelId」フィールドは 「入力 MQMD のロケーション」「CorrelId」フィールドと一致する必要があります。 デフォルトでは、このチェック・ボックスはクリアされています。
    • 「メッセージ ID で取得」を選択した場合、検索するメッセージの「MsgId」フィールドは 「入力 MQMD のロケーション」「MsgId」フィールドと一致する必要があります。 デフォルトでは、このチェック・ボックスはクリアされています。
    • 「完全入力 MQMD の使用」を選択した場合、「入力 MQMD のロケーション」のすべての MQMD フィールドが、メッセージの検索で使用されます。 MQMD ビット・ストリームが「入力 MQMD のロケーション」にある場合、ビット・ストリーム内のすべてのフィールドが使用されます。 検索されるメッセージの MQMD が、これらのフィールドに一致することを確認してください。 デフォルトでは、このチェック・ボックスはクリアされています。
  7. 「結果」タブで、MQGET 呼び出しの結果を処理する方法を決定するプロパティーに値を設定します。
    • 「出力データのロケーション」に、出力メッセージ・ツリー内でキュー・メッセージのビット・ストリングから構文解析されたエレメントが保管される開始位置を入力します。デフォルト値は、「OutputRoot」です。 このロケーションにあるすべてのエレメントは削除されて、デフォルト動作では入力ツリー・メッセージがキュー・メッセージに置き換わります。

      入力ツリーから伝搬したメッセージに応答を挿入するために、 メッセージ・ツリー内に新規ノードを作成するための新規フィールド・リファレンスを含む、 任意の有効な ESQL フィールド・リファレンス (このリファレンスには式を含めることができます) を入力できます。 例えば、OutputRoot.XMLNS.ABC.DEF および Environment.GotReply は有効なフィールド・リファレンスです。 詳細については、MQGet ノードを使用する要求-応答シナリオを参照してください。

      キュー・メッセージのビット・ストリングが構文解析されてメッセージ・ツリーの内容が作成されるとき、ノードの「入力メッセージの構文解析」プロパティーに指定したメッセージ・プロパティーが使用されます。

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

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

  8. メッセージ・セットに照らして各キュー・メッセージの本体をパーサーで妥当性検査するには、「妥当性検査」タブで妥当性検査プロパティーを設定します。 (メッセージがノードの Failure ターミナルに伝搬される場合には、妥当性検査は行われません。)

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

変更の始まり

メッセージ処理中のノード・プロパティーのオーバーライド

メッセージ・フローに MQGet ノードを組み込んで構成する際には、特定の条件下でプロパティーをオーバーライドすることもできます。例えば、メッセージの別の部分で識別されるキューや、データベース・レコードから取り出されるキューから読み取ることもできます。

MQGet ノード・プロパティーに関する設定値をオーバーライドして、メッセージをさらに動的に処理できるようにするには、メッセージ・フロー中の MQGet ノードの前に Compute または JavaCompute ノードを組み込んでください。新しい出力メッセージを作成するようにこのノードを構成し、フィールドを LocalEnvironment ツリーに追加して、変更するプロパティーの新規値を定義してください。

例えば、以下の ESQL ステートメントを組み込んで、フロー中に Compute ノードを追加し、MQGet ノードの新規キュー名を定義して、メッセージに関する読み取りを行います。

SET LocalEnvironment.MQ.GET.QueueName = 'new_queue';

LocalEnvironment.MQ.GET. は、MQGet ノードに関係するすべてのフィールドの相関名として使用します。

変更の終わり

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

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

ターミナルの接続

メッセージをさらに処理する場合、エラーを処理する場合、あるいはメッセージを追加の宛先に送信する場合は、このノードの 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 ノードのターミナルについては、次の表に説明されています。

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

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

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

プロパティー M C デフォルト 説明
ノード名 いいえ いいえ ノード・タイプ、MQGet ノードの名前。
簡略説明 いいえ いいえ ブランク ノードの簡単な説明
詳細説明 いいえ いいえ ブランク メッセージ・フロー内のノードの目的を説明するテキスト

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

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

MQGet ノードの「入力メッセージの構文解析」プロパティーについては、次の表に説明されています。

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

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

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

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

MQRFH2C コンパクト・パーサーを MQRFH2 ドメインに使用 いいえ いいえ 選択されていない このプロパティーは、MQRFH2 パーサーではなく、MQRFH2C コンパクト・パーサーを MQRFH2 ヘッダーに使用するかどうかを制御します。
XMLNSC コンパクト・パーサーを XMLNS ドメインに使用 いいえ いいえ 選択されていない このプロパティーは、XMLNS ドメイン内のメッセージに XMLNSC コンパクト・パーサーを使用するかどうかを制御します。 このプロパティーを設定した場合に、入力 MQRFH2 ヘッダーまたは「入力メッセージの構文解析」プロパティー「メッセージ・ドメイン」を XMLNS にすると、出力ターミナルに接続されているノードの XMLNSC の下にメッセージ・データが表示されます。
混合内容の保存 いいえ いいえ 選択されていない このプロパティーは、XMLNSC パーサーがキュー・メッセージ・メッセージ内で混合テキストを検出したときに、メッセージ・ツリー内にエレメントを作成するかどうかを制御します。 チェック・ボックスを選択すると、混合テキスト用のエレメントが作成されます。 このチェック・ボックスのチェックを外した場合、混合テキストは無視されて、エレメントは作成されません。
コメントの保存 いいえ いいえ 選択されていない このプロパティーは、XMLNSC パーサーがキュー・メッセージ・メッセージ内でコメントを検出したときに、メッセージ・ツリー内にエレメントを作成するかどうかを制御します。 チェック・ボックスを選択すると、コメント用のエレメントが作成されます。 このチェック・ボックスのチェックを外した場合、コメントは無視されて、エレメントは作成されません。
処理命令の保存 いいえ いいえ 選択されていない このプロパティーは、XMLNSC パーサーがキュー・メッセージ内で処理命令を検出したときに、メッセージ・ツリー内にエレメントを作成するかどうかを制御します。 チェック・ボックスを選択すると、処理命令用のエレメントが作成されます。 このチェック・ボックスのチェックを外した場合、処理命令は無視されて、エレメントは作成されません。

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

プロパティー M C デフォルト 説明
トランザクション・モード いいえ いいえ はい このプロパティーは、着信メッセージを同期点下で受信するかどうかを制御します。有効な値は、「自動」「はい」、および 「いいえ」 です。
生成モード いいえ いいえ メッセージ このプロパティーは、入力ツリーからのメッセージのどの部分がコピーされるかを制御します。 有効な値は、「メッセージ」「LocalEnvironment」「メッセージと LocalEnvironment」、および「なし」です。
メッセージのコピー いいえ いいえ なし このプロパティーは、入力ツリーからのメッセージのどの部分がコピーされるかを制御します。 有効な値は、「なし」「ヘッダーのコピー」、および「メッセージ全体のコピー」です。
ローカル環境のコピー いいえ いいえ LocalEnvironment 全体のコピー このプロパティーは、ローカル環境がどのように出力メッセージにコピーされるかを制御します。 メッセージ・フロー内のノードごとに、これを「LocalEnvironment 全体のコピー」に設定すると、ローカル環境の新しいコピーがツリー内に作成されて、前のノードのローカル環境の内容がそこに取り込まれます。 したがって、ノードによってローカル環境が変更されても、上流のノードは、それぞれ独自のコピーを保有しているので、そのような変更を認知しません。このような動作は、FlowOrder ノードを使用する場合や、Compute ノード上で propagate コマンドを使用する場合に問題になる可能性があります。

このプロパティーを「なし」に設定すると、各ノードがそれぞれ独自のローカル環境のコピーを生成するのではなく、前のノードから渡されたローカル環境が使用されます。 したがって、ノードがローカル環境を変更した場合、その変更は上流のノードで認知されます。

待機間隔 (ms) はい いいえ 1000 キュー・メッセージをメッセージ・キューから取得できるまで待機する最大時間をミリ秒で示します。
最小メッセージ・バッファー・サイズ (KB) はい いいえ 4 取得バッファーの最小サイズをキロバイトで示します。このプロパティーの最小値は、1 キロバイトです。

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

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

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

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

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

これらのプロパティーの詳細については、妥当性検査プロパティーを参照してください。
プロパティー M C デフォルト 説明
妥当性検査 いいえ はい なし このプロパティーは、妥当性検査を行うかどうかを制御します。 有効な値は、「なし」「内容」「内容と値」、および「継承」です。
失敗時の処置 いいえ いいえ 例外 このプロパティーは、妥当性検査が失敗した場合の動作を制御します。 「妥当性検査」「内容」または「内容と値」に設定した場合にのみ、このプロパティーを設定できます。有効な値は、「ユーザー・トレース」「ローカル・エラー・ログ」「例外」、および「例外リスト」です。
すべての値制約を含める いいえ いいえ True このプロパティーは編集できません。基本値制約検査が「内容と値」妥当性検査に含まれます。
固定 いいえ いいえ なし このプロパティーは編集できません。
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
最終更新 : 2009-02-20 12:42:57

ac20806_