MSMQ の受信場所を構成する方法
MSMQ の受信場所のアダプター変数は、BizTalk Server 管理コンソールで設定できます。 プロパティが受信場所に設定されていない場合は、BizTalk Server 管理コンソールで設定された既定の受信ハンドラーの値が使用されます。
Note
次の手順を実行する前に、受信ポートを追加する必要があります。 詳細については、「 受信ポートを作成する方法」を参照してください。
重要
ホスト インスタンスが MSMQ 送信ポートまたは受信場所に関連付けられている場合、そのコンピューターで MSMQ サービスが実行されていることを確認してください。 サービスが実行されていない場合、MSMQ 受信ポートは、起動後すぐにシャットダウンされ、MSMQ 送信ポートに送信されたメッセージは中断されます。
クラスター環境では、クラスター化された MSMQ インスタンスが実行されていることに加え、各クラスター コンピューターでローカル MSMQ サービスが実行されている必要があります。
MSMQ の受信場所の変数を構成するには
MSMQ の受信場所の変数を構成するには、次の手順を実行します。
BizTalk Server管理コンソールで、[BizTalk Server管理]、[BizTalk グループ]、[アプリケーション] の順に展開し、受信場所を作成するアプリケーションを展開します。
BizTalk Server管理コンソールの左側のウィンドウで、[受信ポート] ノードをクリックします。 次に右ウィンドウで、既存の受信場所に関連付けられているか、新しい受信場所に関連付ける受信ポートを右クリックし、[ プロパティ] をクリックします。
[ 受信ポートのプロパティ ] ダイアログ ボックスの左側のウィンドウで [ 受信場所] を選択し、右側のウィンドウで既存の受信場所をダブルクリックするか、[ 新規] をクリックして新しい受信場所を作成します。
[受信場所のプロパティ] ダイアログ ボックスの [種類] の横にある [トランスポート] セクションで、ドロップダウン リストから [MSMQ] を選択し、[構成] をクリックします。
[ MSMQ トランスポートのプロパティ ] ダイアログ ボックスで、次の操作を行います。
プロパティ 目的 日付型 既定値 パスワード リモート キューに使用するパスワードを設定します。 String 空白 ユーザー名 リモート キューにアクセスするため、パスワードと組み合わせて使用するユーザー名を設定します。 リモート コンピューターのローカル ユーザーは、ユーザー名に使用できません。 String 空白 バッチ サイズ バッチ サイズを構成します。 MSMQ アダプターでは、メッセージがメッセージ ボックス データベースにバッチ単位で送信されます。 既定のバッチ サイズは 20 で、最小値は 1 です。 メモ： 受信場所の トランザクション プロパティが True に設定されている場合。各メッセージ バッチは、Microsoft 分散トランザクション コーディネーター (MSDTC) トランザクションのコンテキストで MessageBox データベースに送信されます。 メッセージ バッチ用に作成された MSDTC トランザクションは、そのメッセージ バッチのすべてのメッセージがメッセージ ボックスに保存され、適切なサブスクライバー キューに置かれるまで、開いたままになります。 したがって、 バッチ サイズ パラメーターが増加すると、この MSDTC トランザクションの期間が長くなります。 同時に多数の MSDTC トランザクションを開くと、全体的なパフォーマンスに悪影響を及ぼす可能性があるため、トランザクション サポートが有効になっている場合は 、Batch Size パラメーターを非常に大きな値に設定しないでください。 int 20 失敗した場合 エラーに対するアダプターの対応方法を指定します。 このプロパティには、次のいずれかの値を設定します。
- 停止。 エラー状態が発生した場合は、この受信場所からメッセージの受信を停止します。
- Suspend(再開不可)。 メッセージを中断し、再開不可としてマークします。
- Suspend(resumable)。 メッセージを中断し、再開可能としてマークします。 大事な：順序付き処理プロパティの True オプション、On Failure プロパティの Stop オプション、およびトランザクション プロパティの False オプションが同時に適用される場合、配信に失敗したメッセージは一時停止されず、ソース キューに残りません。 この場合、メッセージが失われる可能性があります。 データ損失を防ぐために、順序付け処理機能を使用する場合は、トランザクション プロパティの True オプションが適用されている場合にのみ、On Failure プロパティの Stop オプションを適用する必要があります。 これにより、メッセージの配信エラーが発生した場合も、送信元の MSMQ キューに元のメッセージが残ります。 Ordered Processing プロパティが False の値に設定されている場合、On Failure プロパティは有効になりません。メッセージ配信エラーが発生すると、メッセージは中断 (再開可能) の状態で中断されます。String 中断 (再開可能) 順次処理 このプロパティを True または False に設定 します。 このプロパティは、メッセージを順番に処理するかどうかを示しています。 プロパティを True に設定すると、[順序付き配信] オプションが True に設定されている BizTalk メッセージングまたはオーケストレーション送信ポートと組み合わせて使用する場合、順序指定されたメッセージ配信に対応できます。 詳細については、「 メッセージの順序付き配信」を参照してください。
このプロパティを True に設定すると、アダプターをシングル スレッドにすることで、大きなメッセージを処理するときのリソースの使用も最適化されます。 詳細については、「 MSMQ アダプターを使用した大きなメッセージの送受信」を参照してください。Boolean False キュー 有効なキューのパスを入力します。 指定するキューのパスに応じて、システムが適切な検証を行います。 メモ： 送信ポートまたは受信場所の URI は 256 文字を超えることはできません。 メモ： MSMQ 受信アダプターは、ポーリング メカニズムを使用して、指定された MSMQ キューで 0.5 秒ごとに新しいメッセージを監視します。 この 0.5 秒は固定の間隔です。 String 空白 トランザクション このプロパティを True または False に設定 します。 メモ： アダプターは、メッセージ キュー 4.0 以降でのみリモート キューのトランザクション読み取りをサポートします。 このシナリオでは、BizTalk Serverとリモート メッセージ キュー サーバーの両方がメッセージ キュー 4.0 以降を実行している必要があります。
詳細については、「 MSMQ アダプターの構成 」および 「クラスター化ホスト内でアダプター ハンドラーを実行するための考慮事項」を参照してください。Boolean False Note
ユーザー名とパスワードは、リモート キューへのアクセスに使用される Windows アカウントにのみ適用されます。
[OK] をクリックします。
[ 受信場所のプロパティ ] ダイアログ ボックスで、受信場所の構成を完了するための適切な値を入力し、[ OK] を クリックして設定を保存します。 [ 受信場所のプロパティ ] ダイアログ ボックスの詳細については、「 受信場所を作成する方法」を参照してください。