MQSeries アダプター構成プロパティ
次の表に、MQSeries アダプターの受信場所に設定できる構成プロパティを示します。
| プロパティ名 | Type | 説明 | 制限 | 説明 |
|---|---|---|---|---|
| uri | VT_BSTR | 受信場所で監視する場所への完全なパスを指定します。 | 送信ポートまたは受信場所の URI は 256 文字以内で指定してください。 | なし |
| queueDetails | VT_BSTR | サーバー、キュー マネージャー、およびキューを含むソースの MQSeries キューに関する情報を指定します。 | - None | このプロパティの前には、uri プロパティを作成するための MQS:// が付きます。 |
| transactionSupported | VT_BSTR | MQSeries アダプターが、BizTalk Server と MQSeries Server 間の Microsoft 分散トランザクション コーディネーター (DTC) トランザクションを開始するかどうかを指定します。 | 有効な値は次のとおりです。 -はい -いいえ |
no に設定すると、メッセージ配信が保証されません。 既定値は yes です。 |
| suspendAsNonResumable | VT_BSTR | 保留されたメッセージを再開可能に設定するかどうかを指定します。 | 有効な値は次のとおりです。 -はい -いいえ |
既定値は no です。 |
| dataOffsetForHeaders | VT_BSTR | アダプタは、MQSeries ヘッダー (MQXQH 構造、MQIIH 構造、および MQCIH 構造) の値を使用して、BizTalk Server のコンテキスト プロパティの対応する値を設定します。 既定では、アダプタは、メッセージのボディ部から MQSeries プロパティを削除します。 | 有効な値は次のとおりです。 -はい -いいえ |
メッセージ本文のプロパティを保存する場合は、このプロパティに no を設定してください。 既定値は yes です。 |
| pollingInterval | VT_BSTR | MQSeries キューをポーリングするために受信コンポーネントによって使用される間隔を指定します。 | 有効な値は 1 から 10000 です。 | pollingInterval は、アダプターに組み込まれている 3 秒の待機間隔 (ハードコードされている) と共に使用されます。 pollingInterval の値が 3 秒未満の場合、待機間隔には、pollingInterval の値が設定されます。 既定値は、3 です。 |
| pollingUnit | VT_BSTR | ポーリング間隔に使用する時間単位を指定します。 | 有効な値は次のとおりです。 -時間 -分 -秒 |
既定値は、seconds です。 |
| maximumBatchSize | VT_BSTR | メッセージの最大バッチ サイズを KB 単位で指定します。 | 有効な値は 1 ~ 10485760 | 既定値は 100 です。 |
| maximumNumberOfMessages | VT_BSTR | バッチ内に含めるメッセージの最大数を指定します。 | 有効な値は 1 から 100000 です | 既定値は 100 です。 |
| threadCount | VT_BSTR | 受信場所ごとに使用されるスレッド数を指定します。 | 有効な値は 1 ~ 64 です。 | 既定値は 2 です。 |
| fragmentationSize | VT_BSTR | MQSAgent とアダプターとの間でメッセージが送信されるときのメッセージ チャンク サイズを KB 単位で指定します。 | 有効な値は 1 ~ 1048576です。 | 既定値は 500 です。 |
| characterSet | VT_BSTR | メッセージを受信場所に送信する前に、文字セットと MQSeries が文字を変換するかどうかを指定します。 | 有効な値は次のとおりです。 -なし。 UCS-2 および UTF-16 を変換しません。 - UCS-2 と UTF-16。 これらの文字セットに変換します。 MQSeries は、これらの文字セットを区別しません。 - UTF-8。 UTF-8 文字セットに変換します。 |
既定値は none です。 |
| errorThreshold | VT_BSTR | ログに記録するエラーの最大数を指定します。 アダプタは処理を続行し、アダプタが回復すると、イベント ログにイベントを書き込みます。 | 有効な値は 1 ~ 1000 です。 | 既定値は 10 です。 |
| セグメント化 | VT_BSTR | MQSeries がセグメント化されたメッセージをアセンブルするか、メッセージをそのまま取得するかを指定します。 | 有効な値は次のとおりです。 -なし -完了 |
セグメント化を有効にせずに MQSeries キューからメッセージを読み込むには、none を指定します。 セグメント化されたメッセージをアダプターに渡す前にアセンブルするには、complete を指定します。 既定値は none です。 |
| ordered | VT_BSTR | MQSeries が、MQSeries キューからメッセージを受信するときのメッセージ順序を保存するかどうかを指定します。 | 有効な値は次のとおりです。 -いいえ - noStop - yesStop - yesSuspend |
メッセージの順序を無視する場合は、no を指定します。 メッセージの順序を無視し、エラーが発生した場合に受信場所を無効にするには、noStop を指定します。 順序を有効にする場合は、yesStop を指定します。 このオプションを選択した場合、エラーが発生すると、トランザクションが終了され、受信場所が無効になります。 順序を有効にする場合は、yesSuspend を指定します。 このオプションを選択した場合、エラーが発生すると、メッセージが保留キューに移動されます。 エラーが発生した場合、順序は保存されませんが、受信場所でメッセージの受信が続行します。 既定値は no です。 |
次のコードは、プロパティの設定に使用する文字列の形式を示しています。
<CustomProps><AdapterConfig vt="8"><Config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"><uri>MQS://TESTMQServer/DQM1/RQ0</uri><queueDetails>TESTMQServer/DQM1/RQ0</queueDetails><transactionSupported>yes</transactionSupported><suspendAsNonResumable>no</suspendAsNonResumable><dataOffsetForHeaders>yes</dataOffsetForHeaders><pollingInterval>1</pollingInterval><pollingUnit>seconds</pollingUnit><maximumBatchSize>100</maximumBatchSize><maximumNumberOfMessages>100</maximumNumberOfMessages><threadCount>2</threadCount><fragmentationSize>500</fragmentationSize><characterSet>none</characterSet><errorThreshold>10</errorThreshold><segmentation>none</segmentation><ordered>no</ordered></Config></AdapterConfig></CustomProps>
次の表に、MQSeries アダプターの送信ポートに設定できる構成プロパティを示します。
| プロパティ名 | Type | 説明 | 制限 | 説明 |
|---|---|---|---|---|
| uri | VT_BSTR | データの送信先の完全なパスを指定します。 | 送信ポートまたは受信場所の URI は 256 文字以内で指定してください。 | なし |
| queueDetails | VT_BSTR | サーバー、キュー マネージャー、およびキューを含むターゲットの MQSeries キューに関する情報を指定します。 | 送信ポートまたは受信場所の URI は 256 文字以内で指定してください。 | このプロパティの前には、uri プロパティを作成するための MQS:// が付きます。 |
| transactionSupported | VT_BSTR | MQSeries アダプターが、BizTalk Server と MQSeries Server 間の Microsoft 分散トランザクション コーディネーター (DTC) トランザクションを開始するかどうかを指定します。 | 有効な値は次のとおりです。 -はい -いいえ |
no に設定すると、メッセージ配信が保証されません。 既定値は yes です。 |
| dataConversion | VT_BSTR | MQSeries for Windows サーバーの ANSI コード ページにメッセージを変換するかどうかを指定します。 | 有効な値は次のとおりです。 -はい -いいえ |
既定値は no です。 |
| segmentationAllowed | VT_BSTR | 個別のメッセージが MQSeries キューのメッセージの最大長を超えた場合に MQSeries キュー マネージャーのセグメント化を使用するかどうかを指定します。 | 有効な値は次のとおりです。 -はい -いいえ |
既定値は no です。 |
| fragmentationSize | VT_BSTR | アダプターと MQSAgent との間でメッセージが送信されるときのメッセージ チャンク サイズを KB 単位で指定します。 | 有効な値は 1 から1048576です。 | 既定値は 500 です。 |
| ordered | VT_BSTR | MQSeries が、MQSeries キューにメッセージが送信されるときのメッセージ順序を保持するかどうかを指定します。 | 有効な値は次のとおりです。 -はい -いいえ |
既定値は no です。 |
次のコードは、プロパティの設定に使用する文字列の形式を示しています。
<CustomProps><AdapterConfig vt="8"><Config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"><uri>MQS://TESTMQServer/DQM1(QM1)/SQ0</uri><queueDetails>TESTMQServer/DQM1(QM1)/SQ0</queueDetails><transactionSupported>yes</transactionSupported><dataConversion>no</dataConversion><segmentationAllowed>no</segmentationAllowed><fragmentationSize>500</fragmentationSize><ordered>no</ordered></Config></AdapterConfig></CustomProps>
Note
Adapter Framework を使用して構築されたアダプターの TransportTypeData 構成データを指定する場合、使用される名前と値のペアはすべて AdapterConfig> 要素に<格納する必要があります。 AdapterConfig> 要素は<VT_BSTR (vt="8") データ型を指定するため、<>データ内の文字をエスケープする必要があります。