BizTalk Server 管理コンソールを使用して、BizTalk Adapter for WebSphere MQ の受信ポートと受信場所を構成します。 BizTalk Server Administrators グループのメンバーであるアカウントでログオンする必要があります。 さらに、Single Sign-On (SSO) データベースに適切なアクセス許可が必要です。
受信ポートと受信場所を構成するには
[プログラム] で、[Microsoft BizTalk Server] を選択し、[BizTalk Server 管理] を選択します。
コンソール ツリーで、 BizTalk グループを展開し、 アプリケーションを展開し、受信ポートを作成するアプリケーションを選択します。
[ 受信ポート] を右クリックし、[ 新規] をポイントし、[ 一方向の受信ポート] をクリックします。
[ 受信ポートのプロパティ ] ウィンドウで、ポートのプロパティを構成し、[ OK] をクリックします。
コンソール ツリーで、[受信場所] を右クリックし、[新規] をポイントして、[一方向の受信場所] をクリックします。
[ 受信ポートの選択 ] ウィンドウで、前の手順で作成した受信ポートをクリックし、[OK] をクリック します。
[ 受信場所のプロパティ ] ウィンドウで、[トランスポートの種類] として MQSC アダプターを選択し、[ 構成] をクリックします。
アダプターの [ トランスポートのプロパティ] ウィンドウで、受信場所のプロパティを構成します (この手順の最後にあるテーブルを参照してください)。
注
受信場所を構成するには、次のプロパティが必要です。
チャネル名 (大文字と小文字が区別されるプロパティです)。
接続名
トランスポートの種類
Queue (これは大文字と小文字を区別するプロパティです)。
Queue Manager (これは大文字と小文字が区別されるプロパティです)。
チャネル名プロパティを指定しない場合は、BizTalk Server コンピューターにインストールされている WebSphere MQ クライアントがリモート キュー マネージャーと通信できるように、クライアント チャネル定義ファイルを指定する必要があります。 トランザクション メッセージングを操作するように Secure Sockets Layer (SSL) を構成する場合は、クライアント チャネル定義ファイルも指定する必要があります。 詳細については、「 クライアント チャネル定義ファイルを構成する方法」を参照してください。
プロパティの構成が完了したら、[ OK] をクリックします。
[ 受信場所のプロパティ ] ウィンドウの [ 受信ハンドラー ] ボックスの一覧で、受信場所を実行する BizTalk Server ホストのインスタンスを選択します。
受信ハンドラーは、このホストで実行されている必要があります。
受信 パイプライン の一覧で、この受信場所でメッセージを受信するために使用する受信パイプラインを選択します。
OK をクリックします。
[ 受信場所 ] ウィンドウで、[ 名前 ] 列の [受信場所] を右クリックし、[ 有効] を選択します。
受信場所のプロパティ
[トランスポートのプロパティ] ウィンドウの [詳細設定] セクションで、次のプロパティを設定できます。
これを使用する 目的 ヘッダーのデータ オフセット アダプターは MQSeries ヘッダー (MQMD、MQXQH、MQIIH、MQCIH 構造体) の値を使用し、BizTalk Server コンテキスト プロパティに対応する値を設定します。 既定では、アダプターはこれらの MQSeries プロパティをメッセージ本文から削除します。 メッセージ本文のプロパティを保持するには、[ いいえ ] に設定します。
既定値: はいイベント ログ エラーのしきい値 特定のエラー条件に対してログに記録される同じエラーの最大数。 アダプターは動作を続け、アダプターが回復した場合は、アプリケーション ログにイベントを記録します。
既定値: 10注文 MQSeries キューから受信して BizTalk Server メッセージ ボックスに送信されるメッセージの順序を維持するには、[ はい ] に設定します。
送信側の場合、アダプターはメッセージ ボックスから受信する順序と同じ順序でメッセージをキューに送信します。
メッセージの順序を維持しない場合 は、[いいえ ] に設定します。
送信側の順序付けの場合、オーケストレーションを使用していない場合は、送信ポート構成のトランスポートの詳細オプションで順序付け配信を有効にする必要があります。
受信側の順序付けの場合、オーケストレーションを使用している場合は、受信場所のオーケストレーションの 順序付け配信 プロパティを True に設定する必要もあります。
順序配信では、パフォーマンスが低下する可能性があります。順序配信が必要な場合を除き、推奨されません。
既定値: いいえ[エラー時に停止する] エラーが発生した場合に処理を停止するには、[ はい ] に設定します。 このオプションは、トランザクションを終了し、エラーが発生した場合に受信場所を無効にします。
既定値: いいえ再開不可として一時停止 エラーが発生したときにメッセージを保留キューに移動し、再開可能かどうかを示すには、[ はい ] に設定します。
この値を有効にしても、エラーが発生しても順序付けされた配信は保持されませんが、受信場所はメッセージの受信を続行できます。
既定値: いいえサポートされているトランザクション [はい] に設定すると、MQSC アダプターは BizTalk Server コンピューター上の WebSphere MQ 拡張トランザクション クライアント (Extended-Client) と連携して、メッセージの損失を防ぎ、メッセージの 1 回限りの配信を保証します。
[いいえ] に設定すると、メッセージの重複が発生する可能性があります。 この場合、アダプターは MQSeries との統合に非トランザクション WebSphere MQ クライアント (Base-Client) を使用します。
既定値: いいえ待機間隔 MQGet を実行して MQSeries キューからメッセージを取得する場合は、待機間隔の MQGMO オプションを設定できます。 キューにメッセージがない場合、アダプターはクライアント要求を閉じる前に、指定された時間 (秒単位) 待機します。 メッセージがキューに到着するとすぐに、アダプターはメッセージの取得を開始します。
既定値: 3[トランスポートのプロパティ] ウィンドウの [ チャネル定義 ] セクションでは、次のプロパティを設定できます。
これを使用する 目的 チャンネル名 クライアントが通信する MQSeries サーバー・コンピューターで定義されているチャネルの名前。 これは、"サーバー接続" チャネルの種類である必要があります。
注意してください、このプロパティは大文字と小文字が区別されます。接続名 MQSC アダプターがメッセージを受信するキュー・マネージャーとキューを含む MQSeries サーバーの名前。
TCP トランスポートの種類の場合、指定する形式は SERVERNAME(PORT) です。 ポート番号は、Queue Manager に関連付けられているリスナーで定義されているポート番号と同じです。
サーバー名は、IP アドレスとして指定することもできます。
LU6.2 の場合は、Host Integration Server で構成されている 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 キューからメッセージを読み取る場合は、アクションなしを使用します。 完全メッセージを使用して、MQSeries でセグメント化メッセージをアセンブルしてからアダプターに渡します。
既定値: アクションなし[トランスポートのプロパティ] ウィンドウの [ パフォーマンス ] セクションでは、次のプロパティを設定できます。
これを使用する 目的 最大バッチ サイズ メッセージのバッチの最大サイズ (KB 単位)。
このプロパティと バッチ内の最大メッセージ は連携して、アダプターが最初に達した値の上限になります。
既定値は100バッチ内の最大メッセージ数 バッチ内のメッセージの最大数は 1 ~ 10,000 です。
このプロパティと 最大バッチ サイズ は連携して、アダプターが最初に達した値の上限になります。
既定値: 10スレッド 受信場所ごとに使用されるスレッドの数。
既定値: 2[トランスポートのプロパティ] ウィンドウの [ キュー定義 ] セクションで、次の表に示すプロパティを設定できます。
これを使用する 目的 キュー アダプターが受信する MQSeries キュー (MQGet) メッセージ。
伝送キュー、ローカル キュー、エイリアス キューがサポートされています。
注意してください、このプロパティは大文字と小文字が区別されます。Queue Manager アダプターがメッセージを取得するキューを含む MQSeries キュー・マネージャーの名前。
クラスター化されたキュー・マネージャーがサポートされています。
注意してください、このプロパティは大文字と小文字が区別されます。OK をクリックします。
こちらもご覧ください
BizTalk Adapter for WebSphere MQ
クライアント チャネル定義ファイルを構成する方法
MQSC アダプターの送信ポートを構成する方法