管理コンソールを使用して、キュー・タイプ宛先を作成し、
それを IBM MQ キューに割り当てることができます。
キューをホストする IBM MQ サーバーを選択し、次に、ホスト対象の IBM MQ キューを指定します。
始める前に
IBM MQ キューの名前を管理者から入手し、
以下の構成が設定されていることを確認してください。
注: 共有可能キューは、
複数のサービス統合アプリケーションからアクセスできます。
これらのリソースの構成に使用する方式を決定します。バス宛先を作成するには、このタスクで説明するように管理コンソールを使用するか、createSIBDestinations コマンドを使用します。
このタスクについて
IBM MQ サーバーをバス・メンバーとして追加した後、
IBM MQ キューをキュー・ポイントとして使用するキュー・タイプ宛先を、そのバス・メンバーに作成できます。
この構成により、サービス統合アプリケーションは、そのキューとの間でメッセージのやり取りを行えるようになります。
手順
- 管理コンソールを開始します。
- 該当するバスの宛先のリストにナビゲートします。
をクリックします。
「宛先 [コレクション]」フォームが表示されます。
- 「新規」をクリックします。 「新規宛先の作成」パネルが表示されます。
- 宛先タイプとして「キュー」を選択してから、
「次へ」をクリックします。 「新規キューの作成」ウィザードが表示されます。
- キュー属性を設定します。 WebSphere Application Server が、関連する IBM MQ キューと
(オプションで) キューの説明を参照する際に使用する名前を入力します。
- キューのメッセージを保管および処理するバス・メンバーにキューを割り当てます。
使用可能なバス・メンバーのリストから IBM MQ サーバー・バス・メンバーを選択します。
- IBM MQ キュー・ポイントの属性を設定します。
- 「IBM MQ キュー名
フィルター」フィールドに値を指定し、「実行」をクリックします。
ウィザードは、使用可能な
IBM MQ キューを自動的に検出します。ただし
、一部の IBM MQ トポロジーには、キュー・マネージャーに対して定義されたキューが何千個もあります。このフィルターを使用
して、リストされるキューの数を制限してください。
デフォルトのフィルター値はアスタリスク (*) です。この値 (または値なし) が設定されると、すべてのキューまたは特定タイプのすべてのキュー (設定された
任意のキュー・タイプのカスタム・プロパティーに基づいたもの) がリストされます。指定する
その他の値はすべて、以下の条件を満たす必要があります。- 1 文字以上 48 文字以下である必要があります。
- IBM MQ キュー命名規則 (IBM MQ インフォメーション・センターのトピック『IBM MQ オブジェクトの命名規則』を参照) に準拠する必要があります。
ワイルドカード文字 (*) をその他のテキストと使用することもできます。例えば、PAYROLL* という値を入力すると、PAYROLL で始まる名前を持つ使用可能なキューがすべて表示されます。
- IBM MQ キュー名
を指定します。
フィルタリングされたリストからキュー名を選択します。リストに希望するキューが含まれていない場合、other, please specify というラベルが
付いた、リスト末尾のエントリーを選択してください。テキスト・エントリー・ボックスが、ドロップダウン・リストの隣に表示されます。テキスト・エントリー・ボックスにキュー名を入力します。
キューがリモートの
IBM MQ システムで検出された場合
、IBM MQ 内で定義されているとおりのキューのプロパティーが、読み取り専用フィールドとして表示されます。これは、希望するキューを
検出したこと、および、それが意図したとおりに構成されていることを確認する場合に便利です。キューが検出されない場合、これらの読み取り専用フィールドは、ビューから除去されます。
- インバウンド非パーシスタントおよびインバウンド・パーシスタントの IBM MQ メッセージを
サービス統合フォーマット・メッセージに変換するときに必要とする信頼性レベルを指定します。
アプリケーションは、指定された
IBM MQ キューからメッセージを直接受け取ります。そのため、メッセージが既に正常に配信されているという理由から、通常、メッセージの信頼度レベルは受信側にとって重要ではありません。ただし、
メッセージは受信時にサービス統合フォーマット・メッセージ (通常は JMS フォーマットのサービス統合メッセージ) に
変換され、このオプションはサービス統合フォーマット・メッセージの信頼度レベルを指定します。使用可能な信頼性レベルについては、IBM MQ キュー・ポイント [設定]を参照してください。
- キューにメッセージを送信するときに IBM MQ で
MQRFH2 メッセージ・ヘッダーを含めるかどうかを指定します。
MQRFH2 ヘッダーは、対応する IBM MQ メッセージ・ヘッダー・フィールドのないサービス統合メッセージング情報を保管します。メッセージが宛先に送信されるときに、サービス統合は、キューへのメッセージを作成するよう
に IBM MQ に指示します。このオプションは、サービス統合が IBM MQ に MQRFH2 ヘッダーを使用してメッセージを書き込むように指示するかどうかを指定します。
メッセージのコンシューマーが
IBM MQ またはサービス統合で実行中の JMS アプリケーション
、IBM MQ XMS アプリケーション、あるいは、MQRFH2 ヘッダーを予期している IBM MQ MQI アプリケーションである場合は、このオプションを選択します。コンシューマーが MQRFH2 ヘッダーを予期していない IBM MQ MQI アプリケーションである場合は、このオプションを選択しません。
- 「次へ」をクリックします。
- キュー作成を確定するには、「終了」をクリックします。
タスクの結果
IBM MQ キュー・ポイントを使用したキュー・タイプ宛先の作成が完了しました。