チュートリアル:MQSeries アダプタを使用する BizTalk アプリケーションの作成
このセクションでは、MQSeries アダプターを使用する単純な Microsoft BizTalk Server アプリケーションの作成について説明します。
Note
このアプリケーションは、Windows プラットフォームのサーバー コンポーネントである IBM WebSphere MQ が BizTalk Server と同じコンピューターにインストールされていることを前提としています。 また、送信ポートまたは受信場所をまだ作成していないことも前提としています。 既存の送信ポートまたは受信場所がある場合、手順を実行する際に適切な名前に置き換えてください。
このアプリケーションは、受信場所と送信ポートのみを使用する、コンテンツベースの単純なルーティング アプリケーションです。 受信場所では、IBM WebSphere MQ キューから読み取りを行います。 送信ポートは、受信場所からメッセージを取得して、そのメッセージを別の IBM WebSphere MQ キューに送信します。
このアプリケーションを作成するには、IBM WebSphere MQ キューの作成、BizTalk Server の受信場所と送信ポートの設定、送信ポートの開始と受信場所の有効化、およびキューへのテスト メッセージの送信を行う必要があります。
IBM WebSphere MQ のインストールに必要なアクセス許可を持っている場合は、アダプターのダイアログ ボックスを使用して IBM WebSphere MQ キューを作成できるため、次の手順を省略できます。 このようなアクセス許可を持っていない場合は、Windows プラットフォームのクライアント コンポーネントである IBM WebSphere MQ エクスプローラーを使用してキューを作成できます。 IBM WebSphere MQ エクスプローラー スナップインを使用してキューを作成するには、次の手順を実行します。
IBM WebSphere MQ エクスプローラーを使用して IBM WebSphere MQ キューを作成するには
IBM WebSphere MQ エクスプローラーを使用して IBM WebSphere MQ キューを作成するには、次の手順を実行します。
[スタート] をクリックし、[プログラム] をポイントし、[WebSphere MQ] をポイントして、[WebSphere MQ エクスプローラー] をクリックします。
[キュー マネージャー] をダブルクリックし、既定のキュー マネージャーをダブルクリックします。 通常、既定のキュー マネージャーには QM_<という名前が付けられますmachine_name>machine_nameはコンピューターの名前です。
[ キュー] を右クリックし、[ 新規] をポイントして、[ ローカル キュー] をクリックします。
[ ローカル キューの作成 ] ダイアログ ボックスの [ キュー名] に「 BTStoMQS」と入力し、[OK] をクリック します。
[ キュー] を右クリックし、[ 新規] をポイントして、[ ローカル キュー] をクリックします。
[ ローカル キューの作成 ] ダイアログ ボックスの [ キュー名] に 「MQStoBTS」と入力し、[OK] をクリック します。
次の手順では、受信場所と送信ポートの作成、および送信ポートの開始と受信場所の有効化を行います。 IBM WebSphere MQ キューも作成します。
受信場所と MQSeries キューを作成するには
受信場所と MQSeries キューを作成するには、次の手順を実行します。
BizTalk Server管理コンソールで、[BizTalk Server管理]、[BizTalk グループ]、[アプリケーション] の順に展開し、既定のアプリケーション (既定では BizTalk Application 1) を展開します。
[ 受信ポート ] ノードを右クリックし、[ 新規] をクリックして、[ 一方向ポート] を選択します。
[ 受信ポートのプロパティ ] ダイアログ ボックスの [名前 ] ボックスに「 MQStoBTS」と入力します。
左側のウィンドウで [ 受信場所] をクリックし、右側のウィンドウで [ 新規] をクリックします。
[ 受信場所のプロパティ ] ダイアログ ボックスの [名前 ] ボックスに「 MQStoBTS」と入力します。
[種類] オプションの横にあるドロップダウン リストから [MQSeries] を選択します。
[ トランスポート ] セクションで、[ 構成] をクリックします。
[ MQSeries トランスポートのプロパティ ] ダイアログ ボックスの [ ポーリング間隔 ] ボックスに「 1」と入力します。
[ キュー定義 ] ボックスで、省略記号 (...) ボタンをクリックします。
[ キュー定義 ] ダイアログ ボックスの [ サーバー名 ] ボックスに、コンピューター名を入力します。
[ キュー マネージャー ] ボックスで、既定のキュー マネージャーを選択します。
[ キュー ] ボックスに 「MQStoBTS」と入力し、[ エクスポート] をクリックします。
[エクスポート] ダイアログ ボックスで、[キューの作成] をクリックし、もう一度 [OK] をクリックして [受信場所のプロパティ] ダイアログ ボックスに戻ります。
[ 受信ハンドラー ] ボックスで、 BizTalkServerApplication を選択します。
[ 受信パイプライン ] ボックスで、[ PassThruReceive] を選択します。
[OK] をクリックして変更を適用します。
送信ポートと MQSeries キューを作成するには
送信ポートと MQSeries キューを作成するには、次の手順を実行します。
[ 送信ポート] を右クリックし、[ 新規] をクリックし、[ 静的一方向送信ポート] を選択します。
[送信ポートのプロパティ] ダイアログ ボックスの [名前] ボックスに「BTStoMQS」と入力します。
[種類] オプションの横にあるドロップダウン リストから [MQSeries] を選択します。
[ トランスポート ] セクションで、[ 構成] をクリックします。
[ MQSeries トランスポートのプロパティ ] ダイアログ ボックスの [ キュー定義 ] ボックスで、省略記号 (...) ボタンをクリックします。
[ キュー定義 ] ダイアログ ボックスの [ サーバー名 ] ボックスに、コンピューター名を入力します。
[ キュー マネージャー ] ボックスで、既定のキュー マネージャーを選択します。
[ キュー ] ボックスに「 BTStoMQS」と入力し、[ エクスポート] をクリックします。
[ エクスポート ] ダイアログ ボックスで、[ キューの作成] をクリックし、[ OK] を クリックし、もう一度 [OK] を クリックして [ 送信ポートのプロパティ ] ダイアログ ボックスに戻ります。
[ 送信パイプライン ] ボックスで、[ PassThruTransmit] を選択します。
クリックして左側のウィンドウで [フィルター ] を選択し、右側のウィンドウでフィルター オプションを構成します。
[ プロパティ ] ドロップダウン リストで、[BTS] を選択 します。ReceivePortName。
[ 値 ] ボックスに「 MQStoBTS」と入力します。
[OK] をクリックして変更を適用します。
受信場所を有効にして送信ポートを開始するには
受信場所を有効にし、送信ポートを開始するには、次の手順を実行します。
MQStoBTS 受信場所を右クリックし、[有効にする] をクリックします。
BTStoMQS 送信ポートを右クリックし、[開始] をクリックします。
次の手順では、テスト メッセージを受信キューに送信することにより、アプリケーションをテストします。
アプリケーションをテストするには
アプリケーションをテストするには、次の手順を実行します。
[スタート] をクリックし、[プログラム] をポイントし、[WebSphere MQ] をポイントして、[WebSphere MQ エクスプローラー] をクリックします。
[MQStoBTS] を右クリックし、[テスト メッセージの配置] をクリックします。
[ メッセージ データ ] ボックスに、テスト メッセージを入力します。 [OK] をクリックします。
データを入力すると、MQStoBTS キューの現在の深さは 1 になります。 アプリケーションがメッセージを処理すると、カウントはゼロ (0) に戻り、BTStoMQS の現在の深さは 1 になります。 また、メッセージの内容を表示することもできます。
メッセージを表示するには
メッセージを表示するには、次の手順を実行します。
BTStoMQS キューをダブルクリックします。
メッセージをダブルクリックし、[ データ シート] を選択します。 [ メッセージ データ ] ボックスでメッセージのテキストを表示できます。
[OK] をクリックします。