IMS 资源适配器的记录和跟踪

除了其它 J2EE 组件以外,IMS 资源适配器也提供了一些控件来记录和跟踪组件信息。当设置了这些控件来进行记录和跟踪并且使用“Rational 单元测试环境”运行 Java™ 应用程序之后,就会创建一个跟踪文件。

注意:确保当跟踪打开时只有一个客户机在运行。

可以使用 WebSphere 测试环境或 WebSphere Application Server 实例来设置用于记录和跟踪的控件。下列步骤描述了如何在这两种环境中设置控件。

  1. 如果您正在使用 WebSphere V5.x 测试环境,则完成下列步骤:
    1. 在 Web 视图中,选择服务器选项卡。
    2. 双击测试环境以打开 Rational 服务器配置编辑器。
    3. 在该编辑器中选择 J2C 选项卡。
    4. J2C 选项页面上,从 J2C 资源适配器表中选择一个 IMS 资源适配器。
    5. 向下滚动至 J2C 连接工厂表,并选择想要对其打开跟踪的连接工厂。
    6. 向下滚动至资源属性表,并选择 TraceLevel 资源属性。 指定一个非零值以启用记录和跟踪。TraceLevel 值对应于 com.ibm.connector2.ims.ico.IMSTraceLevelProperties 接口中的常量。
      TraceLevel 值 IMSTraceLevelProperties 描述
      0 RAS_TRACE_OFF 不进行跟踪或记录。
      1 RAS_TRACE_ERROR_EXCEPTION 只记录错误和异常。
      2 RAS_TRACE_ENTRY_EXIT 记录错误、异常以及重要方法的入口和出口。
      3 RAS_TRACE_INTERNAL 记录错误、异常以及重要方法的入口和出口,还会记录发送至 IMS Connect 和从 IMS Connect 接收到的缓冲区的内容。
    7. J2C 选项卡的页面上输入 TraceLevel 值之后,选择跟踪选项卡。
    8. 确保选择了启用跟踪复选框。 要在 IMS 资源适配器中启用记录和跟踪,在跟踪字符串字段中输入以下内容:
      com.ibm.connector2.ims.*=all=enabled
      com.ibm.ims.ico.*=all=enabled
      其它跟踪字符串组合将在其它组件中启用跟踪。例如,借助以下跟踪字符串:
      com.ibm.ejs.j2c.*=all=enabled:com.ibm.connector2.*=all=enabled

      字符串 com.ibm.ejs.j2c.* 可为您提供对“J2EE 连接器体系结构”的 WebSphere 实现的记录和跟踪;而字符串 com.ibm.connector2.* 可为您提供对所有资源适配器(包括 IMS™)的记录和跟踪。

    9. 您可以接受跟踪输出文件的缺省名称和位置,也可以修改它。 例如,根据您是如何设置替换变量的,缺省名称和位置可能是:
      your_workspace\.metadata\.plugins\com.ibm.etools.server.core\tmp0\logs\server1\trace.log
      要修改缺省名称和位置,在 WebSphere V5.x 测试环境中,在服务器配置的跟踪选项页面上的跟踪输出文件字段中,为该文件输入另外一个名称和位置。
    10. 完成了这些更改之后,关闭编辑器并选择以保存更改。
    11. 检查服务器选项卡的状态列,必要时可重新启动服务器实例。如果您正在使用 Rational 测试环境,则很可能需要重新启动服务器实例。
    12. 运行 Java 应用程序,然后检查跟踪文件。
  2. 如果您正在使用 WebSphere Application Server V6.0 服务器实例,则完成下列步骤:
    1. 在“服务器”视图中,右键单击服务器,然后选择运行管理控制台 “管理客户机”登录窗口在“Web 浏览器”视图中打开。
    2. 输入管理控制台的用户标识。 此用户标识是任意的。此用户标识的用途仅仅是为了进行登录。
    3. 在左窗格中,单击资源适配器并选择资源适配器。
    4. 单击 J2C 连接工厂,并选择要对其打开跟踪的连接工厂。
    5. 选择定制属性
    6. 选择 TraceLevel
    7. 向下滚动至资源属性表,并选择 TraceLevel 资源属性。 指定一个非零值以启用记录和跟踪。TraceLevel 值对应于 com.ibm.connector2.ims.ico.IMSTraceLevelProperties 接口中的常量。
      TraceLevel 值 IMSTraceLevelProperties 描述
      0 RAS_TRACE_OFF 不进行跟踪或记录。
      1 RAS_TRACE_ERROR_EXCEPTION 只记录错误和异常。
      2 RAS_TRACE_ENTRY_EXIT 记录错误、异常以及重要方法的入口和出口。
      3 RAS_TRACE_INTERNAL 记录错误、异常以及重要方法的入口和出口,还会记录发送至 IMS Connect 和从 IMS Connect 接收到的缓冲区的内容。
    8. 单击确定
    9. 单击保存链接。
    10. 单击保存按钮。
    11. 要输入跟踪字符串以将跟踪规范设置为期望状态,在控制台导航树中选择故障诊断 > 记录和跟踪
    12. 选择服务器名称并单击更改日志级别详细信息
    13. 要在 IMS 资源适配器中启用记录和跟踪,在“跟踪字符串”框中输入以下内容:
      com.ibm.connector2.ims.*=all
      com.ibm.ims.ico.*=all
    14. 选择应用,然后单击确定
    15. 浏览至故障诊断 > 记录和跟踪 > 服务器名称 > 诊断跟踪
    16. 在“配置”选项卡上选择启用记录(如果尚未选择它的话)。
    17. 您可以接受跟踪输出文件的缺省名称和位置,也可以修改它。例如,根据您是如何设置替换变量的,缺省名称和位置可能是: your_workspace\.metadata\.plugins\com.ibm.etools.server.core\tmp0\logs\server1\trace.log
    18. 单击“运行时”选项卡,并选择还要将运行时更改保存至配置(如果尚未选择它的话)。
    19. 单击确定
    20. 检查服务器选项卡的状态列,必要时可重新启动服务器实例。如果您正在使用 Rational 测试环境,则很可能需要重新启动服务器实例。
    21. 运行 Java 应用程序,然后检查跟踪文件。
相关参考
诊断使用 IMS 资源适配器时产生的问题
J2CA0294W、J2CA0056I、WLTC0017E、HWSP1445E 和 HWSSL00E 错误消息
IMS 资源适配器消息和异常
使用条款 | 反馈
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.