カスタム・ファインダー SQL 動的機能拡張プロパティー

このページを使用して、カスタム・ファインダー SQL 動的機能拡張プロパティーの設定を変更します。

特別な SQL ロック文節を必要とするバックエンド・データ・ストアを使用する EJB 1.1 ホーム・インターフェースで定義されているカスタム・ファインダー用に、Structured Query Language (SQL) 動的機能拡張が適切に行われるようにするために、以下の Java™ 仮想マシン (JVM) および Bean (モジュール) プロパティーが提供されています。これらのプロパティーによって、機能拡張するカスタム・ファインダーを指定できます。 これは、バックエンドのデータ・ストアが、SQL 文節をサポートしていることが前提です。

[iSeries] [AIX Solaris HP-UX Linux Windows] IBM i® および分散プラットフォームの場合、 この管理コンソール・ページを表示するには、「サーバー」 >「サーバー・タイプ」>「WebSphere Application Server」> server_name >「Java およびプロセス管理」>「プロセス定義」>「Java 仮想マシン」 >「カスタム・プロパティー」の順にクリックします。

[z/OS] z/OS の場合、この管理コンソール・ページを表示するには、 「サーバー」>「サーバー・タイプ」>「WebSphere Application Server」 > server_name > 「コントロール」 (「コントロール」でプロパティーを定義する場合) または「サーバント」 (「サーバント」でプロパティーを定義する場合) >「Java およびプロセス管理」 >「プロセス定義」>「Java 仮想マシン」>「カスタム・プロパティー」の順にクリックします。

com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent

どのエンタープライズ Bean で、実行時にカスタム・ファインダー SQL 動的機能拡張を使用可能にするかを指定するために使用します。

このプロパティーは、サーバー・レベルで有効になります。 アクセス・インテントが Update の、EJB 1.1 ホーム・インターフェース定義のカスタム・ファインダー (接頭部名は find) は、その指定した分離レベルに基づくカスタム・ファインダー SQL 動的機能拡張の候補です。 バックエンドのデータ・ストアに特別な SQL セマンティクスが必要な場合には、それらが適用されます。 使用される特定の SQL は、アプリケーション内の Bean に対して選択した分離レベル、および使用されているバックエンドのデータベースに応じて変化します。 「all」に設定されている場合には、カスタム・ファインダー SQL 動的機能拡張が、 コンテナーにインストールされているすべての Bean に定義されたすべてのカスタム・ファインダーに対して使用可能になります。 「J2EENAME[:J2EENAME]」(ここで、J2EENAME は、完全修飾パッケージ、または Bean 名です) に設定されている場合には、 カスタム・ファインダー SQL 動的機能拡張が、コンテナーにインストールされ、指示された Bean 名で表示されている Bean に定義されたカスタム・ファインダーに対してのみ使用可能になります。

データ型 ストリング
範囲 有効な値は、「all」または「J2EENAME[:J2EENAME]」です。
デフォルト 機能拡張の振る舞いが非アクティブ
注: ユーザー・アプリケーションの中には、手動でコード化されたカスタム・ファインダーで、SQL ロック文節、または SELECT オペレーションのキーワード ORDER BY および DISTINCT を既に含んだものを使用している場合があります。 これらのインスタンスで、ランタイムが SQL 動的機能拡張を試行する場合には、基礎をなすバックエンドのデータ・ストアに誤った形式の SQL ステートメントが発生する可能性があります。 アプリケーションにこれらのカスタム・ファインダーが含まれている場合には、JVM プロパティー com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent に値を指定する際に注意する必要があります。 「all」の値によって、カスタム・ファインダー SQL 動的機能拡張は、アプリケーション・サーバーにインストールされているすべての Bean で検出される、Update のアクセス・インテントで定義されたそれぞれのカスタム・ファインダー・メソッドごとに実行されます。これによって、カスタム・ファインダーのそのサブセットに、誤った形式の SQL が発生します。

この問題を避けるために、サーバー全体の設定を「all」に設定しないでください。 代わりに、Bean メソッド・レベル・プロパティー com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent.methodLevel を使用して、Bean ごとに、 カスタム・ファインダー SQL 動的機能拡張を実行時に Bean で実行させるカスタム・ファインダー・メソッドのみを指定します。

com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent.methodLevel

特定の Bean 上で、カスタム・ファインダー SQL 動的機能拡張をメソッド・レベルで使用可能にすることを指定するために使用します。

1 つ以上のカスタム・ファインダー・メソッドのリストに設定されたこのプロパティーを使用して Bean が定義されている場合には、 マッチング・メソッド名およびパラメーター・シグニチャーを持つホーム・インターフェース上に定義されたすべてのカスタム・ファインダー (接頭部の名前は find) は、 実行時に SQL ロック・セマンティクスを適用します。 カスタム・ファインダー・メソッドに、アクセス目的として Update が指定され、 バックエンドのデータ・ストアが SQL 文節をサポートしている場合にのみ、これは発生します。 使用される特定の SQL は、アプリケーションに選択された分離レベル、および使用されているバックエンドのデータベースに応じて変化します。

データ型 ストリング
範囲 有効な値は、次の形式のストリングです。method1(parm1,parm2,..parmn):method2(parm1,parm2,..parmn):methodn(...)



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

関連タスク
[AIX Solaris HP-UX Linux Windows] [iSeries]


ファイル名: udat_sqllock.html