为 Java 结构化查询语言 (SQLJ) 应用程序定制和绑定配置文件

通过在管理控制台中或使用脚本执行这些功能，简化为您的应用程序定制和绑定 Java 结构化查询语言 (SQLJ) 配置文件的过程。 必须先定制和绑定 SQLJ 概要文件，这样企业应用程序才能使用该应用程序的嵌入式 SQL。

准备工作

您必须有一个已部署并安装在应用程序服务器中的 SQLJ 应用程序。
对于使用容器管理的持久性的 SQLJ 应用程序，可以通过两种方法来部署该应用程序：
  • 在应用程序服务器中部署该 SQLJ 应用程序。 有关更多信息，请参阅“部署使用了容器管理的持久性 (CMP) 的 SQLJ 应用程序”主题。
  • 使用 ejbdeploy 工具来部署 SQLJ 应用程序。 请参阅“使用 ejbdeploy 工具来部署使用了容器管理的持久性 (CMP) 的 SQLJ 应用程序”主题。
对于使用 Bean 管理的持久性的 SQLJ 应用程序，请参阅“部署使用了 Bean 管理的持久性、Servlet 或会话 Bean 的 SQLJ 应用程序”主题。

有关此任务

要利用应用程序服务器中的 SQLJ 应用程序，您需要定制包含嵌入式 SQL 语句的 SQLJ 概要文件。 默认情况下，四个DB2®在数据库中创建包；每个隔离级别一个。 定制过程会使用特定于以下方面的信息来增强配置文件： DB2数据库。 在运行时，数据库将使用此信息。

除了配置文件自定义之外，您还需要将自定义的配置文件绑定到DB2数据库。 只有在定制 SQLJ 概要文件之后，才应该绑定概要文件。

您还可以通过进行脚本编制或使用 db2sqljcustomize 工具来定制和绑定概要文件：
  • 要了解脚本编制支持，请参阅“AdminTask 对象的应用程序管理命令组”主题。
  • 有关 db2sqljcustomize 工具的信息，请参阅“通过 db2sqljcustomize 工具来定制和绑定 SQLJ 概要文件”主题。 如果使用 db2sqljcustomize 工具来定制概要文件，那么需要重新安装应用程序。

过程

  1. 请确保必需的数据库表存在，如“部署数据访问应用程序”主题所述。
  2. 浏览到安装在应用程序服务器中的 SQLJ 应用程序。
    点击应用>WebSphere企业应用程序>应用程序名称。
    避免麻烦：请勿运行管理控制台的多个会话来定制和绑定同一 EAR 文件中的配置文件。
  3. 浏览到“SQLJ 概要文件”部分。
    点击SQLj 配置文件。 单击此链接时，应用程序服务器会将该应用程序的 EAR 文件展开到一个临时目录中；在 SQLJ 概要文件的面板显示之前，可能会有延迟。
  4. 选择自定义并绑定配置文件或者绑定包。
    根据您使用的概要文件来选择选项：
    • 如果尚未定制概要文件，或者您想再次定制概要文件，请选择定制和绑定概要文件。
    • 如果已定制概要文件，请选择绑定程序包。
  5. 选择要定制和绑定的概要文件或概要文件组。
    • 从提供的列表中选择概要文件。
      1. 从列表中选择概要文件，然后单击添加。 该列表将显示企业应用程序中存在的 SQLJ 概要文件。
        最佳实践：
        • 通过按住 CTRL 键选择多个概要文件。
        • 通过选择第一个概要文件名，接着按住 SHIFT 键并选择最后一个概要文件来选择一组相邻的概要文件。 这将选择第一个概要文件、最后一个概要文件以及他们之间的任何概要文件。
      2. 选中将所选 SQLj 概要文件作为一个组进行定制/绑定。此选项指定应用程序服务器将创建一个包含所处理的 SQLj 概要文件的 .grp 文件。 以后，您可以使用这个 .grp 文件来执行其他绑定操作。 完成此面板后，单击好的，您将可以选择下载.grp文件。
    • 选中使用概要文件组文件来指定要定制/绑定的概要文件。 选择此选项以指定要处理的概要文件组。 点击浏览... 在系统上找到该文件。
  6. 填写连接到数据库所需的信息。
    您需要填写下列字段：
    数据库 URL
    指定要与概要文件绑定的数据库的 URL。 典型语法是：
    jdbc:db2://<host name="">:<port>/<database name="">.</database></port></host> or
    或
    fully_qualified_host_name:port
    用户
    指定数据库所在服务器上的数据库管理员的用户标识。
    密码
    指定数据库所在服务器上的数据库管理员的密码。
    其他选项
    指定在定制和绑定过程中要使用的其他选项。 查看DB2文档以获取完整的自定义选项列表。
    类路径
    指定 sqlj.zip 以及 db2jcc.jar 或 db2jcc4.jar 的类路径。
  7. 单击确定。
    避免麻烦：如果您正在处理大型企业应用程序，或者正在处理许多 SQLJ 配置文件，则该过程可能比管理控制台的默认超时时间更长。 应用程序服务器的管理控制台的缺省连接超时设置为 30 分钟。 如果达到缺省超时，并且丢失与服务器的连接，那么您可以检查系统输出日志以了解定制和绑定过程的最终结果。

    为了防止此类断开连接，请将控制台会话超时配置为更长的时间段。 在成功完成定制和绑定过程后，请在系统输出日志中查找处理时间总计。 使用该时间段作为新超时值的基础。 有关如何配置控制台超时的信息，请参阅“更改控制台会话到期时间”主题。

结果

在应用程序服务器处理 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.