“VisualAge 帮助系统”可以显示一些 IBM 软件产品的联机帮助信息。 当您按 F1 或从这些产品之一的用户界面选择“帮助”菜单项时,应该打开一个浏览器并显示该产品的帮助。 如果您有启动或使用产品联机帮助的问题,则本文档可以帮助您解决这些问题。
“VisualAge 帮助系统”包含三个主要组件:
大多数情况下,所有这三个组件都运行在安装有产品的机器上。
要开始解决问题,请遵循以下三个步骤:
阅读摘要 1.2 特殊注意事项,然后阅读其中所有适用于您的产品或环境的小节
从 2001 年 2 月开始,以下 IBM 产品使用“VisualAge 帮助系统”:
如果正在使用在 2000 年 11 月之后发行的 IBM 软件产品并且该产品不在上述列表中,则可以在命令行输入以下命令来确定 该产品是否使用“VisualAge 帮助系统”:
vahcfg list /f %IMNINSTSRV% | more
然后在以 Product: 开头的行中查找您的产品名。 如果您的产品出现在列表中,则该产品使用“VisualAge 帮助系统”。 如果它没有出现在列表中,或者如果得到一条消息指出无法识别该命令,则可以与 IBM 支持部门联系以 确定您的 IBM 产品是否使用“VisualAge 帮助系统”。
如果所描述的产品、环境或问题与您的情况相符,那么您应该阅读以下小节:
从产品的“帮助”菜单,选择“帮助主页”(或者您产品中的相应菜单)。 如果没有“帮助”菜单,则尝试在某一产品用户界面内按 F1。出现什么情况?
如果正确地显示了帮助,则可能还有两个事项:
如果您遇到的问题不在上面所列之中,则与 IBM 支持部门联系。有关详细信息,请参阅 http://www.ibm.com/software/ad/support。
注:本节不适用于“组件代理”或“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 和任何子目录或文件名)用引号括起。 遵循以下步骤来尝试从命令行启动帮助:
g: cd "\Program Files\IBM\VisualAge for Java"
dir /s /b vahelp.exe
如果该命令返回:
g:\Program Files\IBM\VisualAge for Java\eab\bin\vahelp.exe
则接下来应该输入:
cd eab\bin
如果从命令行成功启动了帮助并且可以成功地搜索帮助,那么还可能存在设置路径方式的问题,该问题 将阻止产品的用户接口连接到帮助系统 DLL。 请参阅 2.1 特殊情况 - VisualAge for Java 3.5,或者对于其它产品,尝试先卸载、再重新安装您的产品,因为这样做有时会解决这种问题。
如果对将从命令行启动帮助作为替代工作方法或临时修正感到满意,则可以在桌面上创建一个图标来这样做。 请参阅11.0 创建图标来启动产品帮助。
如果不能从命令行装入帮助,或者虽然可以装入但不可以从产品中装入,则您可能没有在 Windows 注册表中正确地设置浏览器的文件关联。 请参阅 16.0 在 Windows 注册表中设置 HTML 文件关联。
如果更改文件关联也没有用,则可以尝试以下步骤来从帮助系统获得日志文件:
在 TMP 环境变量所指向的目录中,应该看到一个或多个 HTML*.C2T 类型的文件。 这些文件包含详细的有关向帮助系统发出请求的日志信息。 您可以将这些文件发往 IBM 支持部门以便其进行分析。 进行支持请求可能需要付费。 还可以自己尝试检查这些文件,看看您自己是否可以确定问题的原因。
如果在 TEMP 目录没看到任何 HTML*.C2T 文件,则再次尝试从命令行调用帮助。 如果 HTML*.C2T 只能从命令行创建,则问题出现在您产品调用帮助这一环节。 如果两种调用帮助的方法都无法生成日志文件,则帮助系统本身存在问题。 在这两种情况下,您都可以与 IBM 支持部门联系。
当您完成时,要记住从产品帮助配置文件中除去 HTMLHELP_LOG=1 行,因为 该记录将在每次请求帮助时产生不必要的日志文件。
如果仍然无法用任何方法启动帮助,则查看您的产品帮助配置文件是否仍旧有效。 在编辑器中打开 INSTALL_DIR\HELP_DIR\CONFIG_FILE,然后验证:
对于 VisualAge for Java,版本 3.5,如果无法从 IDE 启动帮助但可以从命令行启动,则您可能 正在使用错误快捷方式调用 IDE。 如果在桌面上或在“开始”菜单中手工创建或编辑至 IDE 的快捷方式,然后从该快捷方式调用 IDE,则可能会出现这种情况。 如果正在使用为版本 3.0 或 3.02 创建的快捷方式,现在用它来启动版本 3.5,也可能发生这种情况。 请遵循以下步骤来确定是不是该问题:
如果从“开始”菜单调用 IDE 时帮助可以工作,但是从您通常使用的图标或快捷方式却不能工作,则该图标或快捷方式可能指向 VAJ_INSTALL_DIR\ide\program\ide.exe, 它将成功启动 IDE,但是将不支持帮助,因为 PATH 环境变量不指向帮助系统 DLL。 可以通过编辑快捷方式的 Target 字段,使其指向 VAJ_INSTALL_DIR\ide\program\ivjenv.bat 来解决该问题。 该批处理文件更改您的 Windows 环境变量,以便帮助可以在 IDE 中正确工作。
如果启动帮助导致浏览器打开或被置于前台,但是浏览器无法连接到 localhost:49213,则有三个可能的问题:
依次查看以下各小节,以解决任何 web 服务器或浏览器错误配置的问题。
HTTPDL.EXE 是只支持本地访问的 HTTP Server 进程。 它是 NetQuestion 组件的一部分。它用来向本地浏览器提供帮助页面。请查看进程 HTTPDL.EXE 是否出现在您的任务列表中。
如果该任务不存在,则帮助系统无法启动它。 首先尝试从命令行调用它,看看它是否返回错误消息:
更改到安装 NetQuestion 的目录(请参阅 15.0 查找 NetQuestion 安装目录)
如果这返回错误绑定套接字失败,则 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.EXE 和 3.3 浏览器需要代理覆盖。
在偶然情况下,HTTPDL.EXE 所用的配置文件 httpd.cnf 会包含不正确的路径信息。 遵循以下步骤来验证其配置是否正确:
Serverroot C:\IMNNQ_NT Exec /cgi-bin/* C:\IMNNQ_NT\* Pass /icons/* C:\IMNNQ_NT\* Pass /* C:\IMNNQ_NT\*
验证指明的路径与存储 httpd.cnf 文件的目录相对应。如果不对应,则在以上所有出现之处更改它以反映实际路径。
Hostname localhost Port 49213
如果不同的话,则用以上内容替换现有的 Hostname 或 Port 行。
有时,您的浏览器无法连接到本地 web 服务器 HTTPDL.EXE,因为它试图通过代理服务器查找名为 localhost 的机器。通常这种情况发生在浏览器设置为手工或自动代理配置。如果使用手工代理配置, 可以修改浏览器设置以阻止浏览器试图通过代理服务器解析 localhost。如果使用自动代理配置, 则需要向自动代理配置文件的所有者要求将 127.0.0.1 作为代理例外添加在代理服务器上。
要确定浏览器是否设置手工代理配置,并且如果是这样的话需要添加代理覆盖,请执行这些步骤。 这些指令是针对指明的浏览器版本的;如果使用另一个浏览器版本,步骤可能会不同:
对于 Netscape 4.7:
对于 Internet Explorer 5.0:
如果文件 %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) 中通过更改为直接连接因特网, 可以暂时解决这一问题(但代理服务器仍不可用)。
如果在试图查看帮助或试图搜索时得到没找到文件错误,则 NetQuestion 安装目录中可能丢失了一个文件。有关详细信息,请阅读以下各节。
如果在试图查看帮助时得到没找到文件错误, 则文件 vahwebx.exe 可能不在 NetQuestion 安装目录中。在命令行或“Windows 资源管理器”中查看该目录,以验证该文件是否存在。 如果存在,则可能是 NetQuestion 本地 web 服务器配置问题, httpd.cnf 可能指向错误目录。请参阅上面的 3.2 错误配置了 HTTPDL.EXE。如果文件 vahwebx.exe 不存在,则可以尝试以下步骤中的一个或多个。
重新装入浏览器页面。如果帮助现在可以工作,则您已经解决了该问题。 如果继续得到没找到文件的错误,则与 IBM 支持部门联系。 如果得到消息没有注册产品 xxxxx 的帮助,请参阅 6.0 重新配置帮助。
如果在试图搜索帮助时得到没找到文件错误,则在搜索表单中指定的搜索程序可能没有安装在正确的位置。 遵循以下步骤来确定名称和位置:
<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。
您还可能在搜索结果页面中获得损坏的图像,或消息没找到搜索表单头或没找到搜索表单脚注。 这些错误是由您的 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,其它产品用以下对等项将其替换:
内部服务器错误消息通常表明在 web 上运行的应用程序崩溃。 您还可以看到标题为 program.exe - 应用程序错误的 Windows 对话框, 以及一条以"0xnnnnnnnn" 处的指令引用了 "0xnnnnnnnn" 处的内存的消息。 如果选择确定来释放这个对话框,则浏览器显示内部服务器错误消息。
如果该错误在搜索操作期间发生,则可能是您的产品索引的问题。 尝试对您的产品重新配置帮助,然后再次输入搜索查询。 如果还不能解决问题,则与 IBM 支持部门联系。
如果该错误在正常浏览帮助时发生,则可能是 NTFS 文件系统上目录许可权的问题。 注销 Windows NT 或 Windows 2000 系统,以管理员身份重新登录,然后验证 NetQuestion 安装目录和产品帮助目录 (_INSTALL_DIR\doc 或 INSTALL_DIR\help,取决于产品的不同)中的所有文件和文件夹都将安全性许可权设置成每个人 - 完全控制。 要这样做:
如果更改许可权,则关闭这些对话框然后重新装入页面。 如果不需要更改许可权,或者如果在进行更改之后错误仍存在,则尝试从 NetQuestion 安装目录删除文件 vahelp.cfg,然后对您的产品重新配置帮助。
如果还看到内部服务器错误消息,则与 IBM 支持部门联系。
在某些情况下,帮助系统可能对特定产品进行了错误配置,或者可能在试图修复安装时除去了某些配置信息。 您可以通过遵循以下指导信息来重新配置产品的帮助。在开始之前,需要知道:
这个过程的第一步需要确定是否已经配置了帮助,只需刷新即可。要确定是否配置了产品的帮助,在命令提示行输入以下命令:
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 命令重新配置帮助。 本节后面描述了这两种情况。
在运行 vahcfg regen 或 vahcfg install 之前,还应该确保文档目录所在的磁盘有足够的空闲空间来 容纳产品帮助的搜索索引。 这些索引从文档目录中的 *.zip 文件抽取,并由 vahcfg 程序写入文档目录的子目录。 一般地,磁盘上应该至少有文档目录中的 zip 文件所需的足够空闲空间。
要运行 vahcfg regen,发出以下命令:
vahcfg regen /p prodname /f %IMNINSTSRV%
其中,prodname 与您运行 vahcfg list 时记录的产品名匹配。
要运行 vahcfg install,发出以下命令:
vahcfg install /w docdir /f %IMNINSTSRV%
其中,docdir 是包含产品帮助文件的完整目录路径。 如果该目录中包含空格(例如 c:\Program Files\IBM\...),则将整个目录用引号括起。
安装后重新生成之后(可能需要几分钟),尝试重新装入帮助。如果 您试图改正的问题仍然存在,则遵循 6.5 从 vahcfg regen 或 vahcfg install 获得日志文件,与 IBM 支持部门联系,然后将日志文件转发给 IBM 支持部门。
如果尝试使用 vahcfg regen 或 vahcfg install 来重新生成或安装产品帮助,并且这种尝试不能解决您的帮助问题,则 尝试以下步骤来产生一个日志文件,IBM 支持部门可以使用该文件来进一步诊断您的问题:
然后,可以为 IBM 支持部门提供生成的日志文件。
请注意,某些早期的 vahcfg 版本不产生日志文件。 不支持记录的版本将把所有输出打印到屏幕。 支持记录的版本将打印一条消息指出信息已被记录。
除了最通用的搜索查询之外,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 来查看帮助,因为这个浏览器没有该性能问题。
当在浏览器中执行帮助系统搜索时可能会接收到以下错误消息之一:
这可以在两种情况下发生:
返回码 73 通常不是由于真正的空搜索请求而返回,只有在仅包含无用字时才返回。 如果在搜索字符串明显不为空(并且不是仅无用字的搜索)的情况下确实可靠地得到指明空搜索请求的消息,则搜索表单可能毁坏。 从产品帮助目录(通常是 INSTALL_DIR\doc 或 INSTALL_DIR\help)中找到搜索表单 rms hgssrch.htm 和 hgcsrch.htm,并在与 IBM 支持部门联系时将它们提供给支持代理人。
当尝试搜索时,可能会看到任何其它错误消息。 如果您得到的错误是以下之一,则在与 IBM 支持部门联系之前尝试推荐的操作。
原因:帮助客户机无法启动搜索服务 (或者,对于“组件代理”,没有将搜索服务配置成在登录时自动启动)。 当您在本地机器上搜索 (http://localhost:49213) 或在远程帮助服务器上搜索时都可以发生该错误。
推荐操作(本地帮助):
参阅 3.1 HTTPDL.EXE 不在运行 ,特别要留意有关导入自动启动注册表项的小节,以便搜索服务可以在登录时自动启动。 要想找到快速的替代方法,可以打开命令提示,然后输入:
imnss start server如果该命令返回包括以下行的消息:
已经启动了搜索服务。则您应该可以再次执行搜索而不会接收到 rc=33 错误。
推荐操作(远程提供的帮助):
服务器机器的 NetQuestion 搜索进程可能不在运行,因为机器已经重新引导并且当前没有人登录到机器。 请参阅 14.0 在重新引导期间启动 NetQuestion 搜索服务。
原因:搜索程序没有在搜索请求中接收到任何有效的索引名。 搜索表单可能已经毁坏,或者可能没有注册指定的索引,或者 NetQuestion 安装可能有问题。
建议操作:首先,从产品帮助目录 (INSTALL_DIR\doc or INSTALL_DIR\help) 删除所有 hg*.htm 文件。 然后对您的产品重新配置帮助。 如果问题仍然存在,则可能需要重新安装 NetQuestion,然后再次重新配置产品帮助。
原因:搜索表单指定了一个不存在的搜索表单头或脚注(一个包含要放置在搜索结果上面或下面的 HTML 部分的文件)。
建议操作:有关详细信息,请参阅 4.2 搜索时“没找到文件”错误。
原因:输入了包含过多字匹配的搜索查询。 搜索引擎无法处理包含匹配超过 1024 个不同字的请求。例如, 如果输入了字符串 "a* b* c* d*"(不带引号), 则您在请求包含以 a、b、c 或 d 之一开头的字的所有文档。 因为有如此之多的字与这些搜索标准匹配,所以搜索引擎无法 产生一个有意义、经过排序的搜索匹配,因此,它不进行尝试。
建议操作:输入将产生少一些字匹配的搜索请求。
原因:输入了一个逻辑上无效的搜索请求。 例如,搜索查询 "-java"(显示所有不包含字 java 的文档)被认为无效。
建议操作:输入包含至少一个不被禁止的词汇的搜索请求。
原因:当搜索程序无法读取成功搜索操作所需的环境变量时可能会发生该错误。 如果您已经将帮助配置成在 web 服务器上、而不是在 NetQuestion 的 HTTPDL.EXE web 服务器上运行,则您可能需要更改 web 服务器设置, 以确保搜索 CGI(由搜索表单中 <form> 标记的 "action=" 参数调用的程序)可以看到特定的环境变量。 在某些 web 服务器上,缺省隐藏系统环境变量。CGI 需要访问的变量是 IMNINSTSRV 和 IMNINST。Netscape Enterprise Server 是缺省隐藏环境变量的 web 服务器示例。
推荐操作:将您的 web 服务器设置修改成手工将这些环境变量导出至 web 服务器 CGI 应用程序, 或者修改成使 GCI 可以看到所有本地环境变量。在 Netscape Enterprise Server 上,可以遵循以下步骤来这样做:
set imn
系统应该返回 IMNINST 和 IMNINSTSRV 变量的设置,例如:
IMNINST=help IMNINSTSRV=C:\IMNNQ_NT
Init fn="init-cgi" IMNINSTSRV=c:/imnnq_nt Init fn="init-cgi" IMNINST=help
“警告:手工编辑了配置文件。使用该按钮来装入最新的配置文件。”
单击装入配置文件。
对于其它 web 服务器,请参考 web 服务器文档来获得有关使 CGI 应用程序可以看到环境变量的信息。
原因:当 NetQuestion 无法正确访问产品索引时会发生 rc=32 错误或提及文件 NETQ.CFG 的错误。 可能会因为 NetQuestion 安装或特定索引已经毁坏而发生该错误,或者只在重新引导之后对给定索引进行第一次搜索时发生。 请注意,虽然此错误的某些形式的消息提到文件 NETQ.CFG,但该文件实际上不存在,而该错误指的是其它 NetQuestion 索引配置文件。
推荐操作:确定发生问题的可能原因并如下所述进行改正:
如果搜索返回 rc=76 错误消息,则可能需要复位一个或多个搜索索引。 遵循以下步骤来复位索引:
在某些情况下,使帮助正常工作的唯一方法就是卸载、再重新安装 NetQuestion,然后重新配置使用“VisualAge 帮助系统”的产品帮助。 请注意,卸载 NetQuestion 可能会除去不使用“VisualAge 帮助系统”、但由产品(如 IBM DB2)使用的搜索索引, 并可能因而在重新安装了 NetQuestion 之后阻止那些产品的帮助搜索。 您可能需要重新安装可能出问题的产品以恢复其搜索索引。
在以下的指导部分中,从命令行发出所有命令。 在开始之前,需要确定 NetQuestion 安装目录。
如果没有注册索引,则 NetQuestion 目录中的 NetQuestion 卸载程序 uninstnq.exe 将只除去 NetQuestion。 可以首先对每个产品发出 vahcfg remove 命令来除去由使用“IBM VisualAge 帮助系统”的产品注册的所有索引。遵循以下步骤:
除去所有这样的产品之后,可以通过输入以下命令来查看是否仍对其它产品注册了索引:
imnixlst
如果结果列表包含以 DB2、CXX 或 VAC 开头的项,则您可能对如 DB2、IBM C 和 C++ 编译器等不使用“VisualAge 帮助系统”的产品注册了索引。 如果继续手工卸载 NetQuestion,则您将丢失那些索引并可能需要重新安装各个产品以再次搜索按那些产品的帮助。 如果仍然列出了这样的索引,并且您对失去那些产品的搜索能力已有准备或者要重新安装那些产品,则如下所示继续删除余下的索引:
如果列出了其名称以 IVJ3、VJ32、IWZ 或 VA45 开头的索引,则可以安全地删除它们,因为以后可以使用 vahcfg install 恢复它们。
如果因为 NetQuestion 错误而无法删除所有剩余索引,则可能需要手工除去 NetQuestion(请参阅下面的 11.4 一节)。
发出命令 uninstnq 然后等待几分钟,直到看到 NetQuestion 目录几乎为空为止。该目录不应该包含任何以 imn* 或 imq* 开头的文件。您可能需要等待十分钟,这个过程才能结束。 如果十分钟之后该目录仍然包含 imn* 或 imq* 文件,则可能还有注册到搜索服务的索引(在这种情况下,返回到 11.2 一节), 或者 NetQuestion 安装可能毁坏(继续到 11.4 一节)。否则,重新引导机器并继续到 11.5 一节。
如果无法使用 uninstnq.exe 除去 NetQuestion,您可以如下所示手工除去它:
要更改或除去环境变量,遵循以下特定于平台的步骤:
要重新安装 NetQuestion,需要有产品 CD 或从 IBM 支持部门获得 NetQuestion 安装 zip 文件。 以下产品在其 CD 上有可安装的 NetQuestion 副本:
对于其它产品,可以通过搜索名为 ntq_sbcs.iss 的文件来确定 CD 上是否有可安装的 NetQuestion 副本。 包含该文件的目录应该包含一个 setup.exe 文件,该文件可以启动 NetQuestion 的安装。
如果从 IBM 获得安装 zip 文件,则将其解压缩到一个临时目录中。
一旦获得了 NetQuestion 的可安装副本,就遵循以下步骤:
对于从帮助系统手工除去的每个产品(使用 vahcfg remove,如 11.1 小节中所述),运行 vahcfg install,如 6.0 重新配置帮助所述。 现在您应该可以浏览和搜索产品帮助了。如果错误仍然存在,则查看本文档的其它部分以寻求可能的解决方案,或与 IBM 支持部门联系。
如果无法从产品用户界面启动帮助,则可以创建一个图标以通过双击该图标来启动它(这样当您解决问题时至少可以使用帮助)。
注
可以如下创建一个快捷方式来启动产品帮助:
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 试图启动帮助时没有任何事发生)。 如果路径包含空格,确保配置文件的完整路径位于引号中。
可以按以下步骤将创建的图标添加到“开始”菜单:右键单击图标,从弹出菜单选择复制,然后在“Windows 资源管理器”中 从 Windows 安装目录浏览到 ...\Profiles\All Users\Start Menu,然后将其粘贴到该目录或其适 当子目录。
可以在 Windows NT 或 Windows 2000 web 服务器上配置帮助系统,以便您所在组织中的其他成员可以无需在其工作站上安装帮助系统代码就可以通过网络查看和搜索联机帮助。
产品说明
要进行这种网络安装,必须在服务器上安装 web 服务器软件,如 Microsoft Peer Web Services (PWS) 或 Microsoft IIS。 web 服务器应该具有脚本目录。(在 PWS 和 IIS 中,脚本目录通常位于 x:\inetpub 之下。) 安装完服务器软件之后,完成以下步骤:
vahwebx.exe vahwebx.cat vahelp.cfg *foot.htm *head.htm *henus.htm
***************前三个文件是必需的;如果后面的文件存在,它们应该是复制的, 但是如果它们从 NetQuestion 目录丢失,则 x:\inetpub\scripts 目录应该不需要它们。
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 install 或 vahcfg regen, 则必需再次编辑上述步骤 3 中的映射文件。
一旦用户将他们的产品帮助配置文件修改为指向服务器, 他们就可以安全地运行下列命令,以从他们的产品帮助目录删除所有*.toc、*.htm 和 *.zip 文件以及搜索索引文件。
vahcfg remove /p prodname /f %IMNINSTSRV%
或者,他们可以仅手工删除 *.toc、*.htm 和 *.zip 文件。 然而,这种方法将不删除产品帮助目录下的索引目录,所以仍需要手工删除它们。
如果您正在联网帮助配置中配置服务器,请参阅 14.0 在引导时启动 NetQuestion 搜索服务器,而不是参阅本小节。
可以通过在系统上设置两个注册表项,将 HTTP 和搜索服务器设置为登录时自动启动。 要设置这些项,请按照下列步骤:
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"
这会将两个项导入注册表中,以便下次登录(或在 Windows 95 或 Windows 98 上重新引导)时, 服务器应该自动启动。
如果正在使用联网帮助配置,其中帮助是从服务器交付的,而不是来自您自己的机器, 那么对远程机器执行搜索时可能会遇到问题。 当 NetQuestion 的搜索守护进程设置为自动启动(在产品安装期间,或者在执行 13.0 自动启动 NetQuestion 服务器中的步骤后)时,守护进程实际上没有启动, 直到用户登录到服务器为止。这意味着, 在系统重新引导之后到机器的用户第一次登录之前, 搜索守护进程没有运行。 然而,您可以使用 Windows 任务计划程序,使它在引导时启动。 本小节中的指示信息适用于为帮助提供服务的机器。
注:如果没有使用网络帮助配置,则不必执行本小节中的步骤。
在启动之前,应该确定 NetQuestion 安装目录。 可能还要手工清除注册表。 注册表可能包含在登录时启动 NetQuestion 搜索守护进程的项。 如果打算在引导时启动守护进程,那么注册表项不是必需的。要清除注册表:
现在,可以告诉 Windows 在引导时启动服务器。首先, 检查 Microsoft 的“Windows 任务计划程序”是否安装在作为帮助服务器的机器上:
要在帮助服务器上将“NetQuestion 搜索服务器”设置成引导时启动:
注:在帮助服务器重新引导之后,从登录屏幕出现之后到 Windows 启动搜索服务器之前要花一分钟时间或更长时间。
可以通过打开命令提示并输入下列命令来确定 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%
如果无法从浏览器或从命令行启动帮助,可能因为未设置 HTML 文件的正确文件关联。“帮助系统”客 户机代码根据这些文件关联使用注册表项来确定缺省的系统浏览器。可使用注册表编辑器检查文件关联。
如果看不到该项,可以按如下操作添加项:
对于 Netscape Communicator:
user_pref("browser.wfe.ignore_def_check", true);
对于 Internet Explorer:
如果正在使用 Windows Millennium Edition,即使在重新引导后, 您对 autoexec.bat 所作的更改以装入 NetQuestion 环境变量也可能不起作用;这些更改可能在重新引导后消失。这可能导致 NetQuestion 环境保持未定义状态,将依次产生下列各种故障:
可以通过检查在重新引导之后环境变量是否被正确设置来确定这是不是帮助问题的原因。如果 它们仍然没有被设置,可以使用 Windows 系统目录中找到的 msconfig.exe 程序来完成下列环境更改:
“组件代理”不使用 VisualAge“帮助系统”的客户机部分, 从用户界面的 F1 或“帮助”菜单操作启动帮助的部分。这有两个重要含义:
“组件代理”在 doc\readme 目录中提供了关于帮助疑难解答的附加信息。
在安装了部分或全部用“简体中文”(语言环境 zh_CN)、繁体中文 (zh_TW)、 韩国语 (ko_KR) 或日语 (ja_JP) 编写的帮助的系统上,需要对 vahcfg 和 NetQuestion 命令作如下更改:
vahcfg regen /p vj32 /f %IMNINSTSRV% /l ja_JP
包含语言环境失败可能导致搜索索引和 NetQuestion 搜索系统被破坏。
SBCS 命令 | DBCS 命令 |
imnixlst | imqixlst |
imnixdel | imqixdel |
imnss start server | imqss -start dbcshelp |
因为 NetQuestion 将不同的可执行文件和服务器用于其单字节和双字节搜索系统,所以需要这些更改。