WebSphere® MQ Enterprise Transport を使用してブローカーに接続し、MQI および AMI アプリケーション・プログラミング・インターフェースを使用するクライアントからのメッセージを受信するには、MQInput ノードを使用します。
このトピックには、以下のセクションが含まれています。
MQInput ノードは、ブローカーのキュー・マネージャー上に定義されている WebSphere MQ メッセージ・キューからのメッセージを受信します。 このノードでは、MQGET を使用して指定されたキューからメッセージを読み取り、メッセージの処理環境を確立します。 適切な場合には、入力キューを WebSphere MQ クラスター・キューまたは共有キューとして定義することができます。
WebSphere MQ 接続を経由して受信するメッセージを処理するメッセージ・フローは、常に MQInput ノードから開始されなければなりません。 MQInput ノードのプロパティーを設定すると、適切な MQGET オプションを設定できるので、メッセージの受信方法を制御できます。 例えば、メッセージをトランザクション制御下で処理するように指示できます。さらに、入力メッセージを受信するたびにデータ変換を実行するように要求することもできます。
MQInput ノードで開始されるメッセージ・フローに出力ノードを組み込む場合には、その出力ノードとして、サポートされるいずれかの出力ノード (ユーザー定義の出力ノードを含む) を使用できます。MQOutput ノードを組み込む必要はありません。 必要な任意の変換をブローカーに要求するようにメッセージ・フローを構成できますので、WebSphere MQ クライアントからメッセージを受け取り、サポートされる任意のトランスポートを使用してブローカーに接続するクライアント用のメッセージを生成する、メッセージ・フローを作成できます。
サブフローとして使用するメッセージ・フローを作成する場合には、標準入力ノードを使用することはできず、Input ノードを最初のノードとして使用して、サブフロー用の In ターミナルを作成する必要があります。
ご使用のメッセージ・フローが WebSphere MQ 接続を経由してメッセージを受け取らない場合には、サポートされる入力ノードのいずれかを選択できます。
MQInput ノードは、パレットの 「WebSphere MQ」ドロワーに含まれていて、WebSphere Message Broker Toolkit 内では、次のアイコンによって表されます。
サンプルに関する情報は、WebSphere Message Broker Toolkit に統合されているインフォメーション・センター、またはオンライン・インフォメーション・センターを使用する場合にのみ表示できます。 サンプルは、WebSphere Message Broker Toolkit に統合されているインフォメーション・センターを使用する場合にのみ実行できます。
MQInput ノードは、Out ターミナルに正常に取り出される各メッセージをルーティングします。 このアクションが失敗する場合、メッセージが再試行されます。 (入力キューの BackoutThreshold 属性によって定義されているように) バックアウト・カウントが超過した場合、メッセージは Failure ターミナルにルーティングされます。ノードをこのターミナルに接続し、この状態を処理することができます。 Failure ターミナルに接続しなかった場合、メッセージはバックアウト・キューに書き込まれます。
メッセージ・フロー内でさらに例外がスローされた後、このノードによってメッセージがキャッチされる場合、メッセージは Catch ターミナルにルーティングされます。 Catch ターミナルに接続しなかった場合、その問題が解決されるまで、メッセージはこのノードでループし続けます。
メッセージがノードを介してループし続けないようにするために、バックアウト・キューまたは送達不能キュー (DLQ) を定義する必要があります。
「参照のみ」プロパティーを設定した場合、メッセージを同期点下で参照することはできないので、「トランザクション・モード」プロパティーに設定された値は無視されます。 ただし、メッセージ・フローの同じインスタンスで出力ノードによって後から伝搬される派生メッセージはすべて、指定された「トランザクション・モード」値に従って、上記で説明した動作に従います。
MQGET バッファー・サイズは、ブローカーによって内部的にインプリメントされ、変更することはできません。 次の説明は単なる情報として提供されているものに過ぎません。 内部インプリメンテーションは変更される可能性があるので、メッセージ・フローを開発する際、これに頼ってはなりません。
MQInput ノードは、初期化時に最初の MQGET のデフォルト・バッファーのサイズを 4 KB に設定します。 MQInput ノードはメッセージのサイズをモニターし、次のようにバッファーのサイズを増減させます。
例えば、ノードが受信した最初のメッセージが 20 MB であり、次の 10 個のメッセージが、それぞれ 14 MB の場合、バッファーのサイズは 4 KB から 20 MB に増加され、10 個のメッセージに対しては 20 MB のままとなります。 ただし、10 番目のメッセージの後は、バッファーのサイズは 14 MB に削減されます。
MQInput ノードをメッセージ・フローに入れると、「プロパティー」ビューを使用してノードを構成できます。メッセージ・フロー・ノードの構成を参照してください。 ノードのプロパティーが、「プロパティー」ビューに表示されます。 デフォルト値が定義されていないすべての必須プロパティーには、アスタリスクのマークが付きます。
MQInput ノードのターミナルについては、次の表に説明されています。
ターミナル | 説明 |
---|---|
Failure | エラーが発生した場合にメッセージがルーティングされる出力ターミナル。 「妥当性検査」プロパティーが設定されている場合でも、このターミナルに伝搬されるメッセージは妥当性検査が行われません。 |
Out | WebSphere MQ キューからメッセージが正常に取り出された場合に、メッセージがルーティングされる出力ターミナル。 |
Catch | 例外がダウンストリームでスローされ、ノードによってキャッチされた場合に、メッセージがルーティングされる出力ターミナル。 |
以下の表は、ノード・プロパティーについて説明しています。 M の見出しの列は、プロパティーが必須 かどうかを示します (デフォルトが定義されていない場合に値を入力することが必要なら、アスタリスクのマークが付きます)。 C の見出しの列は、プロパティーが構成可能 (メッセージ・フローを BAR ファイルに追加してデプロイするとき、値を変更できる) かどうかを示します。
MQInput ノードの「説明」プロパティーについては、次の表に説明されています。
プロパティー | M | C | デフォルト | 説明 |
---|---|---|---|---|
ノード名 | いいえ | いいえ | ノード・タイプ、MQInput。 | ノードの名前。 |
簡略説明 | いいえ | いいえ | ノードの簡単な説明 | |
詳細説明 | いいえ | いいえ | メッセージ・フロー内のノードの目的を説明するテキスト |
MQInput ノードの基本プロパティーについては、次の表に説明されています。
プロパティー | M | C | デフォルト | 説明 | mqsiapplybaroverride コマンド・プロパティー |
---|---|---|---|---|---|
キュー名 | はい | はい | このノードが、このメッセージ・フローで処理するために (MQGET を使用して) メッセージを取り出す WebSphere MQ 入力キューの名前。 この WebSphere MQ キューを、メッセージ・フローをデプロイするブローカーのホストとして機能するキュー・マネージャーに対して事前定義する必要があります。 | queueName |
MQInput ノードの「入力メッセージの構文解析」プロパティーについては、次の表に説明されています。
<mcd><Msd>MRM</Msd><Set>DHM4UO906S001</Set><Type>receiptmsg1</Type>
<Fmt>XML</Fmt></mcd>
MQRFH2 ヘッダーの値とは異なる値を設定し、<Msd> エレメントが有効なドメインの場合には、MQRFH2 ヘッダーの値が優先されます。プロパティー | M | C | デフォルト | 説明 |
---|---|---|---|---|
メッセージ・ドメイン | いいえ | いいえ | BLOB | メッセージの構文解析に使用されるドメイン。 フィールドがブランクの場合、デフォルトは BLOB になります。 |
メッセージ・モデル | いいえ | いいえ | 選択されていない | メッセージが定義されているメッセージ・モデル・スキーマ・ファイルの名前またはロケーション。 このリストには、選択したメッセージ・ドメインに使用可能なすべてのメッセージ・モデル・スキーマ・ファイルが取り込まれます。 |
メッセージ | いいえ | いいえ | 選択されていない | メッセージ・モデル・スキーマ・ファイル内のメッセージ・ルートの名前またはロケーション。 このリストには、選択したメッセージ・モデルで定義された、利用可能なすべてのメッセージが取り込まれます。 |
物理形式 | いいえ | いいえ | 選択されていない | メッセージの物理フォーマットの名前。 MRM または IDOC パーサーを使用する場合は、リストから着信メッセージの物理形式を選択します。 このリストには、選択されたメッセージ・モデル用に定義したすべての物理形式が含まれます。 「メッセージ・ドメイン」プロパティーを DataObject に設定した場合、このプロパティーを XML または SAP ALE IDoc に設定できます。 外部ソースからのビット・ストリームを構文解析してメッセージ・ツリーを生成する必要がある場合には、このプロパティーを SAP ALE IDoc に設定してください。 |
MQInput ノードのパーサー・オプションのプロパティーについては、次の表に説明されています。
プロパティー | M | C | デフォルト | 説明 |
---|---|---|---|---|
構文解析のタイミング | いいえ | いいえ | 要求時 | このプロパティーは、入力メッセージを構文解析する時を制御します。 有効な値は、「要求時」、「即時」、
および「完全」です。 「解析のタイミング」は、デフォルトによって、「要求時」に設定されます。これにより、メッセージの構文解析が遅延されます。 メッセージが即時に解析されるようにするには、要求時の構文解析を参照してください。 |
MQRFH2C コンパクト・パーサーを MQRFH2 ヘッダーに使用 | いいえ | いいえ | 選択されていない | このプロパティーは、MQRFH2 パーサーの代わりに、MQRFH2C コンパクト・パーサーを MQRFH2 ヘッダーに使用するかどうかを制御します。 |
XML スキーマ・データ・タイプを使用してツリーを構築する | いいえ | いいえ | 選択されていない | このプロパティーは、XML スキーマから取得されたデータ・タイプを使って、XMLNSC パーサーがメッセージ・ツリー内に構文エレメントを作成するかどうかを制御します。 「妥当性検査」タブ上の「妥当性検査」プロパティーを「内容」 または 「内容と値」 に設定した場合にのみ、このプロパティーを選択できます。 |
XMLNSC コンパクト・パーサーを XMLNS ドメインに使用 | いいえ | いいえ | 選択されていない | このプロパティーは、XMLNS ドメイン内のメッセージに XMLNSC コンパクト・パーサーを使用するかどうかを制御します。 このプロパティーを設定すると、入力 MQRFH2 ヘッダーまたは「入力メッセージの構文解析」プロパティー「メッセージ・ドメイン」が XMLNS の場合に、出力ターミナルに接続されているノードの XMLNSC の下にメッセージ・データが表示されます。 詳しくは、XMLNSC ドメインでのメッセージの操作を参照してください。 |
混合内容の保存 | いいえ | いいえ | 選択されていない | このプロパティーは、XMLNSC パーサーが入力メッセージ内に混合テキストを検出したとき、メッセージ・ツリー内にエレメントを作成するかどうかを制御します。 チェック・ボックスを選択すると、混合テキスト用のエレメントが作成されます。 このチェック・ボックスのチェックを外した場合、混合テキストは無視されて、エレメントは作成されません。 |
コメントの保存 | いいえ | いいえ | 選択されていない | このプロパティーは、XMLNSC パーサーが入力メッセージ内にコメントを検出したとき、メッセージ・ツリー内にエレメントを作成するかどうかを制御します。 チェック・ボックスを選択すると、コメント用のエレメントが作成されます。 このチェック・ボックスのチェックを外した場合、コメントは無視されて、エレメントは作成されません。 |
処理命令の保存 | いいえ | いいえ | 選択されていない | このプロパティーは、XMLNSC パーサーが入力メッセージ内に処理命令を検出したとき、これらのメッセージ・ツリー内にエレメントを作成するかどうかを制御します。 チェック・ボックスを選択すると、処理命令用のエレメントが作成されます。 このチェック・ボックスのチェックを外した場合、処理命令は無視されて、エレメントは作成されません。 |
不透明エレメント | いいえ | いいえ | ブランク | XMLNSC パーサーによって不透明解析される入力メッセージ内のエレメントのリストを指定するときに、このプロパティーを使用します。 不透明解析が実行されるのは、妥当性検査が使用不可に設定されている場合のみ (つまり、「妥当性検査」が「なし」の場合) です。妥当性検査が使用可能な場合、「不透明エレメント」で指定される項目は無視されます。 |
MQInput ノードの拡張プロパティーについては、次の表に説明されています。 メッセージの処理方法を決定するプロパティー (トランザクション特性など) を設定します。 これらのプロパティーの多くは MQGET 呼び出しのオプションにマップされます。
プロパティー | M | C | デフォルト | 説明 | mqsiapplybaroverride コマンド・プロパティー |
---|---|---|---|---|---|
トランザクション・モード | はい | いいえ | はい | このプロパティーは、着信メッセージを同期点下で受信するかどうかを制御します。 有効な値は、「自動」、「はい」、および「いいえ」です。
|
|
順序モード | はい | いいえ | デフォルト | 入力キューからメッセージを取り出して処理する順序。 到着メッセージは順番に処理することができます。または、準備できたメッセージであればいずれかのスレッドが処理できます。 順序付けが実施された場合、スレッドは固有の順序付け値を持つ最初の使用可能未処理メッセージのみ処理します。 有効な値は、「デフォルト」、「ユーザー ID 順」、「キュー順序」、および「ユーザー定義」です。 このプロパティーは、「インスタンス」タブ上の「メッセージ・フロー」プロパティー 「追加インスタンス」をゼロより大きい値に設定した (つまり、複数のスレッドが入力キューを読み取る) 場合にのみ有効です。 有効な値は以下のとおりです。
このオプションの使用の詳細については、メッセージ・フロー・スループットの最適化およびWebSphere MQ メッセージ・グループ内のメッセージの受信を参照してください。 |
|
順序フィールドのロケーション | N | N | "" | 「順序モード」が「ユーザー定義」のときに、メッセージのどの部分を使用して着信メッセージに対して順序付けを実施するかを制御するための XPath または ESQL 式プロパティー。 そのフィールドがない場合は例外が発生し、メッセージはロールバックされます。 NULL 値と空の値は別々に並行処理されます。 |
|
論理順序 | はい | いいえ | 選択されている | このチェック・ボックスを選択すると、メッセージは、WebSphere MQ で定義された論理順序で受信されます。
このオプションは、MQI の MQGMO の MQGMO_LOGICAL_ORDER オプションにマップされます。 このチェック・ボックスのチェックを外した場合、グループの一部として送信されるメッセージは事前に決定された順序で受信されません。 ブローカーがグループ内のメッセージを受信する必要があり、このチェック・ボックスを選択していない場合は、入力メッセージの順序を重要視しないか、またはメッセージ・フローを設計してメッセージを適切に処理する必要があります。 グループの最後のメッセージが受信および処理された後にのみメッセージ処理をコミットする場合は、「メッセージ・グループによるコミット」も選択する必要があります。 このプロパティーをマップするオプションの詳細は、WebSphere MQ バージョン 7 インフォメーション・センター・オンラインの「アプリケーション・プログラミング・リファレンス」セクションに記載されています。 このオプションの使用については、WebSphere MQ メッセージ・グループ内のメッセージの受信を参照してください。 |
|
すべてのメッセージが使用可能 | はい | いいえ | 選択されていない | 単一グループ内のすべてのメッセージが使用できるときのみメッセージ検索および処理を行う場合は、「すべてのメッセージが使用可能」を選択します。
このプロパティーは MQI の MQGMO の MQGMO_ALL_MSGS_AVAILABLE オプションにマップされます。 グループ内のメッセージすべての検索が使用できなくても処理を開始できるようにするには、このチェック・ボックスのチェックを外してください。 このプロパティーをマップするオプションの詳細は、WebSphere MQ バージョン 7 インフォメーション・センター・オンラインの「アプリケーション・プログラミング・リファレンス」セクションに記載されています。 |
|
一致するメッセージ ID | いいえ | いいえ | 着信メッセージの MQMD 内のメッセージ ID と一致する必要のあるメッセージ ID。 MQMD の「MsgId」フィールドのメッセージ ID 値と一致するメッセージ ID のメッセージのみを入力ノードに受信させる場合には、メッセージ ID を入力します。 最大 48 桁までの偶数桁の 16 進数字 (文字 0 から 9、A から F、および a から f が有効) を入力します。 入力した一致するメッセージ ID が「MsgId」フィールドのサイズより短い場合、「一致するメッセージ ID」の右側に X'00' 文字が埋め込まれます。 このプロパティーは、MQI の MQGMO の MQMO_MATCH_MSG_ID オプションにマップされます。 メッセージ ID が一致することを入力ノードに確認させたくない場合は、このプロパティーはブランクのままにしてください。 このプロパティーをマップするオプションの詳細は、WebSphere MQ バージョン 7 インフォメーション・センター・オンラインの「アプリケーション・プログラミング・リファレンス」セクションに記載されています。 |
||
一致する相関 ID | いいえ | いいえ | 着信メッセージの MQMD 内の相関 ID と一致する必要のある相関 ID。 MQMD の「CorrelId」フィールドの相関 ID 値と一致するメッセージ ID のメッセージのみを入力ノードに受信させる場合には、メッセージ ID を入力します。 最大 48 桁までの偶数桁の 16 進数字 (文字 0 から 9、A から F、および a から f が有効) を入力します。 入力した ID が「CorrelId」フィールドのサイズより短い場合、右側に X'00' 文字が埋め込まれます。 このプロパティーは MQI の MQGMO の MQMO_MATCH_CORREL_ID オプションにマップされます。 CorrelID が一致することを入力ノードに確認させたくない場合は、このプロパティーはブランクのままにしてください。 このプロパティーをマップするオプションの詳細は、WebSphere MQ バージョン 7 インフォメーション・センター・オンラインの「アプリケーション・プログラミング・リファレンス」セクションに記載されています。 |
||
変換 | はい | いいえ | 選択されていない | このチェック・ボックスを選択すると、WebSphere MQ は、MQMD に設定された CodedCharSetId および Encoding の値に従って受信するメッセージのデータを変換します。 キューからメッセージを取り出すときに WebSphere MQ でメッセージのデータ変換を行う場合は、「変換」を選択します。 このオプションは、BLOB ドメインのメッセージを処理する場合、あるいはユーザー定義パーサーを使用する場合に有用です。 パーサーは変換を実行するため、XML または MRM ドメインを使用してメッセージを構文解析する場合は、このオプションを選択しないでください。 入力キューからメッセージを取り出すときに、WebSphere MQ は着信メッセージを、MQMD に指定されたエンコードおよびコード化文字セットに変換します。 この MQMD は入力ノードが MQGET 呼び出しで指定したものです。 ブローカーは、MQGET 呼び出しで MQGMO_CONVERT オプションを使用します。WebSphere MQ 変換の通常ルールが適用されます。 「エンコードの変換」 および 「コード化文字セット ID の変換」 オプションで指定した値は、MQGET 呼び出しの「MsgDesc エンコード」フィールドおよび「CCSID」フィールドで使用されます。 WebSphere MQ は、MQMD 「フォーマット」フィールドが文字データを識別する組み込み WebSphere MQ 値であるか、データ変換出口が WebSphere MQ に存在する場合にのみ、着信メッセージを変換できます。 このプロパティーは MQI の MQGMO の MQGMO_CONVERT オプションにマップされます。 WebSphere MQ がメッセージを変換しないようにするには、チェック・ボックスのチェックを外します。 このチェック・ボックスを選択した場合には、「エンコードの変換」および「コード化文字セット ID の変換」プロパティーの値を指定することもできます。 WebSphere MQ データ変換、およびこのオプションの使用を選択する理由の詳細については、WebSphere MQ バージョン 7 インフォメーション・センター・オンラインの「アプリケーション・プログラミング・ガイド」セクションを参照してください。 |
|
変換エンコード | いいえ | いいえ | メッセージ・データの数値 (整数値で表される) に使用する表現。 「変換」を選択した場合にのみ、このプロパティーは有効です。 メッセージ本体内の数値データを変換するためのエンコードを表す番号を入力します。 有効な値は以下のとおりです。
「変換エンコード」に指定できる値の詳細については、データ変換および WebSphere MQ バージョン 7 インフォメーション・センター・オンラインの「アプリケーション・プログラミング・リファレンス」セクションを参照してください。 |
||
変換コード化文字セット ID | いいえ | いいえ | 整数値として表されたメッセージ・データの文字データのコード化文字セット ID。 「変換」を選択した場合にのみ、このプロパティーは有効です。 メッセージ本体内の文字データを変換するための文字セット ID を表す値を入力します。 誤った値を指定した場合、変換は行われません。 「変換コード化文字セット ID」に指定できる値の詳細については、WebSphere MQ バージョン 7 インフォメーション・センター・オンラインの「アプリケーション・プログラミング・リファレンス」セクションを参照してください。 |
||
メッセージ・グループ別のコミット | はい | いいえ | 選択されていない | このプロパティーは、メッセージ・グループの一部であるメッセージを処理する場合、いつトランザクションをコミットするかを制御します。
このチェック・ボックスを選択すると、メッセージ・グループが処理された時にトランザクションがコミットされます。 このチェック・ボックスのチェックを外したままにしておく場合、それぞれのメッセージがメッセージ・フローを介して完全に伝搬されるごとに
コミットが実行されます。 このプロパティーは「論理順序」を選択した場合のみ関係します。 キューに出力される順序でグループ内のメッセージを検索および処理する必要がある場合には、「順序モード」プロパティーを「キュー順序」に設定します。 |
|
z/OS 逐次化トークン | いいえ | いいえ | z/OS のみ:
逐次化されたアプリケーション・サポート用のユーザー定義トークン。 指定する値は、WebSphere MQ MQCNO 構造の有効な ConnTag の規則に準拠している必要があります。 WebSphere MQ によって提供される共用リソースへの逐次化されたアクセスを使用する場合は、逐次化トークンを入力します。 逐次化トークンに提供する値は、WebSphere MQ バージョン 7 インフォメーション・センター・オンラインの「アプリケーション・プログラミング・リファレンス」セクションで説明されている規則に準拠していなければなりません。 z/OS における逐次化およびキュー共有の詳細については、WebSphere MQ バージョン 7 インフォメーション・センター・オンラインの「概説および計画ガイド」セクションを参照してください。 |
serializationToken | |
トピック | いいえ | はい | 入力メッセージ用のデフォルト・トピック。 このプロパティーを使用して、メッセージをパブリッシュ/サブスクライブ・トピックと関連付けることができます。 トピック名として任意の文字を入力できます。 メッセージが MQInput ノードを移動するときは、入力したトピック名を採用します。 (パブリッシュ/サブスクライブを使用する場合は、トピックにサブスクライブし、MQInput ノードを通ってそのトピック名の下にパブリッシュされたメッセージを参照することができます。) 着信メッセージに MQRFH2 ヘッダーがある場合には、その MQRFH2 ヘッダーの <psc> フォルダーから値を取り込めるため、「トピック」プロパティーの値を設定する必要はありません。例えば、以下のようになっています。
「トピック」プロパティーの値に、MQRFH2 ヘッダーの <Topic> の値とは異なる値を設定すると、MQRFH2 ヘッダーの値が優先されます。 |
topicProperty | |
参照のみ | いいえ | いいえ | 選択されていない | このプロパティーは、メッセージが読み取られたら、キューから除去するかどうかを制御します。 このチェック・ボックスを選択すると、メッセージは読み取られても、キューから除去されません。 このオプションを選択した場合に、メッセージが MQInput ノードの出力ターミナルに伝搬されると、OutputLocalEnvironment.MQ.GET.Browsed は真に設定されます。 | |
参照タイムアウトのリセット (ms) | はい | はい | -1 | 入力キュー上での最後の適格なメッセージの参照から、参照がキューの先頭にリセットされるまでの時間 (ミリ秒)。 デフォルト値の -1 は、参照がリセットされないことを示します。 |
MQInput ノードの「妥当性検査」プロパティーについては、次の表に説明されています。 メッセージ・セットに照らしてメッセージの本体をパーサーで妥当性検査するには、これらのプロパティーを設定します。 (メッセージがノードの Failure ターミナルに伝搬される場合には、妥当性検査は行われません。)
詳細については、メッセージの妥当性検査および妥当性検査プロパティーを参照してください。
プロパティー | M | C | デフォルト | 説明 | mqsiapplybaroverride コマンド・プロパティー |
---|---|---|---|---|---|
妥当性検査 | いいえ | はい | なし | このプロパティーは、妥当性検査を行うかどうかを制御します。 有効な値は、「なし」、「内容」、および「内容と値」です。 | validateMaster |
失敗時の処置 | いいえ | いいえ | 例外 | このプロパティーは、妥当性検査が失敗した場合の動作を制御します。 「妥当性検査」を「内容」または「内容と値」に設定した場合にのみ、このプロパティーを設定できます。 有効な値は、「ユーザー・トレース」、「ローカル・エラー・ログ」、「例外」、および「例外リスト」です。 |
MQInput ノードのセキュリティー・プロパティーについては、次の表に説明されています。 セキュリティー・プロファイルがノードに関連付けられている場合に、メッセージからの ID の抽出を制御するプロパティーの値を設定します。 これらのプロパティーの詳細については、ID、ID またはセキュリティー・トークンの抽出の構成、メッセージ・フローのセキュリティーの概要、およびメッセージ・フロー・セキュリティーのセットアップを参照してください。
プロパティー | M | C | デフォルト | 説明 |
---|---|---|---|---|
ID トークンのタイプ | いいえ | いいえ | なし | このプロパティーは、着信メッセージ内にある ID トークンのタイプを指定します。 有効な値は以下のとおりです。
|
ID トークンのロケーション | いいえ | いいえ | なし | このプロパティーは、メッセージ内のどこで ID を見つけられるかを指定します。 位置は、ESQL フィールド参照、XPath 式、またはストリング・リテラルで指定します。 ストリング・リテラルを使用する場合、それを単一引用符で囲む必要があります。このリテラルにピリオド (.) は含めないでください。 このプロパティーが指定されない場合、MQMD.UserIdentifier トランスポート・ヘッダーから ID が取得されます。 |
ID パスワードのロケーション | いいえ | いいえ | なし | このプロパティーは、メッセージ内のどこでパスワードを見つけられるかを指定します。 位置は、ESQL フィールド参照、XPath 式、またはストリング・リテラルで指定します。 ストリング・リテラルを使用する場合、それを単一引用符で囲む必要があります。このリテラルにピリオド (.) は含めないでください。 このプロパティーが指定されない場合、パスワードは設定されません。 このプロパティーは、「ID トークン・タイプ」が Username + Password に設定されている場合にのみ設定できます。 |
ID issuedBy のロケーション | いいえ | いいえ | なし | このプロパティーは、ID の発行者を記述するストリングまたはパス式を指定します。 位置は、ESQL フィールド参照、XPath 式、またはストリング・リテラルで指定します。 ストリング・リテラルを使用する場合、それを単一引用符で囲む必要があります。このリテラルにピリオド (.) は含めないでください。この値は、WS-Trust v1.3 STS プロバイダーに渡される発行者を指定します。 このプロパティーを指定しないと、MQMD.PutApplName 値が使用されます。 「ID issuedBy のロケーション」フィールドをブランクのままにした場合に、MQMD.PutApplName もブランクであると、ストリング MQ が使用されます。 |
セキュリティー例外を通常の例外として扱う | いいえ | いいえ | False | このプロパティーは、セキュリティー例外 (「アクセス拒否」など) を通常の例外として扱い、それらを Failure ターミナル (接続されている場合) へ伝搬するかどうかを指定します。 デフォルトでは、このプロパティーはオフになっています。これにより、Failure ターミナルが接続されている場合であっても、セキュリティーの例外があると、メッセージは必ずバックアウトされることになります。 |
プロパティー | M | C | デフォルト | 説明 | mqsiapplybaroverride コマンド・プロパティー |
---|---|---|---|---|---|
追加インスタンス・プール | いいえ | はい | メッセージ・フローに関連付けられたプールの使用 | 追加インスタンスの取得元のプール。
|
componentLevel |
追加インスタンス | いいえ | はい | 0 | 「追加インスタンス・プール」プロパティーが「ノードに関連付けられたプールの使用」に設定されている場合に、ノードが開始できる追加インスタンスの数。 デフォルトでは、ノードへの追加インスタンスはありません。 | additionalInstances |
プロパティー | M | C | デフォルト | 説明 |
---|---|---|---|---|
イベント | いいえ | いいえ | なし | ノードに対して定義したイベントが、このタブに表示されます。 デフォルトでは、メッセージ・フローのどのノードに対してもモニター・イベントは定義されません。 ノードのモニター・イベントを作成、変更、または削除するには、「追加」、「編集」、および「削除」を使用します。詳しくは、モニター・プロパティーを使用したモニター・イベント・ソースの構成を参照してください。 「使用可能」チェック・ボックスを選択またはクリアすることによって、ここに表示されているイベントを使用可能および使用不可に設定できます。 |