MQSC アダプターの受信ポートと受信場所を構成する方法
BizTalk Server管理コンソールを使用して、BizTalk Adapter for WebSphere MQ の受信ポートと受信場所を構成します。 BizTalk Server 管理者グループに属するアカウントでログオンする必要があります。 さらに、Single Sign-On (SSO) データベースに適切なアクセス許可が必要です。
受信ポートと受信場所を構成するには
[プログラム] で、[Microsoft BizTalk Server] を選択し、[BizTalk Server管理] を選択します。
コンソール ツリーで、[ BizTalk グループ] を展開し、[ アプリケーション] を展開して、受信ポートを作成するアプリケーションを選択します。
[ 受信ポート] を右クリックし、[ 新規] をポイントして、[ 一方向の受信ポート] をクリックします。
[ 受信ポートのプロパティ ] ウィンドウで、ポートのプロパティを構成し、[ OK] をクリックします。
コンソール ツリーで、[受信場所] を右クリックし、[新規] をポイントして、[一方向の受信場所] をクリックします。
[ 受信ポートの選択 ] ウィンドウで、前の手順で作成した受信ポートをクリックし、[OK] をクリック します。
[ 受信場所のプロパティ ] ウィンドウで、[トランスポートの種類] として MQSC アダプターを選択し、[ 構成] をクリックします。
アダプターの [ トランスポートのプロパティ] ウィンドウで、受信場所のプロパティを構成します (この手順の最後にあるテーブルを参照してください)。
Note
受信場所を構成するには、次のプロパティが必要です。
チャネル名 (大文字と小文字を区別するプロパティです)。
Connection Name
トランスポートの種類
Queue (これは大文字と小文字を区別するプロパティです)。
Queue Manager (これは大文字と小文字を区別するプロパティです)。
チャネル名プロパティを指定しない場合は、クライアント・チャネル定義ファイルを指定して、BizTalk Serverコンピューターにインストールされている WebSphere MQ クライアントがリモート・キュー・マネージャーと通信できるようにする必要があります。 トランザクション メッセージングを操作するように Secure Sockets Layer (SSL) を構成する場合は、クライアント チャネル定義ファイルも指定する必要があります。 詳細については、「 クライアント チャネル定義ファイルを構成する方法」を参照してください。
プロパティの構成が完了したら、[OK] をクリック します。
[受信場所のプロパティ] ウィンドウの [受信ハンドラー] ボックスの一覧で、受信場所を実行するBizTalk Server ホストのインスタンスを選択します。
受信ハンドラーは、このホストで実行される必要があります。
[ 受信パイプライン ] の一覧で、この受信場所でメッセージを受信するために使用する受信パイプラインを選択します。
[OK] をクリックします。
[ 受信場所 ] ウィンドウで、[ 名前 ] 列の [受信場所] を右クリックし、[ 有効にする] を選択します。
受信場所のプロパティ
[トランスポートのプロパティ] ウィンドウの [詳細設定] セクションで、次のプロパティを設定できます。
プロパティ 目的 ヘッダーのデータ オフセット アダプターは MQSeries ヘッダー (MQMD、MQXQH、MQIIH、および MQCIH 構造体) の値を使用して、BizTalk Serverコンテキスト・プロパティーに対応する値を設定します。 既定では、アダプタは、メッセージのボディ部から MQSeries プロパティを削除します。 メッセージ本文にプロパティを保持するには、[ いいえ] に設定します。
既定値: はいイベント ログ エラーのしきい値 特定のエラー条件に対してログに記録される同じエラーの最大数。 アダプターは動作を続け、アダプターが回復した場合は、アプリケーション ログにイベントを記録します。
既定値は10Ordered MQSeries キューからメッセージを受信し、BizTalk Server MessageBox に送信するメッセージの順序を維持するには、Yes に設定します。
送信側の場合、アダプターはメッセージ ボックスから受信した順序と同じ順序でメッセージをキューに送信します。
メッセージの順序を維持しない場合は 、[いいえ] に設定します。
送信側の順序付けの場合、オーケストレーションを使用していない場合は、送信ポート構成のトランスポートの詳細オプションで順序付き配信を有効にする必要があります。
受信側の順序付けの場合、オーケストレーションを使用している場合は、受信場所のオーケストレーションで Ordered Delivery プロパティを True に設定する必要もあります。
順序指定された配信では、パフォーマンスが低下する可能性があります。注文された配送が必要な場合を除き、推奨されません。
既定値: いいえ[エラー時に停止する] エラーが発生した場合に処理を停止するには、[ はい ] に設定します。 このオプションを選択した場合、エラーが発生すると、トランザクションが終了され、受信場所が無効になります。
既定値: いいえ再開不可として保留 エラーが発生したときにメッセージを中断キューに移動し、再開可能かどうかを示すには、[ はい ] に設定します。
この値を有効にしても、エラーが発生しても順序指定された配信は保持されませんが、受信場所はメッセージの受信を続行できます。
既定値: いいえサポートされているトランザクション [はい] に設定すると、MQSC アダプターは、BizTalk Server コンピューター上の WebSphere MQ 拡張トランザクション クライアント (拡張クライアント) と連携して動作し、メッセージの損失を防ぎ、メッセージの 1 回限りの配信を保証します。
[いいえ] に設定すると、メッセージの重複が発生する可能性があります。 この場合、アダプターは非トランザクション WebSphere MQ クライアント (Base-Client) を使用して MQSeries と統合します。
既定値: いいえWait Interval MQGet を実行して MQSeries キューからメッセージを取得する場合、待機間隔の MQGMO オプションを設定できます。 キューにメッセージがない場合、アダプターはクライアント要求を閉じる前に、指定された時間 (秒単位) 待機します。 メッセージがキューに到着するとすぐに、アダプターはメッセージの取得を開始します。
既定値: 3トランスポート プロパティ ウィンドウの [チャネル定義] セクションでは、次のプロパティを設定できます。
プロパティ 目的 チャンネル名 クライアントが通信する MQSeries サーバー・コンピューターで定義されているチャネルの名前。 これは、"サーバー接続" チャネルの種類である必要があります。
これは大文字と小文字を区別するプロパティであることに注意してください。Connection Name MQSC アダプターがメッセージを受信するキュー・マネージャーとキューを含む MQSeries サーバーの名前。
TCP トランスポートの種類の場合、指定する形式は SERVERNAME(PORT) です。 ポート番号は、Queue Manager に関連付けられているリスナーで定義されているポート番号と同じです。
サーバー名は、IP アドレスとして指定することもできます。
LU6.2 の場合は、ホスト統合サーバーで構成されている LU 名または LU プール名を指定します。心拍 クライアント/サーバー接続が動作していることを確認するためのチェックの間隔 (秒数)。
既定: 300パスワード リモート MCA とのセキュリティで保護された LU 6.2 セッションを開始しようとしたときに MCA が使用できるパスワード。
この省略可能なプロパティの初期値は null です。SSL 暗号仕様 アダプターで構成されたエンドポイントによって使用される SSL 接続の単一の CipherSpec を定義します。 WebSphere MQ SSL チャネル定義の両端に 属性を含める必要があります。ここで指定する値は、チャネルのサーバー側で指定された名前と一致している必要があります。 値は、最大長が 32 文字の文字列です。
MQSeries クライアントとリモート・キュー・マネージャー間の通信用に SSL が構成されている場合にのみ必要です。SSL ピア名 WebSphere MQ チャネルのもう一方の端にあるピア・キュー・マネージャーまたはクライアントから証明書の識別名 (DN とも呼ばれます) をチェックするために使用されます。 ピアから受信した識別名がこの値と一致しない場合、チャネルは開始されません。
MQSeries クライアントとキュー・マネージャー間の通信用に SSL が構成されている場合にのみ必要です。トランスポートの種類 TCP と LU6.2 がサポートされています。
既定値: TCPユーザー ID MQSeries リソースへのアクセスを許可するために MQSeries MCA によって使用される MCA ユーザー ID。
初期値は null です。 これは省略可能なプロパティです。 この属性が空白の場合、MCA は既定のユーザー識別子を使用します。トランスポート・プロパティ ウィンドウの MQSeries セクションでは、以下のプロパティーを設定できます。
プロパティ 目的 文字セット MQSeries キューからメッセージを受信するときにメッセージを変換する文字セット。 このプロパティーが None 以外の値に設定されている場合、アダプターは MQGet の実行時に MQGMO CONVERT オプションを設定します。
なし: 変換しないでください。
UCS-2 と UTF-16: これらの文字セットに変換します。 MQSeries は、これらの文字セットを区別しません。
UTF-8: UTF-8 文字セットに変換します。
既定値はなしセグメント化の許可 MQSeries を設定し、セグメント化されたメッセージをアセンブルするかメッセージをそのまま取得します。 セグメント化を有効にせずに MQSeries キューからメッセージを読み込むには、[No Action] を使用します。 セグメント化されたメッセージをアダプターに渡す前にアセンブルするには、[完全なメッセージ] を使用します。
既定値: アクションなしトランスポート プロパティ ウィンドウの [パフォーマンス] セクションでは、次のプロパティを設定できます。
プロパティ 目的 最大バッチ サイズ メッセージのバッチの最大サイズ (KB 単位)。
このプロパティと バッチ内のメッセージの最大数 は連携して、アダプターが最初に達した値の上限を指定します。
既定値は100[バッチ内の最大メッセージ数] バッチ内の 1 から 10,000 までのメッセージの最大数。
このプロパティと [最大バッチ サイズ ] は連携して、アダプターが最初に達した値の上限になります。
既定値は10スレッド 受信場所ごとに使用されるスレッドの数。
既定値: 2トランスポート プロパティ ウィンドウの [キュー定義] セクションでは、次の表に示すプロパティを設定できます。
プロパティ 目的 キュー アダプターがメッセージ (MQGet) を受信する MQSeries キュー。
伝送キュー、ローカル キュー、エイリアス キューがサポートされています。
これは大文字と小文字を区別するプロパティであることに注意してください。キュー マネージャー アダプターがメッセージを取得するキューを含む MQSeries キュー・マネージャーの名前。
クラスター化されたキュー・マネージャーがサポートされています。
これは大文字と小文字を区別するプロパティであることに注意してください。[OK] をクリックします。
参照
BizTalk Adapter for WebSphere MQ
クライアント チャネル定義ファイルを構成する方法
MQSC アダプターの送信ポートを構成する方法