分层动态检索模块故障诊断

本节描述当启动或运行分层动态检索模块时可能会遇到的问题。它包括以下几个方面:

错误处理和日志记录

连接器在遇到导致检索失败的情况时将一条错误消息写入日志。当发生这样的错误时,连接器还会打印从集成代理程序接收到的失败业务对象的文本表示。它将该文本写入连接器日志文件或标准输出流,这取决于其配置。您可以使用该文本来查找错误源。

错误类型

表 7 描述了 分层动态检索模块在每个跟踪级别输出的跟踪消息的类型。此外,这些消息还是 WebSphere Business Integration 系统体系结构(如 Java 连接器执行包装程序和 WebSphere MQSeries 消息接口)的任何跟踪消息输出。

表 7. 连接器跟踪消息
跟踪级别 跟踪消息
级别 0 标识连接器版本的消息。

此级别不执行其它跟踪。

级别 1 功能模块进入和退出消息。无论连接器执行线程何时进入或退出功能,都会写入这些消息。这些消息有助于跟踪连接器的进程流。
级别 2 包含诸如连接器在处理业务对象期间遇到或检索的数组和子业务对象等信息的业务对象处理程序消息。
级别 3
  • 包含诸如连接器何时在业务对象中发现或设置外键等信息的外键处理消息。
  • 提供关于业务对象处理的信息的消息。例如,当连接器在业务对象之间查找匹配、在一组子业务对象中查找业务对象或在检索期间除去子业务对象时,将传递这些消息。

级别 4
  • 特定于应用程序的参考消息,例如,显示由功能返回的值的消息,该功能对业务对象的特定于应用程序的信息属性进行语法分析。
  • 标识连接器何时进入或退出 Java 方法的消息,这些消息有助于跟踪连接器的进程流。
  • SQL 语句。在此级别和以上级别,连接器打印它执行的所有 SQL 语句。
  • 在检索期间对属性值的更改。在此级别和以上级别,连接器打印属性的名称及其新的值。

级别 5
  • 指示连接器初始化的消息,例如,显示从集成代理程序检索到的每个配置属性的值的消息。
  • 包含业务对象转储的消息。
  • 包含连接器开始处理业务对象之前业务对象的表示(当连接器从集成代理程序接收到业务对象时显示业务对象的状态)和在连接器完成其处理之后业务对象的表示(当连接器将业务对象返回至集成代理程序时显示业务对象的状态)的消息。

连接器消息文件

连接器生成的错误消息存储在名为 SAPConnector.txt 的消息文件中。每个错误都有一个错误号,后跟错误消息。例如:

1210
  
 SAP 分层动态检索模块无法初始化。
  
 1211
  
 SAP 分层动态检索模块未能找到...
 

未能调用 RFC_READ_TABLE

SAP RFC_READ_TABLE 功能不处理基于字符的数据类型。如果字段使用以下数据类型,则该模块在检索数据时可能失败:

SQL SELECT 失败

如果 SELECT 语句失败,则检查标记为“键”或用作外键的任何简单属性是否包含单引号(')。如果包含,则修改业务对象的映射以将单引号(')转换为两个单引号('')。

Copyright IBM Corp. 1997, 2004