使用归档公用程序


概述

任务

见于

Tivoli 问题管理

概述

帮助主题的内容

完成配置归档公用程序中所述的安装过程后,就可准备使用归档公用程序了。此帮助主题说明使用归档公用程序的下列方面:
  • 配置归档选项
  • 运行归档公用程序
  • 管理归档进程
  • 确保与 Tivoli 问题管理的修改兼容

配置选项

在能够归档数据之前,必须用适当信息配置归档公用程序。必须指定下列信息:

Tivoli 问题管理配置

要正确归档数据,归档公用程序必须访问正确的 Tivoli 问题管理数据库表。

应验证显示在“Tivoli 问题管理归档公用程序”窗口中的 Tivoli 问题管理版本与数据库信息是正确的。

如果所列的 Tivoli 数据源不是 Tivoli 问题管理的生产数据源,则:

归档数据的目的地

在能够归档数据之前,必须为归档的项指定目的地。可从下列三个选项中进行选择:
  • 文本文件
  • 数据库
  • 删除数据

如果选择将数据归档到文本文件中,则该文件中的每一行都表示某表中的一个记录。要归档到文本文件中,必须指定要在其中归档数据的文件。请参阅用于归档公用程序的 API,以获取有关文本文件的详细信息。

如果选择归档到数据库,则归档的数据存储在缺省数据库中的归档表中。该缺省数据库在“Tivoli 问题管理归档公用程序”窗口中被标识为 Tivoli 数据源。要归档到数据库,目的地数据库表必须已经存在。请参阅创建目的地数据库表,以获取有关创建归档表的详细信息。

如果选择删除数据,则所有归档的项都被删除。它们不被复制到文本文件中或归档数据库表中。

注意:如果选择此选项,则不能检索已删除的数据来用于任何目的!

要归档的数据的日期

归档的项可以是处于“已关闭”状态的任何问题或信息呼叫。这些问题和呼叫的关闭状态是在某一特定日期指定的。要指定将归档哪些数据项,应指定要归档的项被指定为关闭状态的日期范围。

请注意所指定的日期包括首末日期,即归档的问题包括在开始日期与结束日期指定为关闭状态的那些问题。

要归档的项

为了执行归档过程,必须指定要归档的项数。

项可由多个表中的多个记录组成。例如,信息呼叫由一个 CALL 与一个或多个 SESION 记录组成。

如果是先指定归档日期,则可使用“估计”功能来确定在给定范围内要归档的项数。“估计”可计算要归档的项数,并将该结果显示在“总的归档项”框中。

当不能确定要归档的数据项数或需要限制要归档的项数时,此估计功能很有用。如果由“估计”计算的项数太多,您可缩小日期范围或指定一个较小的项数。

如果是首次运行归档公用程序,则使用不同的数值确定在您的站点归档数据所需的时间很有用。可在“承诺大小”和“总项数”文本框中使用不同的值来测试您站点的性能。

承诺大小

必须为归档过程指定承诺大小。

承诺大小指的是在执行数据库“承诺”之前要归档的项数。此数应该比回退段的值小得多,因为一个项由多个 CALL、SESION、WORK_HISTORY、PROBLEM_HISTORY 和 PROBLEM 记录组成。缺省情况下,承诺大小为 50 项。

应将承诺大小与回退段配置得可进行大量数据转移。请参阅您站点的数据库文档来确认您数据库使用的承诺大小和回退段。仅在数据库管理员授权之后才能修改该值。

与 Tivoli 问题管理的兼容性

因为归档公用程序要用到 Tivoli 问题管理的数据,所以对 Tivoli 问题管理进行的修改或定制可能影响归档公用程序。修改 Tivoli 问题管理时,必须确保归档公用程序与这些修改兼容。

下列 Tivoli 问题管理的修改要求更改归档公用程序,才能使用 Tivoli 问题管理数据:

  • 安装归档公用程序之后再安装 Tivoli 问题管理
  • 定制 Tivoli 问题管理的 PROBLEMS、SESION、CALL、PROBLEM_HISTORY 或 WORK_HISTORY 表

下列各节说明上述修改中的每一修改之后,为了维护 Tivoli 问题管理兼容性所要采取的步骤。

Tivoli 问题管理定制

如果归档到数据库,且已对 Tivoli 问题管理数据库中的下列任何表进行定制,则必须定制归档公用程序,以反映这些更改:
  • PROBLEMS
  • SESION
  • CALL
  • PROBLEM_HISTORY
  • WORK_HISTORY

定制归档表包括两个单独的步骤:

  • 修改创建这些归档表的建立脚本修改这些表本身
  • 编辑 eaacust.kb 文件,以反映归档表中的更改

安装前,定制归档数据库表的最简单方式是修改建立这些表的脚本。但是,安装后重新运行建立脚本会毁坏这些表中的所有数据。替代办法是,应对归档数据库表本身直接进行必要的定制。请参阅您的 DBMS 的文档,以获取有关定制数据库表的详细信息。

何时修改 eaacust.kb

归档公用程序所使用的每个 Tivoli 问题管理表都对应 eaacust.kb 文件中的一个过程。下面列出了这些过程名称。每个过程的名称都包括它所对应的表的名称。
  • EAProblems
  • EASesion
  • EACall
  • EAProblem_History
  • EAWork_History

如果已在 Tivoli 问题管理中定制了上述任何表,则必须在 eaacust.kb 文件中修改相应的过程条目。

字符串或整数数据

依已添加到 Tivoli 问题管理表中的数据类型的不同,需要使用不同的过程来定义 eaacust.kb 过程中的新字段。
  • 对于字符串,如 charvchar 字段,使用 AddStr
  • 对于非字符串,如整数和日期字段,使用 AddNonStr

该 AddStr 和 AddNonStr 过程采用相同的参数:

( VAL Wrap : STRING, VAL Delmtr : STRING, 
REF str : STRING, VAL newstr : STRING)

下面是参数说明:

参数 说明
Wrap 在输出文本文件中放在字符串与非字符串周围的字符
Delmtr 在输出文本文件中用来分隔列的字符
str 运行时已定义其值的引用参数。总是将“str”用作此参数的自变量。
newstr 新字段的名称

请参阅用于归档公用程序的 API,以了解要用作这些参数的自变量的每个文件引出字符的说明。

例如,如果已将某列添加到 Tivoli 问题管理表,则必须向 eaacust.kb 中与该添加的列相对应的过程添加一个新行。

假定已向 Tivoli 问题管理中的 PROBLEM_HISTORY 表添加了一个 Problem_code 字段,以跟踪这些问题代码的更改,则必须向 eaacust.kb 中与该 Problem_code 字段对应的 EAProblem_History 过程添加一个新行。

因为问题代码是字符串,所以您在 EAProblem_History 过程中所添加的定义新的 Problem_Code 字段的行看起来类似如下行:

AddStr( STD, DELM, str, ph.problem_code);

任务

配置与运行归档公用程序

下列步骤提供使用归档公用程序的指南。
  1. 启动该程序所述启动归档公用程序。
    出现“Tivoli 问题管理归档公用程序”窗口。
  2. 在“Tivoli 问题管理配置”下,验证版本与数据源信息。
  3. 在“数据目的地”下,选择发送归档文件的目的位置。
    如果选择“文本文件”,请转至下一步。
    否则,转至步骤 11。
  4. 完成下列操作之一:
    • 在“文件名”框中,输入要在其中归档数据的完整路径和文件名,然后转至步骤 11。
    • 选择“文件名浏览”按钮。
  5. 在“选择文本文件”对话框中,指向某一现有文件作为归档目的地,或转至步骤 8。
  6. 选择“打开”。
  7. 当“文件存在”消息出现,询问是否想将归档数据添加到该文件时,请选择“是”。
    转至步骤 10。
  8. 指向归档文件要驻留的资料夹,然后指定一个文件名。
  9. 选择“打开”。
  10. 重现“Tivoli 问题管理归档公用程序”窗口,其中的“文件名”框已填有文件名。
  11. 完成下列操作之一:
    • 在“关闭日期自”框中,输入要归档的项的开始日期。
    • 选择“日历”按钮,然后使用该“日历”指定日期。
  12. 完成下列操作之一:
    • 在“终止日期”框中,输入要归档的项的结束日期。
    • 选择“日历”按钮,然后使用该日历指定日期。
  13. 完成下列操作之一:
    • 在“总的归档项”框中,输入要归档的项数。
    • 选择“估计”。
  14. 在“承诺大小”框中,输入在执行承诺之前要归档的项的数目,或保留缺省值。
  15. 选择“执行”。
  16. 在“执行”对话框中,选择“确认”。
    出现“归档处理”对话框。
    归档过程结束后,出现“完成”对话框。
  17. 选择“确认”。
  18. 重现“Tivoli 问题管理归档公用程序”窗口时,选择“退出”。
    归档公用程序关闭。

在多台机器上运行归档公用程序

在不同时间在多台机器上运行归档公用程序是可取的办法。选择使用多台机器可能决定于以下因素:
  • 要归档的数据的数量
  • 执行归档的时间限制
    注意:不要一次在 MS-SQL Server 或 Sybase 数据库上运行多个归档公用程序进程。这些数据库支持页面级锁定,而不是行级锁定。同时归档会降低性能。

要在多台机器上同时运行归档公用程序,需要:

  1. 在每台机器上启动“归档公用程序”。
  2. 确保每台机器引用相同的数据源。
  3. 为每台机器输入非重叠的日期范围。
    注:例如,如果在一台机器上使用从 1/1/1997 到 4/15/1997 的日期范围,则可在另一台机器上使用从 4/16/1997 到 6/30/1997 的日期范围。
  4. 选择“执行”。
    包含在每一日期范围内的数据被归档。
    注:在同一数据库上同时运行归档会导致 Tivoli 问题管理的执行速度降低。

归档公用程序运行后删除表

归档公用程序运行之后,您可能想删除用于归档公用程序的表。删除表会节省数据源上的大量空间。

注意:如果已删除的表中的数据以后还要使用,则在删除这些表之前应对其加以备份。

要删除为用于归档公用程序而创建的表,可选择对应您的数据库服务器的脚本,然后使用“TSD 建立”运行它。

如果您的 DBMS 是... 则运行此删除脚本文件...
Oracle 7.x eaaor7.drp
DB2 eaadb2.drp
MS-SQL Server eaamss.drp
Sybase 10.x eaassyb.drp
Informix eaainf.drp

请参阅 Tivoli 服务台安装指南,以获取有关使用“TSD 建立”的详细信息。

修改用于 DDM 的归档表

如果归档到某一数据库,且安装了用于 Tivoli 问题管理的 DDM,则必须确保归档表与 DDM 兼容。

如果安装完归档公用程序且创建了归档表之后安装 DDM,则可通过运行对应您的 DBMS 的 .alt 脚本文件来更改归档表,使之能用于 DDM。一定不要为此目的运行任何建立脚本(.tab 脚本)。这样做会毁坏当前出现在归档表中的所有数据。

按照下列步骤修改归档表,以用于 DDM:

  1. 按照修改用于 Tivoli 问题管理的归档表中的说明完成运行 .alt 脚本的过程。
  2. 按照分析归档公用程序文件中的说明分析归档公用程序。

编辑 eaacust.kb

下列步骤说明如何编辑 eaacust.kb:
  1. 打开您系统的文本编辑器。
  2. 从“文件”菜单,选择“打开”。
  3. 从“打开文件”对话框,选择存储 eaacust.kb 的目录。
  4. 选择“eaacust.kb”。
  5. 选择“确认”。
    结果:文件 eaacust.kb 出现在该编辑器的文本窗口。
  6. 向下滚动到对应您所定制的 Tivoli 问题管理表的过程。
  7. 在表中添加一行,以表示每一新字段。
    注:适当地使用 AddStrAddNonStr 来定义字段。
  8. 从“文件”菜单,选择“保存”。
  9. 退出文本编辑器。
  10. 在 Tivoli 归档公用程序程序组中,选择“分析归档公用程序”图符。
    结果:归档公用程序进行分析。