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

通过使用管理控制台或进行脚本编制执行下列功能,简化为应用程序定制和绑定 SQLJ 概要文件的过程。必须先定制和绑定 SQLJ 概要文件,这样企业应用程序才能使用该应用程序的嵌入式 SQL。

开始之前

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

关于此任务

要利用应用程序服务器中的 SQLJ 应用程序,您需要定制包含嵌入式 SQL 语句的 SQLJ 概要文件。缺省情况下,将在数据库中创建 4 个 DB2® 程序包;即,为每个隔离级别创建一个程序包。定制过程将使用特定于 DB2 数据库的信息来扩充概要文件。在运行时,数据库将使用此信息。

除定制概要文件以外,您还需要将经过定制的概要文件与 DB2 数据库绑定。只有在定制 SQLJ 概要文件之后,才应该绑定概要文件。

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

过程

  1. 请确保必需的数据库表存在,如“部署数据访问应用程序”主题所述。
  2. 浏览到安装在应用程序服务器中的 SQLJ 应用程序。 单击应用程序 > WebSphere 企业应用程序 > app_name
    避免故障 避免故障: 请勿通过运行管理控制台的多个会话来定制和绑定同一个 EAR 文件中的概要文件。gotcha
  3. 浏览到“SQLJ 概要文件”部分。 单击 SQLJ 概要文件。单击此链接时,应用程序服务器会将该应用程序的 EAR 文件展开到一个临时目录中;在 SQLJ 概要文件的面板显示之前,可能会有延迟。
  4. 选择定制和绑定概要文件绑定程序包 根据您使用的概要文件来选择选项:
    • 如果尚未定制概要文件,或者您想再次定制概要文件,请选择定制和绑定概要文件
    • 如果已定制概要文件,请选择绑定程序包
  5. 选择要定制和绑定的概要文件或概要文件组。
    • 从提供的列表中选择概要文件。
      1. 从列表中选择概要文件,然后单击添加。该列表将显示企业应用程序中存在的 SQLJ 概要文件。
        最佳实践 最佳实践:
        • 通过按住 CTRL 键选择多个概要文件。
        • 通过选择第一个概要文件名,接着按住 SHIFT 键并选择最后一个概要文件来选择一组相邻的概要文件。这将选择第一个概要文件、最后一个概要文件以及他们之间的任何概要文件。
        bprac
      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 分钟。如果达到缺省超时,并且丢失与服务器的连接,那么您可以检查系统输出日志以了解定制和绑定过程的最终结果。

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

    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