SQLJ (Structured Query Language in Java) アプリケーション用のプロファイルのカスタマイズおよびバインディング

管理コンソールまたはスクリプトによってこれらの機能を実行することにより、 アプリケーションの SQLJ プロファイルをカスタマイズしてバインディングするプロセスを簡略化します。エンタープライズ・アプリケーションでアプリケーションの組み込み SQL を使用するには、SQLJ プロファイルをカスタマイズし、バインドする必要があります。

始める前に

アプリケーション・サーバーにデプロイ済みおよびインストール済みの SQLJ アプリケーションがある必要があります。
コンテナー管理パーシスタンスを使用する SQLJ アプリケーションの場合は、次の 2 つの方法でアプリケーションをデプロイできます。
  • アプリケーション・サーバーに SQLJ アプリケーションをデプロイします。詳しくは、 コンテナー管理パーシスタンス (CMP) を使用する SQLJ アプリケーションのデプロイに関するトピックを参照してください。
  • EJB デプロイメント・ツールを使用して SQLJ アプリケーションをデプロイします。コンテナー管理パーシスタンス (CMP) を使用する SQLJ アプリケーションの EJB デプロイメント・ツールによる デプロイに関するトピックを参照してください。
Bean 管理パーシスタンスを使用する SQLJ アプリケーションの場合は、Bean 管理パーシスタンス、サーブレット、 またはセッション Bean を使用する SQLJ アプリケーションのデプロイに関するトピックを参照してください。

このタスクについて

アプリケーション・サーバーで SQLJ アプリケーションを利用するには、 組み込み SQL ステートメントを含む SQLJ プロファイルをカスタマイズする必要があります。 デフォルトでは、分離レベルごとに 1 つずつ、計 4 つの DB2® パッケージがデータベースに作成されます。カスタマイズ・プロセスでは、DB2 データベースに固有の情報を使用してプロファイルを拡張します。実行時にデータベースでこの情報が使用されます。

プロファイルのカスタマイズだけでなく、 カスタマイズされたプロファイルを DB2 データベースにバインドする必要もあります。プロファイルのバインディングは、SQLJ プロファイルのカスタマイズ後にのみ実行する必要があります。

スクリプトによって、または db2sqljcustomize ツールを使用して、プロファイルのカスタマイズおよびバインドを行うこともできます。
  • スクリプトのサポートについては、AdminTask オブジェクトのアプリケーション管理コマンド・グループについてのトピックを参照してください。
  • db2sqljcustomize ツールの詳細については、db2sqljcustomize ツールによる SQLJ プロファイルのカスタマイズおよびバインディングに関するトピックを参照してください。 db2sqljcustomize ツールを使用してプロファイルをカスタマイズする場合は、アプリケーションを再インストールする必要があります。

手順

  1. データ・アクセス・アプリケーションのデプロイに関するトピックの説明に従って、必要なデータベース表が存在していることを確認します。
  2. アプリケーション・サーバーにインストールされている SQLJ アプリケーションにナビゲートします。 「アプリケーション」 > 「Websphere エンタープライズ・アプリケーション」 > app_nameとクリックします。
    トラブルの回避 (Avoid trouble) トラブルの回避 (Avoid trouble): 同一の EAR ファイル内にあるプロファイルをカスタマイズおよびバインドするために、管理コンソールの複数のセッションを実行することはしないでください。gotcha
  3. SQLJ プロファイルのセクションにナビゲートします。 「SQLj プロファイル (SQLj profiles)」をクリックします。このリンクをクリックすると、 アプリケーション・サーバーがアプリケーションの EAR ファイルを一時ディレクトリーに展開します。 ただし、SQLJ プロファイルのパネルの表示が遅れる可能性があります。
  4. 「プロファイルのカスタマイズとバインド (Customize and bind profiles)」または「パッケージのバインド (Bind packages)」を選択します。 作業対象のプロファイルに応じて以下のようにオプションを選択します。
    • プロファイルがカスタマイズされていない場合、またはプロファイルを再度カスタマイズする場合は、「プロファイルのカスタマイズとバインド (Customize and bind profiles)」を選択します。
    • プロファイルがカスタマイズ済みである場合は、「パッケージのバインド (Bind packages)」を選択します。
  5. カスタマイズおよびバインドするプロファイルまたはプロファイル・グループを選択します。
    • 表示されるリストからプロファイルを選択します。
      1. リストからプロファイルを選択して、「追加」をクリックします。エンタープライズ・アプリケーションに存在する SQLJ プロファイルがリストに表示されます。
        ベスト・プラクティス ベスト・プラクティス:
        • 複数のプロファイルを選択するには、Ctrl キーを押しながら選択します。
        • リストの連続するプロファイルを選択するには、 最初のプロファイル名を選択し、Shift キーを押しながら最後のプロファイルを選択します。最初のプロファイル、最後のプロファイル、 およびその間にあるすべてのプロファイルが選択されます。
        bprac
      2. 「選択されている SQLj プロファイルをグループとしてカスタマイズ/バインド (Customize/bind the selected SQLj profiles as a group)」を選択します。 このオプションでは、アプリケーション・サーバーが処理対象の SQLj プロファイルを含む .grp ファイルを作成することを指定します。 将来、他のバインディング操作で .grp ファイルを使用することができます。このパネルを終了し、「OK」をクリックすると、.grp ファイルのダウンロードを選択できます。
    • 「プロファイル・グループ・ファイルを使用してカスタマイズ/バインドするプロファイルを指定する (Use a profile group file to specify profiles to customize/bind)」を選択します。処理するプロファイル・グループを指定する場合には、これを選択します。 システム上のファイルを見つける場合には、「参照...」をクリックします。
  6. データベースに接続するために必要な情報を入力します。 以下のフィールドに入力する必要があります。
    データベース URL
    1 つまたは複数のプロファイルをバインドする先のデータベースの URL を指定します。 標準の構文は次のとおりです。
    jdbc:db2://<host name="">:<port>/<database name="">.</database></port></host> or 
    または
    fully_qualified_host_name:port
    ユーザー
    データベースのあるサーバーのデータベース管理者のユーザー ID を指定します。
    Password
    データベースのあるサーバーのデータベース管理者のパスワードを指定します。
    追加オプション
    カスタマイズおよびバインドのプロセスで使用する追加オプションを指定します。カスタマイズ・オプションの完全なリストについては、DB2 の資料を参照してください。
    クラスパス
    sqlj.zip および db2jcc.jar または db2jcc4.jar のあるクラスパスを指定します。
  7. 「OK」をクリックします。
    トラブルの回避 (Avoid trouble) トラブルの回避 (Avoid trouble): 大規模なエンタープライズ・アプリケーションを処理する場合、 または多くの SQLJ プロファイルを処理する場合、 この処理に管理コンソールのデフォルトのタイムアウトより長く時間がかかる場合があります。アプリケーション・サーバーの管理コンソールのデフォルトの接続タイムアウトは、30 分に設定されています。デフォルトのタイムアウトに到達し、サーバーへの接続が失われた場合は、システムの出力ログを調べ、カスタマイズおよびバインドのプロセスの最終結果について確認することができます。

    このような切断を避けるためには、コンソール・セッションのタイムアウトをより長い時間に設定します。カスタマイズおよびバインディングのプロセスが成功した後、システムの出力ログを調べて全体の処理時間を確認します。その時間を新しいタイムアウトの値の基準として使用します。コンソールのタイムアウトの構成方法については、コンソール・セッションの有効期限の変更に関するトピックを参照してください。

    gotcha

タスクの結果

アプリケーション・サーバーによる SQLJ プロファイルの処理が完了した後、 カスタマイズおよびバインディングの結果が表示されます。結果パネルにデータベース・サーバーのメッセージおよびアプリケーション・サーバーのサマリー結果が表示されます。
操作が正常に完了した場合は、システム・ログに以下のメッセージが出力されます。
ADMA0507I=ADMA0507I: The SQLJ operation on application {0} completed successfully.  Exit code: {1}
ADMA0507I.explanation=This informational message indicates the program status.
ADMA0507I.useraction=No user action is required.
操作が正常に完了しなかった場合は、システム出力ログに以下のメッセージが出力されます。
ADMA0506I=ADMA0506I: The SQLJ operation on application {0} did not complete successfully.  Exit code: {1}
ADMA0506I.explanation=The SQLJ operation encountered a problem.  This informational message indicates
the program status. Prior messages in the command output give details of the problem.
ADMA0506I.useraction=Check the command output for the cause of the problem.

トピックのタイプを示すアイコン タスク・トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tdat_sqljcustomize
ファイル名:tdat_sqljcustomize.html