管理连接器日志文件

SAP 应用程序中的连接器日志按年月日的相反顺序显示与连接器相关的所有事件和错误,例如,“创建”或“更新”操作或者到达事件队列中的事件。日志文件列示每个日志条目的日期、时间和事件。日志文件将大大有利于开始对问题进行故障诊断。

设置日志选项

您可以将全局设置和用户设置设置为您希望写入到连接器日志文件的详细信息级别以及您希望显示的条目数和数据类型。要使用 IBM WebSphere BI Station 设置连接器日志记录级别,单击“配置”选项卡,然后在“日志记录级别”下选择级别 0 - 3。

日志记录的四个级别为如下所示:

注:
建议不要使用日志记录级别 0。建议将日志记录级别 1 用于生产系统。建议将日志记录级别 3 用于开发或调试系统。

显示日志

要查看最近处理的对象和与它们相关的详细信息,显示连接器日志。要在 SAP 应用程序中显示连接器日志:

  1. 转至 IBM WebSphere BI Station(事务 /n/CWLD/HOME)。
  2. 单击“管理”选项卡,然后单击“日志”按钮。

日志条目显示日期、时间和事件。这些条目是用彩色编写的:

绿色 - 指示成功的事件

黄色 - 指示警告消息

红色 - 指示错误

白色 - 指示已归档的对象

品红色(4.6 之前的 SAP 应用程序 GUI 版本)或橙黄色(SAP 应用程序 GUI 版本 4.6 和更新版本)条目提供有关事件开始和结束的信息。单击任何箭头以链接至该业务对象的 SAP 的显示事务。

过滤日志详细信息

可以更改显示的关于每个事件的详细信息量。要更改显示级别,根据您想要的详细信息级别单击“更多详细信息”或“较少详细信息”按钮。

如果显示的数据量多于您当前需要的量,则缩小显示的信息。例如,可以按用户、名称、日期或日志条目号来查看业务对象。

  1. 单击“过滤数据”按钮。
  2. 填充适当的字段以过滤日志文件。
  3. 单击“过滤器”。

在“配置”选项卡中,可以设置用户设置以便同时显示许多日志条目,并且可以设置缺省日志记录显示级别。

重新处理已归档的对象

可以重新处理连接器日志文件中的已失败或已归档的对象。失败的对象就是 SAP 中未能成功处理的对象。已归档的对象就是配置为已归档但是未处理的对象。在任何一种情况下,您都可以通过在代码的特定位置设置断点来以手工方式逐步执行对象。仅对于“动态事务”和 IDoc 对象,才能为事务逐步执行各个屏幕。

可以在执行下列操作之前设置断点:

“动态事务”和 IDoc 对象使用调用事务;因此,可以查看这些对象的屏幕处理。您具有下列查看选项:

“动态检索”和 BAPI 对象不使用屏幕处理。

配置要归档的对象

缺省情况下,在发生故障时,将对未指定任何归档选项(选项 AXN,它们在业务对象查询描述的特定于应用程序的信息中指定)的 ABAP 扩展模块业务对象进行归档。换句话说,当处理产生除 0 或 21 以外的返回码时,业务对象将归档在 /cwld/obj_arc_h/cwld/obj_arc_i 表中。

重要提示:
因为这些归档表在不断增大,所以它们必须定期删除或归档它们的内容,以防止影响整个数据库的性能。

改变归档行为是在业务对象的查询描述级别完成的;即,对于每个业务对象,归档活动可以随查询描述不同而不同。 要指定对象如何进行归档,在查询描述的特定于应用程序的信息中使用以下语法:

AppSpecificInfo = connectormodule.class, ArchiveParameter: ABAPhandler
 

其中 ArchiveParameter

A
当对象首次进入 SAP 应用程序时进行归档。

N
禁止对象归档。即使在发生故障的情况下,也不会将对象归档。

X
立即将对象归档。将用一条指出处理已结束的警告消息来更新日志。成功代码将返回到连接器,以便成功地处理请求集成代理程序。

一次可以指定多个参数。AX 归档参数将为日志表中的条目添加与 IBM WebSphere BI Station 中的重新处理工具的链接。已归档对象的状态是在已归档业务对象的条目下面的行中输入的。

以下示例将对“动态事务”对象进行归档并在日志表中添加一个条目。

AppSpecificInfo = sap.sapextensionmodule.VSapBOHandler,
 A:/CWLD/DYNAMIC_RETRIEVE 
 

以下示例将在 IDoc 对象 SAP4_Order Create 进入 SAP 应用程序时对该对象进行归档,然后停止处理该对象。

AppSpecificInfo = sap.sapextensionmodule.VSapBOHandler,
 X:/CWLD/ORDER:ORDER_C1
 

注:
在生产环境中,对业务对象和它们所有的查询描述只使用 N 参数。当 WebSphere InterChange Server 是集成代理程序时,应当只使用“系统管理器”来重新处理和重新提交业务对象;在 SAP 应用程序中应该使用 IBM WebSphere BI Station 重新处理工具。当 WebSphere MQ 消息代理是集成代理程序时,将把在“连接器框架”中失败的事件移至 FaultQueue,这些事件应当由 MQ 消息流处理。

使用重新处理工具

“重新处理工具”使您能够使用“ABAP 调试器”来为 SAP 重新处理 WebSphere 业务对象。

注意: 只应在开发环境中使用此工具。

要重新处理已归档的对象:

  1. 转至 SAP 应用程序中连接器的日志。
  2. 双击已归档的对象条目。

    出现“归档表中的 CW 重新处理对象”窗口。它的“已归档的对象号”字段已填充了对象号。

  3. 对您想设置的断点单击“设置断点”复选框。必要时可以设置多个断点。
  4. 对于使用“调用事务”的对象,可以选择屏幕处理选项。
  5. 单击“执行”(F8)。

    使用已归档的对象来调用“ABAP 调试器”。

  6. 使用“ABAP 调试器”来逐步执行对象。

要手工访问 IBM WebSphere BI Station 中的“重新处理工具”,单击“工具”选项卡中的“重新处理对象”。在所提供的字段中输入适当的值。

删除已归档的对象

可以使用适配器提供的“删除归档对象”工具来删除 SAP 应用程序中已归档的对象。此工具使您能够手工删除已归档的对象。一旦删除了已归档的对象,该对象在连接器日志中的条目就会更新为新的状态。该对象将真正被删除,将只保留该对象的状态以供参考。

要使用 IBM WebSphere BI Station(事务 /n/CWLD/HOME)来删除已归档的对象:

  1. 从“维护”选项卡中单击“删除对象归档”按钮。
  2. 指定要删除的对象。可以根据下列条件来删除对象:
  3. 单击“执行”(F8)。

要安排归档对象程序自动删除对象,请与 Basis 管理员联系并查阅安排报告 /CWLD/DELETE_OBJECT_ARCHIVE。可以安排此报告作为后台进程运行。

设置事件日志的截断

SAP 保留连接器活动的事件日志。随着时间的过去,此日志可以占用大量磁盘空间。要节省磁盘空间,您可以将此日志设置为自动截断。当设置自动截断时,缺省情况下,SAP 将截断的条目打印到设置该作业的用户的缺省打印机。因此,您还可能要控制打印选项。

要手工截断日志:

  1. 转至 IBM WebSphere BI Station(事务 /n/CWLD/HOME)。
  2. 单击“维护”选项卡。
  3. 在“联机”部分,单击“删除日志”。
  4. 填充适用字段。
  5. 单击“执行”按钮(F8)。

要安排自动截断事件日志,设置截断选项,并与 Basis 管理员联系以安排报告 /CWLD/DELETE_LOG

重要提示:
建议您定期运行此报告。

Copyright IBM Corp. 1997, 2004