简介

DB2 for i 的 OmniFind Text Search Server (5733-OMF) 是一款无附加许可证费用的产品，最初发布于于 IBM i 6.1。这款产品允许用户使用 SQL 内置函数 CONTAINS 和 SCORE 对 DB2 文本列执行全文搜索。举例来说，如果搜索 "the cat chased a mouse"，可能还会找到包含 "the cats were chasing some mice" 这一短语的文档。在 IBM i 7.1 中，该产品增加了搜索 DB2 列以外的系统对象的功能，例如 spool 文件或 IFS 流文件。最新一轮的改进增加了一些全新的存储过程，用来检查文本搜索索引和文本服务器的健康状况。本文将介绍这些有关健康检查器的增强。您可通过本文参考资料部分中提供的白皮书，了解有关 OmniFind Text Search Server 的一般背景信息。

DB2 for i 的 OmniFind Text Search Server 健康状况检查器提供了一组存储过程，用于诊断与文本搜索服务器或索引相关的配置问题。这些健康状况检查器存储过程将检查文本搜索服务器或索引是否可以正常工作，并返回一个报告，这个报告包含检测到的的所有问题。

IBM OmniFind Text Search Server 产品本身提供了最常用的系统管理用存储过程，因此用户可以非常轻松地创建和维护索引。例如，可以调用 SYSPROC.SYSTS_CREATE() 过程来创建索引，使用 SYSPROC.SYSTS_UPDATE() 过程来更新索引。然而，在某些情况下，这些管理存储过程调用可能会失败，错误原因可能如下：

• 权限不足，无法创建索引
• 未安装 Java J2SE，无法启动文本服务器
• 自动更新调度程序未启动，文本搜索索引中未包含最新数据更改
• 文本搜索服务器错误关闭，索引搜索未能成功完成

在这些情况下，健康状况检查器过程可用于诊断 OmniFind 安装问题。存储过程 SYSPROC.SYSTS_HC_USR_AUTH() 可用于检查用户是否具备创建索引所需的必要权限。SYSPROC.SYSTS_HC_GENERAL() 过程可用于验证是否已经安装了所有必备软件。SYSPROC.SYSTS_HC_IDX() 过程可用于确定索引配置是否存在问题，SYSPROC.SYSTS_HC_SVR() 过程可用于分析文本搜索服务器是否正常工作。所有这些健康状况检查器过程都会通过返回存储过程结果集的形式提供警告和错误报告。用户可以利用此类结果集的内容来识别并修复问题，或者向 IBM 支持人员提供具体信息，以便进一步进行诊断。

回页首

服务发布

这项全新的 OmniFind 健康状况检查器支持是由 IBM i 7.1 的 PTF SI44462 提供的。健康状况检查器需要 IBM Application Runtime Expert (ARE) for i 的支持，ARE 是 IBM i 7.1 中的 IBM i OS (5770-SS1) 的一部分。请访问 IBM ARE 支持网站，了解有关安装 ARE 产品时的必备软件和补丁的信息。

回页首

检查用户权限

DB2 存储过程 SYSPROC.SYSTS_HC_USR_AUTH() 用于报告调用该过程的用户的权限问题。此存储过程将返回一个结果集。

如果省略参数 INFO_TYPE，那么 SYSPROC.SYSTS_HC_AUTH() 会返回警告和错误消息（如果有的话）。

该存储过程检查以下常见问题：

• 用户对系统管理存储过程的 *EXECUTE 权限
• 用户对 administrative catalog 的权限
• 用户的作业控制特殊权限（用于启动服务器）
• 其他所需权限

语法

 >>SYSTS_HC_USER_AUTH(------------)----------------->< 
 
 -----INFO_TYPE---

此存储过程在 SYSPROC 中。

参数

INFO_TYPE

返回结果

存储过程将返回一个结果集。该结果集包含以下各列：

• TYPE – CHAR(1)，消息的类型，即 'I'、'W' 或 'E'。消息类型的含义：
  • 'I' – 信息消息，不属于警告或错误
  • 'W' – 警告消息，不加以修复可能会导致问题
  • 'E' – 错误消息，表示发现了错误。为了保证 OmniFind 能正常工作，就必须修复错误
• CODE – INTEGER，消息的 Info、Warning 或 Error 代码。代码范围为：
  • 100-299：信息消息
  • 300-499：警告消息
  • 500-999：错误消息

• ITEM – VARCHAR(128)，所检查的特定项，比如 SYSPROC.SYSTS_START() 或 QSYS2.SYSTEXTSERVERS。
• MESSAGE – VARCHAR(512)，具体的信息、警告或错误消息。

示例

对用户进行权限检查，返回全部结果：

 CALL SYSPROC.SYSTS_HC_USR_AUTH('A')

示例输出如下：

返回适合发出调用的用户的权限的警告和错误检查结果：

 CALL SYSPROC.SYSTS_HC_USR_AUTH()

回页首

检查总体配置

DB2 存储过程 SYSPROC.SYSTS_HC_GENERAL() 用于检查 OmniFind Text Search Server 的总体健康状况。它检查 OmniFind 的配置情况。

存储过程成功完成后，返回一个结果集。该结果集报告可能需要系统管理员处理的产品安装或配置上的问题。

该存储过程检查以下各项：

• 所需要点 LPP（ICU、Java、QSH 等）的安装情况
• 系统中以安装的 PTF
• OmniFind 系统管理存储过程
• OmniFind 独立辅助存储池 (iASP) 的 varyon 和 varyoff 程序的配置情况
• 系统管理 catalog
• • QSYS2.SYSTEXTDEFAULTS 表中的 OmniFind 默认值

语法

 >>SYSTS_HC_GENERAL(-------------- )--------------------->< 
		   ---INFO_TYPE----- 
		   ---INFO_TYPE, AUTO_FIX-----

此存储过程在 SYSPROC SYSPROC 中。

参数

INFO_TYPE

指定要返回的信息类型，参见 SYSTS_HC_AUTH() 中的 INFO_TYPE。

AUTO_FIX

类型为 SMALLINT，仅供留作将来使用。目前，此值必须设置为 0。服务器不会自动修复发现的问题。

如果参数列表为空，则返回所有警告和错误消息。

返回结果

存储过程将返回一个结果集。该结果集包含以下各列：

• TYPE – CHAR(1)，消息的类型，参见SYSTS_HC_AUTH() 中的 TYEP。
• CODE – INTEGER，消息的 Info、Warning 或 Error 代码，，参见 SYSTS_HC_AUTH() 中的 CODE。
• ITEM – VARCHAR(128)，所检查的特定项。例如：SYSPROC.SYSTS_START() 或 QSYS2.SYSTEXTSERVERS。
• MESSAGE – VARCHAR(512)，具体的信息、警告或错误消息。

示例

执行总体健康状况检查并返回所有消息：

 CALL SYSPROC.SYSTS_HC_GENERAL('A', 0)

示例输出如下：

返回全部警告和错误消息：

 CALL SYSPROC.SYSTS_HC_GENERAL()

回页首

检查索引

DB2 存储过程 SYSPROC.SYSTS_HC_IDX() 用于根据给定的参数在当前独立辅助存储池 (iASP) 组中，检查单个或是全部索引根据给定的不同参数确定的。如果给出了限定索引名，则健康状况检查报告仅针对特定索引；否则将检查 IASP 组中的全部文本索引。存储过程成功完成后将返回一个结果集。存储过程 SYSPROC.SYSTS_HC_IDX_SN() 执行相同的功能，但接受 schema 名和索引名作为参数。

此过程检查的各项的列表如下：

• 索引的 base table 是否存在
• Catalog SYSTEXTINDEXES、SYSTEXTCOLUMNS 和 SYSTEXTCONFIGURATION 分类中的索引、列和配置项是否正确无误
• SYSTEXTSERVERHISTORY 中的记录是否有效
• 如果索引是建立在在本地服务器中的，检查索引的 collection 目录是否存在
• 索引的视图是否存在
• 本索引的服务器是否处于活动状态
• 更新调度程序是否配置正确
• 索引的 base table 中是否存在插入、更新和删除触发器
• 索引的 staging table 是否存在
• 触发器、staging table、索引视图的所有者是否一致
• 索引所有者在 base table 和 administrative cataglog 上的权限是否正确
• 索引所有者是否有修改自动更新所需的作业调度器条目的权限
• 索引所有者是否具有 *JOBCTL 特殊权限。

语法

 >>-SYSTS_HC_IDX(-------------- )------------------------>< 
		 ---INDEXSCHEMA, INDEXNAME, INFO_TYPE, AUTO_FIX 
		 ---INDEXSCHEMA, INDEXNAME, INFO_TYPE 
		 ---INFO_TYPE, AUTO_FIX 
		 ---INFO_TYPE 
 >>SYSTS_HC_IDX_SN(INDEXSCHEMA,INDEXNAME)---------------><

此存储过程在 SYSPROC 中。

参数

INFO_TYPE

指定要返回的信息类型。参见 SYSTS_HC_AUTH() 中的INFO_TYPE。

AUTO_FIX

仅供留作将来使用。参见 SYSTS_HC_GENERAL() 中的 AUTOFIX。

INDEXSCHEMA

指定要检查的索引的 schema。参数类型为 VARCHAR(128)，CCSID 为 1208。输入值必须是有效的 SQL 名称。INDEXSCHEMA 参数是区分大小写的，不能自动转为大写字母。

INDEXNAME

指定要检查的索引名。参数类型为 VARCHAR(128), CCSID 为 1208。输入值必须是有效的 SQL 名称。索引名是区分大小写的，不能自动转为大写字母。

如果参数列表为空，则对所有现有索引执行健康状况检查，但不会执行自动修复；执行结束返回警告和错误消息。

返回结果

存储过程将返回一个结果集。该结果集包含以下各列：

• ID – INTEGER，索引 ID。
• TYPE – CHAR(1)，消息的类型，参见SYSTS_HC_AUTH() 中的TYPE。
• CODE – INTEGER，信息 Info、Warning 或 Error 代码，，参见 SYSTS_HC_AUTH() 中的 CODE。
• ITEM – VARCHAR(128)，所检查的特定项，例如 staging table、索引视图。
• MESSAGE – VARCHAR(512)，具体的信息、警告或错误消息。

示例

检查索引 TESTSCHEMA.TESTINDEX，返回所有消息，不做任何自动修复：

 CALL SYSPROC.SYSTS_HC_IDX('TESTSCHEMA', 'TESTINDEX', 'A', 0)

示例输出如下：

检查索引 TESTSCHEMA.TESTINDEX，并且仅返回错误消息：

 CALL SYSPROC.SYSTS_HC_IDX('TESTSCHEMA', 'TESTINDEX', 'E')

检查全部索引并返回警告和错误消息：

 CALL SYSPROC.SYSTS_HC_IDX()

回页首

检查服务器

DB2 存储过程 SYSTS_HC_SVR() 用于检查一个或全部本地文本服务器的健康状况。如果指定了一个服务器 ID，那么这个存储过程将仅检查该文本服务器，否则就检查在当前独立辅助存储池 (IASP) 配置的所有服务器。存储过程将返回一个结果集。过程 SYSPROC.SYSTS_HC_SVR_T() 和 SYSPROC.SYSTS_HC_SVR_IT() 执行相同的功能，但输入参数不同，分别用于指定被检查的服务器和返回的信息类型。

该存储过程会检查文本服务器的以下各项：

• 鉴权代码是否有效
• IP 地址是否有效
• 服务器路径是否有效
• 服务器端口是否有效

对于每一个活动的本地服务器，会执行一些额外的检查来确定它所需的服务器作业是否在运行，服务器端口端口是否可以连接。

语法

 >>SYSTS_HC_SVR(---------------)----------------------->< 
		 ----SERVERID, INFO_TYPE, AUTO_FIX ---- 
		 ----SERVERID---- 
		 ----INFO_TYPE, AUTO_FIX---- 
 >>SYSTS_HC_SVR_IT(SERVERID,INFO_TYPE)-------------------->< 
 >>SYSTS_HC_SVR_T(INFO_TYPE)----------------------------><

此存储过程在 SYSPROC 中。

参数

SERVERID

指定要检查的文本服务器标识符。特定服务器的服务器标识符可使用 IBM Systems Director Navigator for i 获得。利用 Director Navigator 即可获得服务器信息和状态，参见 InfoCenter。

也可使用以下 SQL 查询从系统 catalog 中获取这些信息：

 SELECT SERVERID, SERVERNAME, SERVERPATH, ALIASNAME FROM QSYS2.SYSTEXTSERVERS;

指定要返回的信息类型，参见 SYSTS_HC_AUTH() 中的 INFO_TYPE。

AUTO_FIX

仅供留作将来使用，参见 SYSTS_HC_GENERAL() 中的 AUTO_FIX。

返回结果

存储过程成功完成后将返回一个结果集。该结果集包含以下各列：

• ID – INTEGER，服务器 ID。
• TYPE – CHAR(1)，消息的类型，参见 SYSTS_HC_AUTH() 中的 TYPE。
• CODE – INTEGER，消息的信息、警告或错误代码，参见 SYSTS_HC_AUTH() 中的 CODE。
• ITEM – VARCHAR(128)，所检查的特定项，通常在服务器检查中不会使用，因为 MESSAGE 提供了非常明确的信息。
• MESSAGE – VARCHAR(512)，具体的信息、警告或错误消息。

示例

检查 id 为 50 的服务器并返回所有消息：

CALL SYSPROC.SYSTS_HC_SRV(50, 'A', 0)

示例输出如下：

ID	TYPE	CODE	ITEM	MESSAGE
50	I	117	-	Server path is valid.
50	I	116	-	Server token is valid.
50	I	118	-	Server name is valid.
50	I	119	-	Server port is valid.
50	I	114	-	Server jobs are ok.
50	I	115	-	Stellent jobs are ok.
50	I	120	-	Server is connectable.

检查 id 为 50 的服务器并返回警告和错误消息。

CALL SYSPROC.SYSTS_HC_SRV(50)

---

回页首

结束语

OmniFind 健康状况检查器提供了一组 DB2 存储过程，用户可以调用这些存储过程来检查总体配置、文本服务器和索引。如果 OmniFind Text Search Server for i 存在任何问题，这些存储过程可用于返回警告和 / 或错误消息，随后可以利用这些信息来迅速了解问题的起因，并采取修复措施。

---

回页首

参考资料

• DB2 for i 的 OmniFind Text Search Server
• OmniFind 白皮书
• OmniFind for IBM i
• DB2 for i 论坛
• IBM developerWorks 中国 IBM i 专区：为 IBM i 的开发人员准备的技术信息和资料。这里提供产品下载、how-to 信息、支持资源以及免费技术库，包含 2000 多份技术文章、教程、最佳实践、IBM Redbook 和在线产品手册。
• 加入 developerWorks 中文社区，developerWorks 社区是一个面向全球 IT 专业人员，可以提供博客、书签、wiki、群组、联系、共享和协作等社区功能的专业社交网络社区。
• 加入 IBM i 中国开发团队 Blog，参与在线交流。

作者简介

You Liang Wu 于 2010 年加入 IBM。他目前从事 DB2 for i 的 OmniFind Text Search Server 的开发工作。

Nick Lawrence 在 DB2 for i 方面拥有 12 年的工作经验。他的工作职责主要包括针对 DB2 和 SQL/XML 的全文搜索。

关闭 [x]

关于报告滥用的帮助

报告滥用

谢谢! 此内容已经标识给管理员注意。

---

关闭 [x]

关于报告滥用的帮助

报告滥用

报告滥用提交失败。 请稍后重试。

---

关闭 [x]

developerWorks：登录

IBM ID：
需要一个 IBM ID？
忘记 IBM ID？

密码：
忘记密码？
更改您的密码

保持登录。

单击提交则表示您同意developerWorks 的条款和条件。 使用条款

 

---

当您初次登录到 developerWorks 时，将会为您创建一份概要信息。您在 developerWorks 概要信息中选择公开的信息将公开显示给其他人，但您可以随时修改这些信息的显示状态。您的姓名（除非选择隐藏）和昵称将和您在 developerWorks 发布的内容一同显示。

所有提交的信息确保安全。

关闭 [x]

请选择您的昵称：

当您初次登录到 developerWorks 时，将会为您创建一份概要信息，您需要指定一个昵称。您的昵称将和您在 developerWorks 发布的内容显示在一起。

昵称长度在 3 至 31 个字符之间。 您的昵称在 developerWorks 社区中必须是唯一的，并且出于隐私保护的原因，不能是您的电子邮件地址。

昵称：（长度在 3 至 31 个字符之间）

---

单击提交则表示您同意developerWorks 的条款和条件。 使用条款.

 

---

所有提交的信息确保安全。

为本文评分

评论

回页首