ビジネス環境の発展に応じて、Service Component Architecture (SCA) モジュールが使用する WebSphere® MQ 宛先を変更する必要が生じることがあります。
始める前に
変更する WebSphere MQ JMS 宛先を、どの SCA モジュールが使用しているかを知っておく必要があります。デフォルトでは、これらの宛先は、SCA モジュールをサーバーまたはクラスターにインストールしたときに作成されます。宛先の形式は、以下のとおりです。
- 片方向のエクスポートの場合:
- modulename.exportname_MQEXPORT_CF
- modulename.exportname_MQ_RECEIVE_D
- これに加えて、両方向のエクスポートの場合:
- modulename.exportname_MQ_SEND_D
- 片方向のインポートの場合:
- modulename.importname_MQIMPORT_CF
- modulename.importname_MQ_SEND_D
- これに加えて、両方向のインポートの場合:
- modulename.importname_MQ_RECEIVE_D
このタスクは、管理コンソールを使用して構成を変更することを前提とします。
制約事項: 宛先を変更するときには、以下の事項に注意してください。
- ターゲット・クライアントを MQ に設定した状態でキュー宛先を構成する必要があります。
- TCP/IP クライアント接続を使用して、WebSphere MQ に接続する必要があります。詳しくは、「WebSphere MQ Intercommunication」を参照してください。
- チャネル圧縮は使用できません。
- データを正しく処理するには、必要なチャネル出口をすべて設定する必要があります。これを行うには、をクリックして、以下のカスタム・プロパティーを設定します。
- SENDEXIT。このプロパティーには、値 com.ibm.ws.sca.internal.mq.exit.MQInternalSendExitImpl を設定します。
- RECEXIT。このプロパティーには、値 com.ibm.ws.sca.internal.mq.exit.MQInternalReceiveExitImpl を設定します。
- オプション: SENDEXITINIT。このプロパティーには、選択したテキスト・ストリングを設定します。このプロパティーを設定すると、トレースで出口を見分けやすくなります。
- オプション: RECEXITINIT。このプロパティーには、選択したテキスト・ストリングを設定します。このプロパティーを設定すると、トレースで出口を見分けやすくなります。
- 出口では JMS MQ バインディングは禁止されるため、WebSphere MQ バインディングと Java™ Message Service (JMS) MQ バインディングに同じ接続ファクトリーを使用することはできません。
このタスクについて
SCA モジュールをデプロイした後で、新規のビジネス要件を満たすために、WebSphere MQ JMS 宛先の変更が必要になることがあります。
手順
- 変更する宛先を使用しているすべてのアプリケーションを停止します。 『エンタープライズ・アプリケーションの管理』で説明する手順を実行します。
- 宛先が進行中のメッセージの処理を完了することを許可します。
- WebSphere MQ JMS 宛先を表示します。 管理コンソール内でこのページにナビゲートするには、「リソース」>「JMS プロバイダー」>「WebSphere MQ」>「WebSphere MQ キュー宛先 (WebSphere MQ queue destinations)」を使用します。
- 変更する宛先のスコープを選択します。
宛先を含む SCA モジュールが単一サーバー上にインストールされている場合は、「サーバー・スコープ (Server scope)」を選択します。
宛先を含む SCA モジュールがクラスター上にインストールされている場合は、「クラスター・スコープ (Cluster scope)」を選択します。
- 変更する宛先をリストから選択します。
- 次のページの各種フィールドを新規の値に変更します。
- 変更する宛先ごとに、ステップ 5 と 6 を繰り返します。
- 構成変更を保管します。
次のタスク
ステップ
1 で停止したアプリケーションを再始動します。