このセクションでは、MQ トランスポートでメッセージを送受信するメッセージ プロキシの設定方法を説明します。このセクションの内容:

MQ 必要条件

JAR ファイル

「必要な JAR ファイルをクラスパスへ追加」を参照してください。

キューの割り当て

キューを介してトラフィックが交換される場合、「クライアント アプリケーションが宛先キューにリクエストを送信し、サーバー アプリケーションがキューからメッセージを受信する」と想定します。サーバーは、クライアントが受信する応答メッセージを 2 番目のキューに送信します。このシナリオでは、メッセージ プロキシはクライアントとサーバー間の「中間者」として機能し、仲介を促進するためにメッセージング プロバイダーにさらに 2 つのキューが必要です。Parasoft プロキシは、クライアントがメッセージを配置するキューからメッセージを取得し、内容を記録して (記録を有効にしている場合のみ)、サーバーがメッセージを受信するキューに配置します。同様に、サーバーはプロキシが取得しに行くキューにメッセージを送信し、プロキシはそのメッセージを記録し (記録を有効にしている場合のみ)、クライアントが返信レスポンスを受信するキューに配置します。

結果として、 2 つの追加キューの割り当てと、次のいずれかが必要となります。

• クライアント アプリケーションを調整し、これら 2 つの新しいキューと通信するようにする (プロキシ接続を構成して調整)。
• サーバー アプリケーションを調整し、別のキューを 2 つの使用するようにする。

2 つのアプリケーション キューのうち 1 つだけを修正する必要があります。

MQ 設定の指定

次の手順で MQ 設定を指定します。

1. [プロキシ接続設定] ダイアログで、プロキシ タイプとして MQ を選択します。
    
   

2. 「Using Global Queue Managers」で説明するように定義済みのキュー マネージャーを参照するのではなく、このパネルでクライアントとサーバーのキューを定義している場合、[ローカル設定] エリアでサーバーの詳細を入力します。

   Info
   icon false title 単一プロキシで複数のキューマネージャーを使用する
   単一プロキシ内で複数のキュー マネージャーへの接続を設定したい場合 (たとえば、プロキシ接続で、2 つの異なるキュー マネージャー上でデプロイされる 2 つのキューを使用したい場合)、使用するキューごとにグローバル キュー マネージャーを作成し、プロキシの設定時に適切なキューマネージャーを選択します。

3. クライアントとサーバーのキューを指定します。このパネルの [ ローカル設定] オプションで接続ごとに設定を入力するか、 サーバー レベルで定義されたグローバル キュー マネージャーを参照することができます (詳細については 「Using Global Queue Managers」を参照してください)。 

   Info
   title SSL
   サーバーの [接続] タブ で SSL 構成を含む Virtualize サーバーで MQ キューを定義し、ドロップダウン メニューからグローバル キュー マネージャーを選択して設定をプロキシに適用できます。SSL 構成は、ローカル設定の構成ではサポートされていません。

   

   • Put キューは常にテスト対象のアプリケーション/クライアントがリクエスト メッセージをプット/送信する場所です。Get キューは、クライアント/テスト対象のアプリケーションがレスポンス メッセージを取得する場所です。
     

   • Virtualize/SOAtest はクライアントの put キューに送信されたメッセージをキャプチャし、処理のためにサーバーの put キューに転送します。 サーバーの get キューは、 (リクエストメッセージの処理の後で) サーバーがレスポンスメッセージを置くキューです。これらのメッセージはキャプチャされ、クライアントの Get キューに転送されます。

   • メッセージ プロキシが開始するときに、2 つのリスナーがメッセージプロキシによって作成されます。1 つ目のリスナーは、クライアントの put キューで作成されます。このリスナーはクライアント put キューからメッセージをピックアップし、サーバーの put キューに置きます。2 つ目のリスナーは、サーバーの get キューで開始し、サーバーの get キューからクライアントの get キューにメッセージを移動します。

   • プロキシがキューをオープンしたりサーバーの put キューにメッセージをプットしたりするときに使用されるオプションフラグをカスタマイズしたい場合、JVM システム プロパティ  parasoft.proxy.mq.put.open.options および parasoft.proxy.mq.put.options を、Virtualize/SOAtest が起動するときに指定できます。 たとえば、MQMD ヘッダー putApplicationName のためのカスタマイズされた値がメッセージにあるものとします。キューの open.options で MQOO_SET_ALL_CONTEXT フラグを設定し、put.options で MQPMO_SET_ALL_CONTEXT フラグを設定すると、メッセージ プロキシはカスタマイズされた putApplicationName ヘッダー値を転送することができます。
     オプションフラグの値については、IBM の mq_queue_get_open_options およびmq_message_put_options パラメーターを参照してください。例:

     Code Block
     soatest.exe -J-Dparasoft.proxy.mq.put.open.options=2052 -J-Dparasoft.proxy.mq.put.options=2064

     ここで使用される値は、個々のフラグによって表されるすべての値の合計です。たとえば、open.options の値 2052 は、3 つのフラグ MQC.MQOO_SET_ALL_CONTEXT、MQC.MQOO_INPUT_SHARED、および MQC.MQOO_INPUT_EXCLUSIVE がオンであることを意味します。

     Info
     icon false title キューの設定の詳細
     さまざまな状況で記録を設定するためのヒントについては、「トラフィックの記録におけるキューの設定」を参照してください。

4. 必要に応じて [レスポンスに replyToQueueName を使用する] の設定を変更します。メッセージの replyToQueueName ヘッダーを使用してレスポンスの送信先を決定するかどうかを指定します。MQMT_REQUEST タイプの MQ メッセージへのレスポンスに影響を与えます。
   • 有効な場合、受信リクエストからの値を使ってレスポンスの送信先が決定されます。オプションが有効ではない場合、レスポンスは GUI で指定されたキューに送られます。具体的には以下のとおりです。

     • オプションが有効であり、MQMD.replyToQueueManagerName と MQMD.replyToQueueName の両方の値が指定されている場合、これらの値によって、キュー マネージャーとレスポンスの送信先のキュー名の両方が決定されます。

     • オプションが有効であり、MQMD.replyToQueueManagerName または MQMD.replyToQueueName がリクエストにない場合、それらの値のかわりに GUI で指定された値が使用されます。
     • オプションが無効な場合、MQ リクエスト メッセージの replyToQueueName および replyToQueueManagerName フィールドは無視されます。GUI の設定によって、メッセージの送信先が決定されます。

5. 必要に応じて [ワーカーのカウント] の設定を変更します。

   Info
   icon false title ワーカーのカウントを調整する
   各ワーカーが MQ プロバイダーに独自の接続を作成します。たとえば、20 のワーカーがある場合、WebSphere MQ Explorer では、メッセージ プロキシがリスンするリクエスト (get) キューの Open input count 列の値として 20 が表示されるはずです。デフォルト値の 1 より多いワーカーのカウントでプロキシがデプロイ/再デプロイされると、コンソールに「Started x listener(s)」というメッセージが表示されます (x には構成されたワーカー数が入ります)。  ワーカーのカウントを増やすことは並列時のパフォーマンスに役立ちます。プロキシのメッセージ処理チェーン全体が並列化され、各ワーカーのスレッドは他のスレッドと並行してメッセージ応答条件、レスポンス メッセージの生成などを行います。しかし、高いワーカーのカウントを提供すると、作成/破棄する接続が増えるため、プロキシのデプロイ/アンデプロイ/再デプロイに時間が掛かります。また、 MQ インフラストラクチャに許可する同時接続数の制限を持たせることが可能です。ユーザーのインフラストラクチャで構成/許可された数を越えるべきではありません。  ワーカー カウント機能は、Tomcat server.xml の maxThreads 属性と同等です。 server.xml ファイルを調整するには： Virtualize を起動し、少なくとも 1 つのレスポンダーが作成されていることを確認します。 <INSTALL-DIR>/plugins/com.parasoft.ptest.libs.web_<VERSION>/root/tomcat/conf/ にある server.xml を変更します。 高い数の同時仮想ユーザーを使用するとき (つまり負荷テスト中など)、通常はこれらの値を増やすことでより良いパフォーマンスを期待できます。

6. グローバル キュー マネージャーを使用している場合、[ローカル設定] エリアで接続の詳細情報を指定します。以下のいずれかのモードを選択できます。
   • デフォルトモード: 接続の詳細情報 (たとえばホスト、ポート、チャネルなど) を手動で入力できます。
   • CCDT モード: 接続の詳細情報が記述されたクライアント チャネル定義 (CCDT) ファイルを指定できます。

デフォルトモードを使用している場合、以下のフィールドを設定します。

CCDT モードを使用する場合、以下のフィールドを設定します。

ローカル サーバー

リモート サーバー

MQ CCSID の設定

多くの場合、Virtualize が MQ キュー マネージャーの接続に使用するデフォルトの CCSID で問題ありません。しかし、別の CCSID を使用するよう MQ キュー マネージャーが設定されている場合、CCSID がキュー マネージャーによってサポートされていないという通知を受け取るでしょう。

MQ キュー マネージャーの接続に使用するデフォルトの CCSID を変更するには、JVM 引数で次のシステム プロパティを設定します。

parasoft.mq.environment.ccsid=<CCSID>

設定する CCSID は、キュー マネージャーの CCSID および JVM がサポートする文字セットによって異なります。

「Additional Preference Settings」も参照してください。

Anchor
Using Global Queue Managers Using Global Queue Managers

グローバル キュー マネージャーの使用

特定の Virtualize サーバー全体に適用されるグローバル キュー マネージャーの設定は、サーバー レベルで定義し、ここで参照することができます。  詳細については「 [接続] タブ」を参照してください。グローバル キュー マネージャーを使用するには、適切な [キュー] から選択します。MQ サーバーは、hostname: queue manager name

の命名規則を使用してリストされます。定義済みのグローバル キュー マネージャーの詳細を確認するには、[設定の表示] をクリックします。 

キューの構成についてのヒント

さまざまな状況で記録を設定するためのヒントについては、「トラフィックの記録におけるキューの設定」を参照してください。