解决 WebSphere 和 VisualAge 产品中的帮助问题

“VisualAge 帮助系统”可以显示一些 IBM 软件产品的联机帮助信息。 当您按 F1 或从这些产品之一的用户界面选择“帮助”菜单项时,应该打开一个浏览器并显示该产品的帮助。 如果您有启动或使用产品联机帮助的问题,则本文档可以帮助您解决这些问题。

“VisualAge 帮助系统”包含三个主要组件:

大多数情况下,所有这三个组件都运行在安装有产品的机器上。

1.0 从何处着手

要开始解决问题,请遵循以下三个步骤:

  1. 阅读 1.1 使用“VisualAge 帮助系统”的产品以确定本文档是否可以帮助您
  2. 阅读摘要 1.2 特殊注意事项,然后阅读其中所有适用于您的产品或环境的小节

  3. 通过小节 1.3 什么是症状?来开始进行实际问题分析

1.1 使用“VisualAge 帮助系统”的产品

从 2001 年 2 月开始,以下 IBM 产品使用“VisualAge 帮助系统”:

如果正在使用在 2000 年 11 月之后发行的 IBM 软件产品并且该产品不在上述列表中,则可以在命令行输入以下命令来确定 该产品是否使用“VisualAge 帮助系统”:

vahcfg list /f %IMNINSTSRV% | more

然后在以 Product: 开头的行中查找您的产品名。 如果您的产品出现在列表中,则该产品使用“VisualAge 帮助系统”。 如果它没有出现在列表中,或者如果得到一条消息指出无法识别该命令,则可以与 IBM 支持部门联系以 确定您的 IBM 产品是否使用“VisualAge 帮助系统”。

1.2 特殊注意事项

如果所描述的产品、环境或问题与您的情况相符,那么您应该阅读以下小节:

1.3 什么是症状?

从产品的“帮助”菜单,选择“帮助主页”(或者您产品中的相应菜单)。 如果没有“帮助”菜单,则尝试在某一产品用户界面内按 F1。出现什么情况?

  1. 没有任何事发生 - 转至 2.0 尝试启动帮助时没有任何事发生一节
  2. 启动浏览器或将浏览器置于前台,但是:
    1. 它无法连接到 localhost:49213 - 转至 3.0 连接到 localhost:49213 服务器
    2. 无法连接到远程主机并且您正在使用远程提供的服务 - 查看远程主机上的 web 服务器是否已经启动并且正确配置。
    3. 得到没找到文件错误 - 转至 4.0 “没找到文件”错误
    4. 得到其它消息,指出在搜索期间发现有文件丢失,或者在搜索结果页面中有损坏的图像 - 转至 4.3 与丢失文件有关的其它搜索错误
    5. 得到内部服务器错误消息或应用程序错误消息对话框 - 转至 5.0 内部服务器错误消息
  3. 得到一条消息产品 xxxxx 未知于帮助系统 - 转至 6.0 重新配置帮助
  4. 得到消息,通知您使用可以处理框架的浏览器 - 请将您的缺省浏览器升级到 Netscape 4.7 或更高版,或 Internet Explorer 5 或更高版。
  5. 正确地显示了帮助。

如果正确地显示了帮助,则可能还有两个事项:

  1. 您想访问远程机器上的帮助。请参阅 12.0 配置 Windows 服务器上的帮助系统
  2. 搜索帮助不正常工作。试着在搜索输入字段输入搜索查询。出现什么情况?
    1. 没有任何事发生 - 浏览器在搜索,但是不返回响应页面,或者持续时间不长 - 转至 7.0 搜索时的超时问题
    2. 得到没找到文件错误 - 转至 4.0 “没找到文件”错误
    3. 得到内部服务器错误消息 - 转至 5.0 内部服务器错误消息
    4. 得到一条包含 rc=73搜索请求为空的消息 - 转至 8.0 无用字或 rc=73
    5. 得到一条包含 rc=32 的消息或某些其它搜索错误消息 - 转至 9.0 其它搜索错误

如果您遇到的问题不在上面所列之中,则与 IBM 支持部门联系。有关详细信息,请参阅 http://www.ibm.com/software/ad/support

2.0 尝试启动帮助时没有任何事发生

注:本节不适用于“组件代理”或“WebSphere 商业组件”。 有关“组件代理”,请参阅 doc\readme 目录有关疑难解答的信息。

如果 VisualAge for Java,版本 3.5 没有发生任何事,并且您使用桌面图标启动 VisualAge for Java IDE,则请参阅 2.1 特殊情况  - VisualAge for Java,版本 3.5

如果在试图启动帮助时没有发生任何事,则应该首先确定是否可以从命令行启动帮助。 要这样做,首先需要知道您将产品安装在哪个目录中。 在本文的以后部分,当您看到 INSTALL_DIR 时, 应该将其替换成实际安装产品的目录,例如,x:\ibmvjava 或 "x:\Program Files\IBM\VisualAge for Java"。当路径包含空格时,要将整个路径(INSTALL_DIR 和任何子目录或文件名)用引号括起。 遵循以下步骤来尝试从命令行启动帮助:

  1. 打开命令提示窗口。
  2. 更改到安装有产品的逻辑驱动器,然后转至该驱动器上的目录。 例如,如果将产品安装在 "g:\Program Files\IBM\VisualAge for Java",则输入以下命令:
    g:
    cd "\Program Files\IBM\VisualAge for Java"
  3. 更改到产品目录下可执行文件 vahelp.exe 所在的目录。可以通过首先输入以下命令来确定其位置:
    dir /s /b vahelp.exe

    如果该命令返回:

    g:\Program Files\IBM\VisualAge for Java\eab\bin\vahelp.exe

    则接下来应该输入:

    cd eab\bin
  4. 发出以下命令(如果路径包含空格,则需要加引号):

如果从命令行成功启动了帮助并且可以成功地搜索帮助,那么还可能存在设置路径方式的问题,该问题 将阻止产品的用户接口连接到帮助系统 DLL。 请参阅 2.1 特殊情况  - VisualAge for Java 3.5,或者对于其它产品,尝试先卸载、再重新安装您的产品,因为这样做有时会解决这种问题。

如果对将从命令行启动帮助作为替代工作方法或临时修正感到满意,则可以在桌面上创建一个图标来这样做。 请参阅11.0 创建图标来启动产品帮助

如果不能从命令行装入帮助,或者虽然可以装入但不可以从产品中装入,则您可能没有在 Windows 注册表中正确地设置浏览器的文件关联。 请参阅 16.0 在 Windows 注册表中设置 HTML 文件关联

如果更改文件关联也没有用,则可以尝试以下步骤来从帮助系统获得日志文件:

  1. 在文本编辑器(例如“记事本”)中编辑产品帮助配置文件 (INSTALL_DIR\HELP_DIR\CONFIG_FILE),并将以下行添加到文件末尾:
    HTMLHELP_LOG=1
  2. 保存文件。如果使用如“写字板”这样的编辑器,则注意要将文件存为纯文本。
  3. 退出,然后重新启动您的 IBM 产品。
  4. 按 F1 或使用“帮助”菜单来尝试从产品内部启动帮助。

在 TMP 环境变量所指向的目录中,应该看到一个或多个 HTML*.C2T 类型的文件。 这些文件包含详细的有关向帮助系统发出请求的日志信息。 您可以将这些文件发往 IBM 支持部门以便其进行分析。 进行支持请求可能需要付费。 还可以自己尝试检查这些文件,看看您自己是否可以确定问题的原因。

如果在 TEMP 目录没看到任何 HTML*.C2T 文件,则再次尝试从命令行调用帮助。 如果 HTML*.C2T 只能从命令行创建,则问题出现在您产品调用帮助这一环节。 如果两种调用帮助的方法都无法生成日志文件,则帮助系统本身存在问题。 在这两种情况下,您都可以与 IBM 支持部门联系。

当您完成时,要记住从产品帮助配置文件中除去 HTMLHELP_LOG=1 行,因为 该记录将在每次请求帮助时产生不必要的日志文件。

如果仍然无法用任何方法启动帮助,则查看您的产品帮助配置文件是否仍旧有效。 在编辑器中打开 INSTALL_DIR\HELP_DIR\CONFIG_FILE,然后验证:

2.1 特殊情况 - VisualAge for Java,版本 3.5

对于 VisualAge for Java,版本 3.5,如果无法从 IDE 启动帮助但可以从命令行启动,则您可能 正在使用错误快捷方式调用 IDE。 如果在桌面上或在“开始”菜单中手工创建或编辑至 IDE 的快捷方式,然后从该快捷方式调用 IDE,则可能会出现这种情况。 如果正在使用为版本 3.0 或 3.02 创建的快捷方式,现在用它来启动版本 3.5,也可能发生这种情况。 请遵循以下步骤来确定是不是该问题:

  1. 退出所有正在运行的 VisualAge for Java IDE 会话,然后等待,直到最后一个 VisualAge for Java 窗口消失后的十秒为止,以确保程序已经完成了其关闭过程。
  2. 使用“开始”菜单启动 VisualAge for Java IDE(开始 > 程序 > IBM VisualAge for Java Windows 版 V3.5 > IBM VisualAge for Java)。
  3. 在 IDE 中按 F1。

如果从“开始”菜单调用 IDE 时帮助可以工作,但是从您通常使用的图标或快捷方式却不能工作,则该图标或快捷方式可能指向 VAJ_INSTALL_DIR\ide\program\ide.exe, 它将成功启动 IDE,但是将不支持帮助,因为 PATH 环境变量不指向帮助系统 DLL。 可以通过编辑快捷方式的 Target 字段,使其指向 VAJ_INSTALL_DIR\ide\program\ivjenv.bat 来解决该问题。 该批处理文件更改您的 Windows 环境变量,以便帮助可以在 IDE 中正确工作。

3.0 连接到 localhost:49213 服务器

如果启动帮助导致浏览器打开或被置于前台,但是浏览器无法连接到 localhost:49213,则有三个可能的问题:

依次查看以下各小节,以解决任何 web 服务器或浏览器错误配置的问题。

3.1 HTTPDL.EXE 不在运行

HTTPDL.EXE 是只支持本地访问的 HTTP Server 进程。 它是 NetQuestion 组件的一部分。它用来向本地浏览器提供帮助页面。请查看进程 HTTPDL.EXE 是否出现在您的任务列表中。

如果该任务不存在,则帮助系统无法启动它。 首先尝试从命令行调用它,看看它是否返回错误消息:

  1. 更改到安装 NetQuestion 的目录(请参阅 15.0 查找 NetQuestion 安装目录

  2. 发出以下命令:
    httpdl -r httpd.cnf

如果这返回错误绑定套接字失败,则 HTTPDL.EXE 进程可能已经在端口 49213 上运行(由 HTTPDL.EXE 进程使用的 TCP/IP 端口)。 如果它返回任何其它错误,则与 IBM 支持部门联系。 如果它不带任何错误而返回,则查看任务列表以确保它正在后台运行。 HTTPDL.EXE 的 02/12/2000 版本或更早版本在没有检测到错误的情况下锁定命令提示;以后的版本则不锁定命令提示而继续运行。 如果您的版本锁定了命令提示,则按 Ctrl+Break ,然后发出以下命令以将进程作为分离的进程启动:

nqdetach httpdl.exe -r httpd.cnf

现在尝试在浏览器中重新装入页面。如果页面正确显示,则帮助系统在启动 HTTP Server 方面有问题(或者, 对于“组件代理”,没有将服务器设置成在登录时启动)。 请参阅 13.0 自动启动 NetQuestion 服务器

如果页面还不显示,则参阅 3.2 错误地配置了 HTTPDL.EXE3.3 浏览器需要代理覆盖

3.2 错误地配置了 HTTPDL.EXE

在偶然情况下,HTTPDL.EXE 所用的配置文件 httpd.cnf 会包含不正确的路径信息。 遵循以下步骤来验证其配置是否正确:

  1. 使用开始 > 查找对话框(在 Windows 2000 上是开始 >搜索)来在本地硬盘驱动器上 查找所有名为 HTTPDL.EXE 的文件。验证只有一个副本。如果有多个副本, 则重命名所有不在 NetQuestion 安装目录中的副本。(重命名这些副本允许您在以后需要它们时,例如某个其它 web 服务器需要时,恢复它们)。
  2. 编辑出现在 NetQuestion 安装目录中的文件 httpd.cnf。 查找所有包含路径信息的行。以下是通常的相关行:
    Serverroot    C:\IMNNQ_NT
    Exec    /cgi-bin/*  C:\IMNNQ_NT\*
    Pass    /icons/*    C:\IMNNQ_NT\*
    Pass    /*          C:\IMNNQ_NT\*

    验证指明的路径与存储 httpd.cnf 文件的目录相对应。如果不对应,则在以上所有出现之处更改它以反映实际路径。

  3. 还是在 httpd.cnf 中,验证以下项存在:
    Hostname localhost
    Port 49213

    如果不同的话,则用以上内容替换现有的 HostnamePort 行。

  4. 如果在第 2 步 或第 3 步中对 httpd.cnf 作了任何更改,则终止 HTTPDL.EXE 进程,然后尝试重新启动帮助。如果还不能解决问题,则参阅下一节。

3.3 浏览器需要代理覆盖

有时,您的浏览器无法连接到本地 web 服务器 HTTPDL.EXE,因为它试图通过代理服务器查找名为 localhost 的机器。通常这种情况发生在浏览器设置为手工或自动代理配置。如果使用手工代理配置, 可以修改浏览器设置以阻止浏览器试图通过代理服务器解析 localhost。如果使用自动代理配置, 则需要向自动代理配置文件的所有者要求将 127.0.0.1 作为代理例外添加在代理服务器上。

要确定浏览器是否设置手工代理配置,并且如果是这样的话需要添加代理覆盖,请执行这些步骤。 这些指令是针对指明的浏览器版本的;如果使用另一个浏览器版本,步骤可能会不同:

对于 Netscape 4.7

  1. 从 Netscape Communicator 中,选择编辑 > 首选项
  2. 通过单击左侧窗格中高级项左边的符号 +,展开这一项。
  3. 选择高级下的代理
  4. 右侧框中应该指明设置了自动或手工代理,还是直接连接到因特网。如果设置手工代理,请继续这组步骤,否则停止。
  5. 选择手工代理配置旁的查看按钮。
  6. 确保地址 localhost:49213127.0.0.1 都出现在代理例外列表中。 而且,确保它们之间用逗号而不是分号间隔。(对于 Netscape 的其它版本, 确保分隔字符是在对话框中指明的字符。例如,Netscape 4.7 对话框包含文本使用逗号 (,) 来分隔项。) 进行必需的更改,并关闭所有对话框,直到返回主浏览器窗口。

对于 Internet Explorer 5.0

  1. 在 Internet Explorer 中,选择工具 > Internet 选项
  2. 连接选项卡中,单击 LAN 设置
  3. 如果选择了使用代理服务器,请继续这组步骤,否则停止。
  4. 如果看到对本地地址不使用代理服务器复选框,则确保将其选中。
  5. 选择高级
  6. 确保 localhostlocalhost:49213127.0.0.1 这些项都出现在代理例外列表中, 并确保它们之间用分号而不是逗号间隔。进行必需的更改,并关闭所有对话框,直到返回主浏览器窗口。

如果文件 %SystemRoot%\system32\drivers\etc\hosts 存在,但是没有下面这行:

127.0.0.1     localhost

,还应该通过添加它来更新文件。如果更改这个值,可能需要退出并重新启动浏览器,使更改生效。

如果对浏览器配置或 ...\etc\hosts 文件进行了任何更改,请尝试在浏览器中重新装入帮助主页。如果在尝试与 locahost:49213 连接时仍然得到错误消息, 请与 IBM 支持联系。

如果尝试查看帮助时不能访问自动代理服务器,则浏览器可能不能将 localhost 解析为本地地址 127.0.0.1。 在上面的第 4 步 (Netscape) 或第 3 步 (Internet Explorer) 中通过更改为直接连接因特网, 可以暂时解决这一问题(但代理服务器仍不可用)。

4.0 “没找到文件”错误

如果在试图查看帮助或试图搜索时得到没找到文件错误,则 NetQuestion 安装目录中可能丢失了一个文件。有关详细信息,请阅读以下各节。

4.1 当试图查看主页或其它帮助时发生“没找到文件”错误

如果在试图查看帮助时得到没找到文件错误, 则文件 vahwebx.exe 可能不在 NetQuestion 安装目录中。在命令行或“Windows 资源管理器”中查看该目录,以验证该文件是否存在。 如果存在,则可能是 NetQuestion 本地 web 服务器配置问题, httpd.cnf 可能指向错误目录。请参阅上面的 3.2 错误配置了 HTTPDL.EXE。如果文件 vahwebx.exe 不存在,则可以尝试以下步骤中的一个或多个。

重新装入浏览器页面。如果帮助现在可以工作,则您已经解决了该问题。 如果继续得到没找到文件的错误,则与 IBM 支持部门联系。 如果得到消息没有注册产品 xxxxx 的帮助,请参阅 6.0 重新配置帮助

4.2 试图搜索时发生“没找到文件”错误

如果在试图搜索帮助时得到没找到文件错误,则在搜索表单中指定的搜索程序可能没有安装在正确的位置。 遵循以下步骤来确定名称和位置:

  1. 在您的 IBM 产品中,选择帮助 > 搜索以在浏览器窗口中打开搜索。
  2. 在浏览器中,从搜索表单查看源。可以采取以下步骤来这样做:
  3. 在表单源中,搜索字符串 "action="。应该可以看到类似于以下行之一的内容:
    <form action="http://localhost:49213/cgi-bin/ivjsenus.exe"...>
    <form action="http://localhost:49213/cgi-bin/va4sall.exe"...>

    搜索程序的名称是 "cgi-bin" 之后的 action=attribute 部分,即上例中的 ivjsenus.exe 或 va4sall.exe。

  4. 验证该文件位于 NetQuestion 安装目录中。如果它在那里并且当您搜索时继续得到没找到文件错误,则参阅上面的 3.2 错误地配置了 HTTPDL.EXE。如果它丢失,则可能可以从产品 CD 复制该文件。在产品 CD 中搜索该搜索程序。 如果在 CD 中,则将其复制到 NetQuestion 目录。否则,与 IBM 支持部门联系以获得副本。

4.3 有关丢失文件的其它搜索错误

您还可能在搜索结果页面中获得损坏的图像,或消息没找到搜索表单头没找到搜索表单脚注。 这些错误是由您的 NetQuestion 安装目录中丢失其它文件而引起的。 您可能可以在产品 CD 上找到这些文件,或者可以从 IBM 支持部门获得它们。文件名都在搜索表单中指定。 可以查看搜索表单的源文件以确定名称。查找以下隐藏输入字段的 value=parameters:

<input type="hidden" name="header" value="ivjhenus.htm">
<input type="hidden" name="footer" value="ivjfoot.htm">
<input type="hidden" name="stars1" value="ivjstar1.gif">
<input type="hidden" name="stars2" value="ivjstar2.gif">
<input type="hidden" name="stars3" value="ivjstar3.gif">
<input type="hidden" name="stars4" value="ivjstar4.gif">
<input type="hidden" name="stars5" value="ivjstar5.gif">

突出显示的项是 VisualAge for Java 项。对于 ivj,其它产品用以下对等项将其替换:

5.0 内部服务器错误消息

内部服务器错误消息通常表明在 web 上运行的应用程序崩溃。 您还可以看到标题为 program.exe - 应用程序错误的 Windows 对话框, 以及一条以"0xnnnnnnnn" 处的指令引用了 "0xnnnnnnnn" 处的内存的消息。 如果选择确定来释放这个对话框,则浏览器显示内部服务器错误消息。

如果该错误在搜索操作期间发生,则可能是您的产品索引的问题。 尝试对您的产品重新配置帮助,然后再次输入搜索查询。 如果还不能解决问题,则与 IBM 支持部门联系。

如果该错误在正常浏览帮助时发生,则可能是 NTFS 文件系统上目录许可权的问题。 注销 Windows NT 或 Windows 2000 系统,以管理员身份重新登录,然后验证 NetQuestion 安装目录和产品帮助目录 (_INSTALL_DIR\doc 或 INSTALL_DIR\help,取决于产品的不同)中的所有文件和文件夹都将安全性许可权设置成每个人 - 完全控制。 要这样做:

  1. 启动“Windows 资源管理器”,并浏览到要查看或更改的目录。
  2. 右键单击目录名。
  3. 选择属性,然后选择许可权
  4. 确保选中了两个复选框(用于替换现有文件和子目录上的许可权)。
  5. 如果有一个不存在,则通过选择添加并遵循指导信息来添加一个每个人项。
  6. 确保每个人项至少具有特殊访问 (RX) (R)权限,或者将访问级别设置成完全控制

如果更改许可权,则关闭这些对话框然后重新装入页面。 如果不需要更改许可权,或者如果在进行更改之后错误仍存在,则尝试从 NetQuestion 安装目录删除文件 vahelp.cfg,然后对您的产品重新配置帮助

如果还看到内部服务器错误消息,则与 IBM 支持部门联系。

6.0 重新配置帮助

在某些情况下,帮助系统可能对特定产品进行了错误配置,或者可能在试图修复安装时除去了某些配置信息。 您可以通过遵循以下指导信息来重新配置产品的帮助。在开始之前,需要知道:

这个过程的第一步需要确定是否已经配置了帮助,只需刷新即可。要确定是否配置了产品的帮助,在命令提示行输入以下命令:

vahcfg list /f %IMNINSTSRV% | more

应该看到已经为帮助配置的每个产品的产品和组件列表。如果看到其目录 与您的产品目录匹配的产品,记下该产品的名称。例如, 如果 vahcfg list 的输出包括以下:

产品:va400(IBM WebSphere Development Tools for AS/400 帮助系统)
可写目录:C:\Program Files\IBM\WDT400\help
本产品没有更新文件
Comp: qadtswin (WebSphere Development Tools for AS/400)
Zip 文件:C:\Program Files\IBM\WDT400\help\qadtswin.zip
索引:va45uadt
...

产品名称是 va400。如果看到您的产品项,则可以使用 vahcfg regen 命令重新配置帮助。 如果没有看到您的产品项,则需要使用 vahcfg install 命令重新配置帮助。 本节后面描述了这两种情况。

6.1 空闲磁盘空间

在运行 vahcfg regen 或 vahcfg install 之前,还应该确保文档目录所在的磁盘有足够的空闲空间来 容纳产品帮助的搜索索引。 这些索引从文档目录中的 *.zip 文件抽取,并由 vahcfg 程序写入文档目录的子目录。 一般地,磁盘上应该至少有文档目录中的 zip 文件所需的足够空闲空间。

6.2 使用 vahcfg regen

要运行 vahcfg regen,发出以下命令:

vahcfg regen /p prodname /f %IMNINSTSRV%

其中,prodname 与您运行 vahcfg list 时记录的产品名匹配。

6.3 使用 vahcfg install

要运行 vahcfg install,发出以下命令:

vahcfg install /w docdir /f %IMNINSTSRV%

其中,docdir 是包含产品帮助文件的完整目录路径。 如果该目录中包含空格(例如 c:\Program Files\IBM\...),则将整个目录用引号括起。

6.4 运行 vahcfg install 或 vahcfg regen 之后

安装后重新生成之后(可能需要几分钟),尝试重新装入帮助。如果 您试图改正的问题仍然存在,则遵循 6.5 从 vahcfg regen 或 vahcfg install 获得日志文件,与 IBM 支持部门联系,然后将日志文件转发给 IBM 支持部门。

6.5 从 vahcfg regen 或 vahcfg install 获得日志文件

如果尝试使用 vahcfg regen 或 vahcfg install 来重新生成或安装产品帮助,并且这种尝试不能解决您的帮助问题,则 尝试以下步骤来产生一个日志文件,IBM 支持部门可以使用该文件来进一步诊断您的问题:

  1. 在命令提示行,将环境变量 VAHCFG_LOG 设置成指向可写目录中的新文件。例如:
    SET VAHCFG_LOG=c:\config.log
  2. 如果尝试了 vahcfg install 并且有问题,则运行以下两个命令:
    vahcfg remove /p prodname /f %IMNINSTSRV%
    vahcfg install /w docdir
  3. 如果尝试了 vahcfg regen 并且有问题,则再次运行同一 vahcfg regen 命令。

然后,可以为 IBM 支持部门提供生成的日志文件。

请注意,某些早期的 vahcfg 版本不产生日志文件。 不支持记录的版本将把所有输出打印到屏幕。 支持记录的版本将打印一条消息指出信息已被记录。

7.0 搜索时的超时问题

除了最通用的搜索查询之外,NetQuestion 在所有匹配查找方面都十分快速。 如果搜索字符串 string a* 的匹配,则搜索系统必须查找所有至少包含一个以字母 a 开头的字的文档,因此, 这通常需要长一些的时间。 但是,如果您的搜索是特定的,则可以在最多几秒钟内得到搜索结果。 如果搜索看起来过于耗时(例如超过一分钟),则可能是使用 Windows 2000 系统上的 Netscape Navigator 4.5 或更高版本的问题。 (该问题在某些 Windows NT 系统上也会发生。)

Windows 2000 机器上的 Netscape(版本 4.5 到 4.74,可能还有其它版本)有一个已知问题,该问题 可导致联机帮助搜索极度缓慢。当从这些版本的 Netscape 中提交表单时,Netscape 应用程序会使用机器上的绝大部分可用处理器周期, 直到接收到远程系统的响应。 (可以通过在搜索期间打开 Windows“任务管理器”,切换换到“进程”选项卡然后单击 CPU 栏标题来验证这点。 如果正在发生以上所描述的问题,netscape.exe 将出现在该列表顶部并正在使用 97-99% 的 CPU 时间。)

通常,执行远程搜索(如在 Web 站点上)时这个 CPU 使用率不是问题。但是,因为产品的搜索程序正在您自己的本地机器上运行, 所以 Netscape 占用过多 CPU 时间的这一事实意味了只有很少 CPU 时间供搜索程序执行它的搜索。因此, 本可以立即返回结果的搜索操作在 Windows 2000 上可能会花几分钟的时间。

每次提交搜索后通过选择另一个非 Netscape 窗口,可以避免 Windows 2000 上的这一性能问题。 这通常会使 Netscape 在等待响应时停止使用过多的 CPU 周期, 而且搜索结果常会在执行这一窗口切换后立即显示。 同样的技巧在 Windows NT 上也适用,虽然与 Windows 2000 相比不总是有效。

或者,可以使用 Microsoft Internet Explorer 来查看帮助,因为这个浏览器没有该性能问题。

8.0 无用字或 rc=73

当在浏览器中执行帮助系统搜索时可能会接收到以下错误消息之一:

这可以在两种情况下发生:

返回码 73 通常不是由于真正的空搜索请求而返回,只有在仅包含无用字时才返回。 如果在搜索字符串明显不为空(并且不是仅无用字的搜索)的情况下确实可靠地得到指明空搜索请求的消息,则搜索表单可能毁坏。 从产品帮助目录(通常是 INSTALL_DIR\doc 或 INSTALL_DIR\help)中找到搜索表单 rms hgssrch.htm 和 hgcsrch.htm,并在与 IBM 支持部门联系时将它们提供给支持代理人。

9.0 其它搜索错误

当尝试搜索时,可能会看到任何其它错误消息。 如果您得到的错误是以下之一,则在与 IBM 支持部门联系之前尝试推荐的操作。

9.1 指定的 NetQuestion 服务器不可用。(rc=33)

原因:帮助客户机无法启动搜索服务 (或者,对于“组件代理”,没有将搜索服务配置成在登录时自动启动)。 当您在本地机器上搜索 (http://localhost:49213) 或在远程帮助服务器上搜索时都可以发生该错误。

推荐操作(本地帮助):

参阅 3.1 HTTPDL.EXE 不在运行 ,特别要留意有关导入自动启动注册表项的小节,以便搜索服务可以在登录时自动启动。 要想找到快速的替代方法,可以打开命令提示,然后输入:

imnss start server

如果该命令返回包括以下行的消息:

已经启动了搜索服务。

则您应该可以再次执行搜索而不会接收到 rc=33 错误。

推荐操作(远程提供的帮助):

服务器机器的 NetQuestion 搜索进程可能不在运行,因为机器已经重新引导并且当前没有人登录到机器。 请参阅 14.0 在重新引导期间启动 NetQuestion 搜索服务

9.2 没有指定搜索目标

原因:搜索程序没有在搜索请求中接收到任何有效的索引名。 搜索表单可能已经毁坏,或者可能没有注册指定的索引,或者 NetQuestion 安装可能有问题。

建议操作:首先,从产品帮助目录 (INSTALL_DIR\doc or INSTALL_DIR\help) 删除所有 hg*.htm 文件。 然后对您的产品重新配置帮助。 如果问题仍然存在,则可能需要重新安装 NetQuestion,然后再次重新配置产品帮助。

9.3 没找到搜索表单头 | 没找到搜索表单脚注

原因:搜索表单指定了一个不存在的搜索表单头或脚注(一个包含要放置在搜索结果上面或下面的 HTML 部分的文件)。

建议操作:有关详细信息,请参阅 4.2 搜索时“没找到文件”错误

9.4 查询太复杂。重新组织查询请求。(rc=22)

 原因:输入了包含过多字匹配的搜索查询。 搜索引擎无法处理包含匹配超过 1024 个不同字的请求。例如, 如果输入了字符串 "a* b* c* d*"(不带引号), 则您在请求包含以 a、b、c 或 d 之一开头的字的所有文档。 因为有如此之多的字与这些搜索标准匹配,所以搜索引擎无法 产生一个有意义、经过排序的搜索匹配,因此,它不进行尝试。

建议操作:输入将产生少一些字匹配的搜索请求。

9.5 指定的条件无效

原因:输入了一个逻辑上无效的搜索请求。 例如,搜索查询 "-java"(显示所有不包含字 java 的文档)被认为无效。

建议操作:输入包含至少一个不被禁止的词汇的搜索请求。

9.6 NetQuestion 配置文件 (NETQ.CFG) 有错或者没有找到。(rc=77)

原因:当搜索程序无法读取成功搜索操作所需的环境变量时可能会发生该错误。 如果您已经将帮助配置成在 web 服务器上、而不是在 NetQuestion 的 HTTPDL.EXE web 服务器上运行,则您可能需要更改 web 服务器设置, 以确保搜索 CGI(由搜索表单中 <form> 标记的 "action=" 参数调用的程序)可以看到特定的环境变量。 在某些 web 服务器上,缺省隐藏系统环境变量。CGI 需要访问的变量是 IMNINSTSRV 和 IMNINST。Netscape Enterprise Server 是缺省隐藏环境变量的 web 服务器示例。

推荐操作:将您的 web 服务器设置修改成手工将这些环境变量导出至 web 服务器 CGI 应用程序, 或者修改成使 GCI 可以看到所有本地环境变量。在 Netscape Enterprise Server 上,可以遵循以下步骤来这样做:

  1. 打开 x:\netscape_enterprise_server_directory\https-server_name\config\obj.conf, 其中,netscape_enterprise_server_directory 是安装有 NES 的目录,server_name 是安装 NES 时指定的帮助服务器名称。
  2. 您将需要知道 NetQuestion 环境变量值。在命令提示行,输入:
    set imn

    系统应该返回 IMNINST 和 IMNINSTSRV 变量的设置,例如:

    IMNINST=help
    IMNINSTSRV=C:\IMNNQ_NT
  3. 基于上面的结果,将以下行添加到 obj.conf 中 以 "Init" 指令开头的其它行下面。确保当添加 IMNINSTSRV 路径时只使用前斜杠 (/):
    Init fn="init-cgi" IMNINSTSRV=c:/imnnq_nt
    Init fn="init-cgi" IMNINST=help
  4. 停止 Netscape Enterprise Server。如果看到以下警告:

    “警告:手工编辑了配置文件。使用该按钮来装入最新的配置文件。”

    单击装入配置文件

  5. 启动 Netscape Enterprise Server
  6. 再次输入搜索。

对于其它 web 服务器,请参考 web 服务器文档来获得有关使 CGI 应用程序可以看到环境变量的信息。

9.7 其它 NETQ.CFG 错误或 rc=32

原因:当 NetQuestion 无法正确访问产品索引时会发生 rc=32 错误或提及文件 NETQ.CFG 的错误。 可能会因为 NetQuestion 安装或特定索引已经毁坏而发生该错误,或者只在重新引导之后对给定索引进行第一次搜索时发生。 请注意,虽然此错误的某些形式的消息提到文件 NETQ.CFG,但该文件实际上不存在,而该错误指的是其它 NetQuestion 索引配置文件。

推荐操作:确定发生问题的可能原因并如下所述进行改正:

9.8 索引复位或 rc=76 错误

如果搜索返回 rc=76 错误消息,则可能需要复位一个或多个搜索索引。 遵循以下步骤来复位索引:

  1. 在浏览器中查看搜索表单源文件。查找所有包含 HTML 标记 <input type=hidden name=indexname value=ixname> 的行
  2. 对于每个值 ixname,在命令行输入以下命令:
    nqreset ixname
  3. 在复位有关的索引之后尝试再次搜索。如果搜索错误仍然存在或者以后再次发生,则与 IBM 支持部门联系。

10.0 重新安装 NetQuestion

在某些情况下,使帮助正常工作的唯一方法就是卸载、再重新安装 NetQuestion,然后重新配置使用“VisualAge 帮助系统”的产品帮助。 请注意,卸载 NetQuestion 可能会除去不使用“VisualAge 帮助系统”、但由产品(如 IBM DB2)使用的搜索索引, 并可能因而在重新安装了 NetQuestion 之后阻止那些产品的帮助搜索。 您可能需要重新安装可能出问题的产品以恢复其搜索索引。

在以下的指导部分中,从命令行发出所有命令。 在开始之前,需要确定 NetQuestion 安装目录

10.1 对所有列出的产品运行 vahcfg remove

如果没有注册索引,则 NetQuestion 目录中的 NetQuestion 卸载程序 uninstnq.exe 将除去 NetQuestion。 可以首先对每个产品发出 vahcfg remove 命令来除去由使用“IBM VisualAge 帮助系统”的产品注册的所有索引。遵循以下步骤:

  1. 运行命令 vahcfg list /f %IMNINSTSRV% | more,并记录每个产品名(如 6.0 重新配置帮助所述)。
  2. 对每个产品名运行命令 vahcfg remove /p prodname /f %IMNINSTSRV%

10.2 除去所有剩余的索引

除去所有这样的产品之后,可以通过输入以下命令来查看是否仍对其它产品注册了索引:

imnixlst

如果结果列表包含以 DB2、CXX 或 VAC 开头的项,则您可能对如 DB2、IBM C 和 C++ 编译器等不使用“VisualAge 帮助系统”的产品注册了索引。 如果继续手工卸载 NetQuestion,则您将丢失那些索引并可能需要重新安装各个产品以再次搜索按那些产品的帮助。 如果仍然列出了这样的索引,并且您对失去那些产品的搜索能力已有准备或者要重新安装那些产品,则如下所示继续删除余下的索引:

如果列出了其名称以 IVJ3、VJ32、IWZ 或 VA45 开头的索引,则可以安全地删除它们,因为以后可以使用 vahcfg install 恢复它们。

如果因为 NetQuestion 错误而无法删除所有剩余索引,则可能需要手工除去 NetQuestion(请参阅下面的 11.4 一节)。

10.3 运行 uninstnq

发出命令 uninstnq 然后等待几分钟,直到看到 NetQuestion 目录几乎为空为止。该目录不应该包含任何以 imn* 或 imq* 开头的文件。您可能需要等待十分钟,这个过程才能结束。 如果十分钟之后该目录仍然包含 imn* 或 imq* 文件,则可能还有注册到搜索服务的索引(在这种情况下,返回到 11.2 一节), 或者 NetQuestion 安装可能毁坏(继续到 11.4 一节)。否则,重新引导机器并继续到 11.5 一节。

10.4 手工除去 NetQuestion

如果无法使用 uninstnq.exe 除去 NetQuestion,您可以如下所示手工除去它:

  1. 从命令行或从开始 > 运行运行 regedit 程序。
  2. 扩展注册表项 HKEY_LOCAL_MACHINE\Software\IBM。
  3. 删除 NetQuestion 项及其所有子项。
  4. 从 PATH 环境变量除去 NetQuestion 目录。
  5. 除去 IMNINSTSRV 环境变量。
  6. 当 NetQuestion 目录是当前目录时,在命令行中输入以下命令来从 NetQuestion 目录除去与这些通配规范相匹配的所有文件:
    del http*.* 302.* 404.* 500.* im*.* nq*.*
  7. 从“资源管理器”或输入以下命令删除 "instance" 子目录:
    rmdir /s /q instance
  8. 重新引导。

要更改或除去环境变量,遵循以下特定于平台的步骤:

10.5 重新安装 NetQuestion

要重新安装 NetQuestion,需要有产品 CD 或从 IBM 支持部门获得 NetQuestion 安装 zip 文件。 以下产品在其 CD 上有可安装的 NetQuestion 副本:

对于其它产品,可以通过搜索名为 ntq_sbcs.iss 的文件来确定 CD 上是否有可安装的 NetQuestion 副本。 包含该文件的目录应该包含一个 setup.exe 文件,该文件可以启动 NetQuestion 的安装。

如果从 IBM 获得安装 zip 文件,则将其解压缩到一个临时目录中。

一旦获得了 NetQuestion 的可安装副本,就遵循以下步骤:

  1. 在“资源管理器”中双击 setup.exe 或打开命令提示,更改到包含 NetQuestion 安装代码的目录,然后输入 setup 来启动 setup.exe。
  2. 选择完全安装。
  3. 重设缺省目录使其指向先前安装 NetQuestion 的目录。如果重设缺省目录并使其指向 新目录,则确保新目录名不超过 8 个字符、不包含空格,并且位于驱动器的根目录级别。这将减少以后可能出现的帮助问题。 
  4. 当安装完成时重新引导。
  5. 如果旧的和新的 NetQuestion 目录不同,则将旧目录中的搜索表单头、脚注、.gif 文件、搜索程序和帮助系统文件 (vah*.exe, vahwebx.cat) 复制到新目录中。 有关这些文件的帮助信息,请参阅 4.0“没找到文件”错误

10.6 重新配置已安装产品的帮助

对于从帮助系统手工除去的每个产品(使用 vahcfg remove,如 11.1 小节中所述),运行 vahcfg install,如 6.0 重新配置帮助所述。 现在您应该可以浏览和搜索产品帮助了。如果错误仍然存在,则查看本文档的其它部分以寻求可能的解决方案,或与 IBM 支持部门联系。

11.0 创建图标来启动产品帮助

如果无法从产品用户界面启动帮助,则可以创建一个图标以通过双击该图标来启动它(这样当您解决问题时至少可以使用帮助)。

  1. 对于“组件代理”,“开始”菜单已经包含了启动产品帮助的组件代理联机库项,本节中的信息不适用。
  2. 对于 Websphere Development Tools for AS/400,“开始”菜单已经包含了一些启动产品帮助的项(开始 - 程序文件 - IBM Websphere Development Tools for AS/400 - 文档),但是,您还可以使用以下所述的方法来创建自己的桌面图标。
  3. 对于 VisualAge TPF for Windows NT,在已经在本地安装了帮助的工作站上,“开始”菜单已经包含启动产品帮助的项。 只有在您选择远程访问帮助,或者要在桌面上添加图标并且还要在“开始”菜单中保留它的情况下,才遵循这些步骤。

可以如下创建一个快捷方式来启动产品帮助:

  1. 在任务栏上单击鼠标右键,然后选择最小化所有窗口
  2. 在桌面的空白处,单击鼠标右键然后选择新键 - 快捷方式
  3. 创建快捷方式对话框,单击浏览以确定产品安装目录位置。
  4. 在该目录或其子目录中查找文件 vahelp.exe。 在 VisualAge for Java 中,该文件位于 eab\bin 目录中。
  5. 双击 vahelp.exe 文件。在创建快捷方式对话框,命令行输入区现在应该显示 vahelp.exe 的完整路径(如果路径包含空格,则路径被括在引号中)。
  6. 编辑命令行输入区并在行的末尾添加以下内容(包括前导空格):
    instance "INSTALL_DIR\DOC_DIR\CONFIG_FILE" open index.htm

    其中,INSTALL_DIR 是安装有产品的目录,DOC_DIR 通常是 doc 或 help,CONFIG_FILE 是产品帮助配置文件的名称(VisualAge for Java 中是 ivjhlp.cfg,有关确定其它产品目录和配置文件名的信息,请参阅 2.0 试图启动帮助时没有任何事发生)。 如果路径包含空格,确保配置文件的完整路径位于引号中。

  7. 单击下一步
  8. 输入产品的名称,例如“IBM VisualAge for Java 联机帮助”。
  9. 单击完成
  10. 在桌面上双击已创建的快捷方式以确保其可以正确工作。
  11. 要更改快捷方式图标的外观,右键单击快捷方式然后选择属性,然后选择快捷方式选项卡,选择更改图标,然后浏览可用图标列表或浏览文件系统以查找新图标。

可以按以下步骤将创建的图标添加到“开始”菜单:右键单击图标,从弹出菜单选择复制,然后在“Windows 资源管理器”中 从 Windows 安装目录浏览到 ...\Profiles\All Users\Start Menu,然后将其粘贴到该目录或其适 当子目录。

12.0 在 Windows 服务器上配置帮助系统

可以在 Windows NT 或 Windows 2000 web 服务器上配置帮助系统,以便您所在组织中的其他成员可以无需在其工作站上安装帮助系统代码就可以通过网络查看和搜索联机帮助。

产品说明

  1. 对于 VisualAge COBOL 和 VisualAge TPF,用户可以选择不在本地安装 NetQuestion 或帮助系统。对于其它产品, 用户可以通过只执行 6.0 重新配置帮助10.0 重新安装 NetQuestion 小节 中的“除去步骤”来除去本地副本。
  2. 对于 VisualAge TPF,产品内置了实用程序来配置帮助以便服务器进行传递。 如果从产品 CD 上的 setup.exe 安装,系统将询问您网络上的其他用户是否将远程访问帮助。 回答。如果从 web 下载帮助包,则运行 insthelp.exe。

要进行这种网络安装,必须在服务器上安装 web 服务器软件,如 Microsoft Peer Web Services (PWS) 或 Microsoft IIS。 web 服务器应该具有脚本目录。(在 PWS 和 IIS 中,脚本目录通常位于 x:\inetpub 之下。) 安装完服务器软件之后,完成以下步骤:

  1. 在服务器上安装 IBM 软件产品。
  2. 如果以下文件位于 NetQuestion 目录,则将它们从 NetQuestion 目录复制到 x:\inetpub\scripts 目录:
    vahwebx.exe
    vahwebx.cat
    vahelp.cfg
    *foot.htm
    *head.htm
    *henus.htm

    ***************前三个文件是必需的;如果后面的文件存在,它们应该是复制的, 但是如果它们从 NetQuestion 目录丢失,则 x:\inetpub\scripts 目录应该不需要它们。

  3. 编辑 imnmap.dat 文件,它在 %IMNINSTSRV%\instance\help\data\ 目录中。 该文件包含每个索引的 Web 地址的开始部分。将子串 http://localhost:49213/cgi-bin 的所有出现部分更改为格式 http://server.city.domain.organization/scripts (如 http://cobweb.stl.ibm.com/scripts)。 这种更改会引起为搜索命中生成的链接产生一个远程(非本地主机) Web 地址, 以便用户可以从任何计算机跟随它们。
  4. 编辑下列文件,它们是在产品的帮助目录中创建的:hgssrch.htm 和 hgcsrch.htm。 将 http://localhost:49213/cgi-bin 更改为格式 http://server.city.domain.organization/scripts
  5. 将以搜索格式指定的搜索 CGI(例如,iwzihenes.exe、ivjsenus.exe 和 va4sall.exe)从 NetQuestion 目录复制到 x:\inetpub\scripts 目录。
  6. 将 *star*.gif 复制到 x:\inetpub\wwwroot 下的新图标子目录。
  7. 对于“组件代理”,将环境变量 VABHELP 的设置从 http://localhost:49213/cgi-bin 更改为格式 http://server.city.domain.organization/scripts。 对于除“组件代理”外的产品,让每个用户编辑他们的产品配置文件(其产品帮助目录中的 *.cfg)并将下列项更改为所显示的值:
    HTML_HOSTNAME=server.city.domain.organization
    CGI_BIN_DIR=scripts
    START_LITE_DAEMON=0
    START_NETQ_DAEMON=0

然后,用户只要从他们的 IBM 应用程序中按 F1 或选择“帮助”菜单项,就可访问基于服务器的帮助。或者,他们可以使用下列 URL 来访问帮助:

http://YourHostname/scripts/vahwebx.exe/help/prodname/Extract/0/index.htm

其中,prodname 是:

如果稍后在服务器系统上运行 vahcfg installvahcfg regen, 则必需再次编辑上述步骤 3 中的映射文件。

一旦用户将他们的产品帮助配置文件修改为指向服务器, 他们就可以安全地运行下列命令,以从他们的产品帮助目录删除所有*.toc、*.htm 和 *.zip 文件以及搜索索引文件。

vahcfg remove /p prodname /f %IMNINSTSRV%

或者,他们可以仅手工删除 *.toc、*.htm 和 *.zip 文件。 然而,这种方法将不删除产品帮助目录下的索引目录,所以仍需要手工删除它们。

13.0 自动启动 NetQuestion 服务器

如果您正在联网帮助配置中配置服务器,请参阅 14.0 在引导时启动 NetQuestion 搜索服务器,而不是参阅本小节。

可以通过在系统上设置两个注册表项,将 HTTP 和搜索服务器设置为登录时自动启动。 要设置这些项,请按照下列步骤:

  1. 使用文本编辑器(如“笔记本”)创建名为 NetQuestionAutoStart.reg 的文件。 输入下列文本(使用复制和粘贴):
    REGEDIT4
    
    [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Run]
    "IMNNQ"="nqdetach.exe imnss.exe start server"
    "IMNNQ NetQ Web Server"="nqdetach.exe httpdl.exe -r %IMNINSTSRV%\\httpd.cnf"
  2. 将您版本中的字符串 %IMNINSTSRV% 更改为 NetQuestion 安装目录的值。
  3. 保存文件。
  4. 从“Windows 资源管理器”双击 NetQuestionAutoStart.reg。

这会将两个项导入注册表中,以便下次登录(或在 Windows 95 或 Windows 98 上重新引导)时, 服务器应该自动启动。

14.0 在引导时启动 NetQuestion 搜索服务

如果正在使用联网帮助配置,其中帮助是从服务器交付的,而不是来自您自己的机器, 那么对远程机器执行搜索时可能会遇到问题。 当 NetQuestion 的搜索守护进程设置为自动启动(在产品安装期间,或者在执行 13.0 自动启动 NetQuestion 服务器中的步骤后)时,守护进程实际上没有启动, 直到用户登录到服务器为止。这意味着, 在系统重新引导之后到机器的用户第一次登录之前, 搜索守护进程没有运行。 然而,您可以使用 Windows 任务计划程序,使它在引导时启动。 本小节中的指示信息适用于为帮助提供服务的机器。

:如果没有使用网络帮助配置,则不必执行本小节中的步骤。

在启动之前,应该确定 NetQuestion 安装目录。 可能还要手工清除注册表。 注册表可能包含在登录时启动 NetQuestion 搜索守护进程的项。 如果打算在引导时启动守护进程,那么注册表项不是必需的。要清除注册表:

  1. 从“开始”菜单,选择运行
  2. 输入 regedit 并单击确定
  3. 按照树结构 HKEY_LOCAL_MACHINE - SOFTWARE - Microsoft - Windows - CurrentVersion - Run
  4. 在 Run 文件夹的右窗格中,选中并删除下列键:
  5. 如果您不打算直接访问服务器上的帮助,还可以除去 NetQuestion HTTP Server 自动启动项。要完成这一操作,可选中并删除下列键:
  6. 关闭注册信息编辑器。

现在,可以告诉 Windows 在引导时启动服务器。首先, 检查 Microsoft 的“Windows 任务计划程序”是否安装在作为帮助服务器的机器上:

  1. 打开“Windows 资源管理器”或“NT 资源管理器”。
  2. 检查“我的电脑”文件夹的子文件夹。与本地和网络驱动器在一起,您会看到标题为“计划任务”的文件夹,表示“任务计划程序”已安装在您的机器上。跳过步骤 5。
  3. 如果您的机器上没有安装“任务计划程序”,则必需安装它。 “任务计划程序”与 Internet Explorer 捆绑在一起。 可在类别“附加资源管理器增强”中找到它,它是需要安装的附加组件。 将组件添加到 Internet Explorer 的方法取决于 Internet Explorer 的版本和正在使用的 Windows 版本。有关详细信息,请参阅 http://support.microsoft.com/support/kb/articles/Q171/2/29.ASP 处的“如何添加和除去 Internet Explorer 组件”。
  4. 一旦安装了“任务计划程序”,如果提示,请重新引导,打开“我的电脑”。

要在帮助服务器上将“NetQuestion 搜索服务器”设置成引导时启动:

  1. 在“计划任务”文件夹中,单击添加计划任务
  2. “添加计划任务”向导打开。单击下一步以继续。
  3. 从列表中任意选择一个程序(稍后,您将更改它)并单击下一步
  4. 命名任务。例如,输入“NetQuestion 搜索服务器”。
  5. 选中当我的电脑启动时单选按钮并单击下一步
  6. 输入将拥有进程(例如,服务器管理器)的用户名,当请求时,输入他们的密码。单击下一步
  7. 选中当我单击“完成”时打开此任务的高级特性复选框。
  8. 单击完成
  9. “NetQuestion 搜索服务器特性”页面打开。在“任务”选项卡下, 将运行字段更改为 NQ_DIR\imnss.exe start server
    其中,NQ_DIR 是 NetQuestion 安装目录。
  10. 开始字段中,输入 NetQuestion 安装目录。
  11. 确保启用复选框是选中的。
  12. 设置选项选项卡下,取消选择如果任务运行了 xxx 小时 xxx 分钟,则停止它

:在帮助服务器重新引导之后,从登录屏幕出现之后到 Windows 启动搜索服务器之前要花一分钟时间或更长时间。

15.0 查找 NetQuestion 安装目录

可以通过打开命令提示并输入下列命令来确定 NetQuestion 安装目录的位置:

set IMNINSTSRV

返回的目录是 NetQuestion 安装目录。如果未设置变量, 可以通过查看 Windows 注册表来确定安装目录。在命令提示处输入 regedit, 并且将注册表项扩展到键 HKEY_LOCAL_MACHINE\SOFTWARE\IBM\NetQuestion\CurrentVersion\Installation Directory。该键的 "Directory" 项应该指向 NetQuestion 安装目录。

在 Windows 95 和 Windows 98 上,如果未设置 IMNINSTSRV 环境变量但是可以从注册表找到该目录, 则可能需要编辑 autoexec.bat 文件。(如果在 Windows Millennium Edition 上遇到这种情况, 请参阅 17.0 Windows Millennium Edition 的特殊注意事项。)NetQuestion 安装 进程应该已经修改了 autoexec.bat 以添加调用存储在 NetQuestion 目录中批处理 文件 imnenv.bat 的命令。已添加的命令如下:

如果存在 _NETQ_DIR_\imnenv.bat call _NETQ_DIR_\imnenv.bat

如果该行丢失,或 _NETQ_DIR_ 指向错误的目录,则添加带有正确的 NetQuestion 目录的行。 还应该验证正在调用的批处理文件 imnenv.bat batch 是否实际存在于 autoexec.bat 中并包含指向当前 目录而不是某个别的 NetQuestion 目录的项。imnenv.bat 的内容应该是:

@echo off
set IMNINSTSRV=_NETQ_DIR_
set IMNINST=help
set PATH=PATH;%IMNINSTSRV%

16.0 在 Windows 注册表中设置 HTML 文件关联

如果无法从浏览器或从命令行启动帮助,可能因为未设置 HTML 文件的正确文件关联。“帮助系统”客 户机代码根据这些文件关联使用注册表项来确定缺省的系统浏览器。可使用注册表编辑器检查文件关联。

  1. 在“开始”菜单选择运行
  2. 在“运行”对话框中输入 regedit
  3. 在注册表编辑器中展开 HKEY_CLASSES_ROOT
  4. 应该看到 .htm 项。该项的缺省值应该为 "NetscapeMarkup"(如果 Netscape 是缺省浏览器)或 者为 "htmlfile"(如果 Internet Explorer 是缺省浏览器)。

如果看不到该项,可以按如下操作添加项:

  1. 启动希望注册为缺省系统浏览器的浏览器。
  2. 如果浏览器显示对话框,询问是否想将它作为缺省浏览器,则回答是。否则,可以 将浏览器设置为下一次启动时询问:

    对于 Netscape Communicator:

    1. 退出任何 Netscape 窗口。
    2. 查找用户首选项文件 prefs.js。典型情况下, 它在 Netscape 产品安装目录下的目录中。典型路径是 Netscape_Installation_Directory\users\username\prefs.js, 其中 username 是“缺省值”或者是用来登录 Windows 的名称。
    3. 使用纯文本编辑器来编辑该文件并除去行:
      user_pref("browser.wfe.ignore_def_check", true);
    4. 保存文件(如果使用 WordPad,请确保另存为纯文本)。
    5. 再次启动 Netscape 并将 Netscape 注册成缺省浏览器。

    对于 Internet Explorer:

    1. 找到选项Internet 选项菜单项。 根据正在使用的 Explorer 版本,可以从“工具”、“文件”或“视图”菜单中访问浏览器选项。
    2. 选择对话框的程序选项卡。
    3. 选中复选框 Internet Explorer 应该检查它是不是缺省浏览器
    4. 退出 Internet Explorer。
    5. 再次启动 Internet Explorer 并将 Internet Explorer 注册成缺省浏览器。

17.0 Windows Millennium Edition 的特殊注意事项

如果正在使用 Windows Millennium Edition,即使在重新引导后, 您对 autoexec.bat 所作的更改以装入 NetQuestion 环境变量也可能不起作用;这些更改可能在重新引导后消失。这可能导致 NetQuestion 环境保持未定义状态,将依次产生下列各种故障:

可以通过检查在重新引导之后环境变量是否被正确设置来确定这是不是帮助问题的原因。如果 它们仍然没有被设置,可以使用 Windows 系统目录中找到的 msconfig.exe 程序来完成下列环境更改:

18.0 “组件代理”的特殊注意事项

“组件代理”不使用 VisualAge“帮助系统”的客户机部分, 从用户界面的 F1 或“帮助”菜单操作启动帮助的部分。这有两个重要含义:

“组件代理”在 doc\readme 目录中提供了关于帮助疑难解答的附加信息。

19.0 DBCS 系统的特殊注意事项

在安装了部分或全部用“简体中文”(语言环境 zh_CN)、繁体中文 (zh_TW)、 韩国语 (ko_KR) 或日语 (ja_JP) 编写的帮助的系统上,需要对 vahcfg 和 NetQuestion 命令作如下更改:

因为 NetQuestion 将不同的可执行文件和服务器用于其单字节和双字节搜索系统,所以需要这些更改。