メッセージ・リスナー・サービスのカスタム・プロパティー

このパネルを使用して、メッセージ・リスナー・サービスのカスタム・プロパティーに関する名前および値のペアのオプション設定を表示または変更します。

この管理コンソール・ページを表示するには、「サーバー」 > 「アプリケーション・サーバー」 > application_server > [通信]「メッセージング」 > 「メッセージ・リスナー・サービス」 > 「カスタム・プロパティー」 をクリックします。

「カスタム・プロパティー」ページを使用して、メッセージ・リスナー・サービスが使用する次のプロパティーを定義することができます。
NON.ASF.RECEIVE.TIMEOUT

同期メッセージが受信するタイムアウト (ミリ秒) は、非 ASF モードの操作でメッセージ指向の Bean リスナー・セッションによって実行されます。

このプロパティーは、アプリケーション・サーバー上のすべてのメッセージ指向 Bean リスナーに対して、 非 ASF モードの操作を使用可能にする場合にのみ、非ゼロの値に設定してください。

メッセージ・リスナー・サービスは、アプリケーション・サーバー・ファシリティー (ASF) および 非アプリケーション・サーバー・ファシリティー (非 ASF) という 2 つの操作モードを備えています。
  • ASF モードの目的は、アプリケーションに、並行性およびトランザクションのサポートを提供することです。 パブリッシュ/サブスクライブ・メッセージ指向 Bean の場合には、ASF モードによって、 より良いスループットおよび並行性が得られます。これは、非 ASF モードでは、リスナーは単一スレッドになっているためです。
  • 非 ASF モードは、JMS ASF をサポートしていないサード・パーティーのメッセージング・プロバイダーで主に使用します。JMS ASF は、JMS 仕様のオプションの拡張機能です。 非 ASF モードも、トランザクション指向です。ただし、パスの長さが ASF モードより短いため、通常はパフォーマンスが向上します。
    次の場合は、非 ASF を使用してください。
    • サード・パーティーのメッセージング・プロバイダーが JMS ASF をサポートしていない
    • WebSphere® トピック接続の DIRECT ポートでメッセージ駆動型 Bean を使用している。 これは、そのポートを使用する組み込みパブリッシュ/サブスクライブ・ブローカーが、XA トランザクション または JMS ASF をサポートしていないためです。
    • メッセージ順序が厳密な要件である
データ型 整数
単位 ミリ秒
デフォルト ASF モード (カスタム・プロパティーは作成されません)
範囲 0 以上のミリ秒
0
非 ASF モードは使用不可
1 以上
非 ASF メッセージ指向 Bean リスナー同期セッションが受信するタイムアウト (ミリ秒)
推奨 トランザクション・タイムアウトになると、メッセージを再生する必要があり、余分な作業が発生します。 非 ASF モードを使用する場合には、このプロパティーをトランザクション・タイムアウトよりも低く設定します。 ただし、メッセージ指向 Bean の onMessage() メソッドの最大所要時間は、最低でも残しておく必要があります。 例えば、ユーザーのメッセージ駆動型 Bean の onMessage() メソッドが、通常最大 10 秒必要で、 トランザクション・タイムアウトが 120 秒に設定されている場合には、NON.ASF.RECEIVE.TIMEOUT プロパティーを 110000 (110000 ミリ秒、すなわち 110 秒) 以下に設定します。
MQJMS.POOLING.TIMEOUT

プール内の未使用の接続が破棄されるまでのミリ秒数。

MQSimpleConnectionManager は、直前に使用された接続から割り振り、 使用されない最も古い接続から破棄していきます。 デフォルトでは、5 分間続けて使用されなかった接続は破棄されます。

データ型 整数
単位 ミリ秒
デフォルト 5 分間
範囲  
MQJMS.POOLING.THRESHOLD

プール内の未使用接続の最大数。

MQSimpleConnectionManager は、直前に使用された接続から割り振り、 使用されない最も古い接続から破棄していきます。 デフォルトでは、プール内にある未使用接続数が 10 を超えた場合に、接続が 1 つ破棄されます。

データ型 整数
単位 接続数
デフォルト 10
範囲  
MAX.RECOVERY.RETRIES

このサービスによって管理されるリスナー・ポート が断念して停止するまでに障害からリカバリーしようとする最大 回数。停止すると、関連したリスナー・ポートが停止状態に 変更されます。再試行の間隔は、RECOVERY.RETRY.INTERVAL カスタム・プロパティーによって定義されます。

障害は、次の 2 つのいずれかの可能性があります。
  • リスナー・ポートが JMS プロバイダーからのメッセージの取得を試みた際に、 予期しないエラーが発生した。
  • アプリケーション・サーバーと JMS プロバイダー間の接続が失われた (通常、ネットワーク・エラーが原因)。
データ型 整数
単位 再試行の回数
デフォルト 5
範囲 0 (再試行しない) から 2147483647
RECOVERY.RETRY.INTERVAL

リスナー・ポートによる、障害からのリカバリー の再試行の間隔を示す秒数。再試行の最大数は 、MAX.RECOVERY.RETRIES カスタム・プロパティーによって定義 されます。

障害は、次の 2 つのいずれかの可能性があります。
  • リスナー・ポートが JMS プロバイダーからのメッセージの取得を試みた際に、 予期しないエラーが発生した。
  • アプリケーション・サーバーと JMS プロバイダー間の接続が失われた (通常、ネットワーク・エラーが原因)。
データ型 整数
単位
デフォルト 60
範囲 1 から 2147483647
DYNAMIC.CONFIGURATION.ENABLED

このプロパティーは、リスナー・ポートが作成されるアプリケーション・サーバーを再始動する必要があるかどうかを制御します。 このプロパティーを true に設定すると、動的構成が使用可能になります。

データ型 ブール
デフォルト false (選択されていない)



マーク付きのリンク (オンライン) では、インターネットにアクセスする必要があります。

関連タスク
関連資料


ファイル名: umb_prolscp.html