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

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

このプロパティーは、アプリケーション・サーバーが IBM MQ for z/OS に接続する際のリスナー・ポートの動作を制御します。

プロパティーの追加後には、サーバーを再始動してください。

バインディング接続を通じて IBM MQ for z/OS に接続する場合は、IBM MQ バージョン 6.0.2.4 で提供される IBM MQ APAR PK53912 を適用する必要もあります。

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

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

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

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

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

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

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

z/OS システムでは、非 ASF モードを選択できないため、このプロパティーにゼロ以外の値を設定しないでください。

メッセージング・システムが非 ASF モードで稼働している場合は、 不要なトランザクション・タイムアウトが発生しないように、合計トランザクション存続時間タイムアウトに達する前に処理が完了できる十分な時間を割り当ててください。 そのため、必ず、 NON.ASF.RECEIVE.TIMEOUT メッセージ・リスナー・サービス・カスタム・プロパティーに指定した値が、 トランザクション・サービス・プロパティーの「合計トランザクション存続時間タイムアウト」に指定した値より小さく、 かつ、この 2 つのプロパティーの値の差が、メッセージ駆動型 Bean (MDB) の onMessage() メソッドでメッセージの処理にかかる時間より大きくなるようにしてください。

例えば、ユーザーのメッセージ駆動型 Bean の onMessage() メソッドの所要時間が通常最大 10 秒で、トランザクション・タイムアウトが 120 秒に設定されている場合、NON.ASF.RECEIVE.TIMEOUT プロパティーは 110000 ミリ秒 (つまり 110 秒) 以下に設定できます。

非アプリケーション・サーバー機能 (非 ASF) モードの操作が (NON.ASF.RECEIVE.TIMEOUT プロパティーをゼロ以外の値に設定したため) 使用中であり、Bean 管理トランザクションを使用するメッセージ駆動型 Bean が実行時例外を生成する場合、NON.ASF.BMT.ROLLBACK.ENABLED プロパティーによりメッセージが宛先に戻されるかどうかが決定されます。

z/OS システムでは、非 ASF モードは選択できません。

このプロパティーが False に設定されている (デフォルト) 場合、メッセージはメッセージ駆動型 Bean に渡される前に自動的に応答されます。

このプロパティーを True に設定すると、メッセージがメッセージ駆動型 Bean によって正常に処理された後に、メッセージ・リスナー・サービスがクライアントに対してメッセージの確認応答を送信します。Bean がメッセージに対して例外を生成した場合、メッセージ・リスナー・サービスはそのメッセージのリカバリーを要求します。

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

サーバー・セッション・プールの検査間隔秒数。 サーバー・セッション・プールのモニターを使用可能にするには、このプロパティーを負以外の値に設定します。

メッセージング・システムを非 ASF モードで実行している場合、SERVER.SESSION.POOL.REAP.TIME カスタム・プロパティーは適用されません。

デフォルトのサーバー・セッション・プール・タイムアウト (秒)。

このプロパティーが負以外の値に設定されている場合、サーバー・セッションが使用されてから経過した時間と比較されます。 タイムアウト値が経過時間より小さい場合、サーバー・セッションはサーバー・セッション・プールから除去され、JMS セッションは JMS セッション・プールに返されます。例えば、タイムアウト値が 1 秒の場合、特定のサーバー・セッションが使用されてから 2 秒経過すると、そのサーバー・セッションはサーバー・セッション・プールから除去され、JMS セッションは JMS セッション・プールに返されます。

SERVER.SESSION.POOL.UNUSED.TIMEOUT カスタム・プロパティーは、メッセージング・システムが非 ASF モードで実行されている場合は適用されません。

このプロパティーは、<LP 名> に定義された名前のリスナー・ポートのデフォルトの SERVER.SESSION.POOL.UNUSED.TIMEOUT 値をオーバーライドします。 この値は、指定されたリスナー・ポートを使用して、すべてのメッセージ駆動型 Bean に適用されます。

SERVER.SESSION.POOL.UNUSED.TIMEOUT プロパティーが負の値に設定されていても、このオーバーライドが負以外の値に設定されていると、SERVER.SESSION.POOL.UNUSED.TIMEOUT プロパティーをオーバーライドします。

このオーバーライドが負の値に設定されている場合、指定されたリスナー・ポートのサーバー・セッション・プールのモニターを使用不可にします。

SERVER.SESSION.POOL.UNUSED.TIMEOUT.lpname カスタム・プロパティーは、メッセージング・システムが非 ASF モードで実行されている場合は適用されません。