VisualAge Help System 可以顯示許多 IBM 軟體產品的線上說明資訊。 當您在其中一項產品的使用者介面上按下 F1 或選取「說明」功能表時， 應會開啟瀏覽器且應顯示該產品的說明。 如果您在啟動或使用產品線上說明時發生問題，則此文件可以協助您解決問題。
VisualAge Help System 是由三個主要元件所組成：
在大部份的情況下，這三個元件都會在安裝了本產品的機器上執行。
若要開始解決您的問題，請遵循下列三個步驟：
請讀取摘要 1.2 特殊注意事項，然後讀取所有適用於產品或環境的列示章節
到 2001 年二月，下列 IBM 產品使用 VisualAge Help System：
如果您使用的是 2000 年十一月以後上市的 IBM 軟體產品且它不在上述清單中， 則您可以在指令提示中鍵入下列指令以確定該產品是否使用 VisualAge Help System：
vahcfg list /f %IMNINSTSRV% | more
然後在以產品：起首的字行中尋找您的產品名稱。 如果您的產品出現在清單中，則該產品使用 VisualAge Help System。如果它不在清單中， 或如果您收到一則訊息表示指令無法辨識，則您可以聯絡 IBM 支援以確定您的 IBM 產品是否使用 VisualAge Help System。
如果產品、環境或問題說明符合您的情況，則應讀取下列區段：
在產品的「說明」功能表中，選擇「說明首頁」（或產品的對應功能表項目）。 如果沒有任何「說明」功能表可供使用，則試著在產品使用者介面的其中一個窗格中按下 F1。 發生什麼事？
如果說明顯示正確，則另外兩個可能的問題是：
如果您的問題不是上述其中之一，請聯絡 IBM 支援。 請參閱 http://www.ibm.com/software/ad/support 以取得進一步資訊。
註：本區段不適用於 Component Broker 或 WebSphere Business Components。關於 Component Broker， 請參閱 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。 您可以編輯捷徑的目標欄位以指向 VAJ_INSTALL_DIR\ide\program\ivjenv.bat，即可解決此問題。此批次檔會變更您的 Windows 環境變數， 使說明能夠從 IDE 中正常運作。
如果啟動說明造成開啟瀏覽器或瀏覽器進入前景，但瀏覽器無法連接 localhost:49213，則可能有三種問題：
請檢查下列每一個子區段，以嘗試解決 Web 伺服器或瀏覽器配置錯誤的任何可能問題。
HTTPDL.EXE 是一種 HTTP 伺服器處理，僅支援本端存取。 它是 NetQuestion 元件的一部份。用來對本端瀏覽器提供說明網頁。 請檢查處理 HTTPDL.EXE 是否在作業清單中。
如果作業沒有出現，則說明系統可能無法啟動它。 請先試著從指令行呼叫它，看看它是否傳回錯誤訊息：
變更至安裝 NetQuestion 的目錄 （請參閱 15.0 尋找 NetQuestion 安裝目錄）
如果它傳回錯誤連結 Socket 失敗， 則 HTTPDL.EXE 處理大概已經在埠 49213 上執行（TCP/IP 埠是由 HTTPDL.EXE 處理使用）。如果傳回任何其它錯誤， 請聯絡 IBM 支援。如果沒有傳回任何錯誤，請檢查作業清單以確定它是否正在背景中執行。 日期標示為 02/12/2000 或更早的 HTTPDL.EXE 版本若未偵測到錯誤，則會鎖定指令提示； 稍後的版本則會繼續執行而不鎖定指令提示。 如果您的版本會鎖定指令提示，請按下 Ctrl+Break 並發出下列指令， 以便以分離的處理來代替並啟動處理：
nqdetach httpdl.exe -r httpd.cnf
現在，請試著在瀏覽器中重新載入網頁。如果網頁的顯示正確， 則說明系統在啟動 HTTP 伺服器時有問題（或若為 Component Broker，則伺服器未設定為在登入時啟動）。請參閱 13.0 自動啟動 NetQuestion 伺服器。
如果網頁仍然無法顯示，請參閱 3.2 HTTPDL.EXE 的配置錯誤及 3.3 瀏覽器需要 Proxy 置換。
有時，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 檔案的目錄。如果不是，則請在上述出現該資訊的所有位置上變更它以反映實際的路徑。
主電腦名稱 localhost 埠 49213
如果現存的主電腦名稱或埠行與上述的不同，則以上述的資訊置換現存的。
有時，您的瀏覽器無法連接本端 Web 伺服器 HTTPDL.EXE，因為它會試著透過 Proxy 伺服器找出名稱為 localhost 的機器。這通常會在瀏覽器設定手動或自動 Proxy 配置時發生。如果您使用手動 Proxy 配置， 則可以修改瀏覽器設定以避免瀏覽器嘗試從 Proxy 伺服器解析 localhost。如果您使用自動 Proxy 配置， 則必須要求自動 Proxy 配置檔的擁有者在 Proxy 伺服器上新增 127.0.0.1 作為 Proxy 例外。
若要確定您的瀏覽器是否設定手動 Proxy 配置， 且如果已設定而要新增 Proxy 置換時，請遵循下列步驟。 這些指示適用於指出的瀏覽器版本；如果您使用的瀏覽器版本不同，則步驟可能會不同：
若為 Netscape 4.7：
若為 Internet Explorer 5.0：
您也應新增下列字行以更新檔案 %SystemRoot%\system32\drivers\etc\hosts：
127.0.0.1 localhost
（如果檔案存在，但尚未有該字行。）如果您變更此值，則可能需要結束並重新啟動瀏覽器以讓變更生效。
如果您變更了瀏覽器配置或 ...\etc\hosts 檔案，請試著在瀏覽器中重新載入說明首頁。如果您在嘗試連接 locahost:49213 時仍然有錯誤，請聯絡 IBM 支援。
如果在您試著檢視說明時無法存取自動 Proxy 伺服器，則瀏覽器可能無法解析本端位址 127.0.0.1 的 localhost。您可以在上述步驟 4 (Netscape) 或步驟 3 (Internet Explorer) 中變更為直接連線到網際網路， 以暫時解決此問題（在無法使用 Proxy 伺服器時）。
如果您在嘗試檢視說明或試著進行搜尋時收到找不到檔案錯誤， 則可能在 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= 屬性部份，在上述範例中，則是 ivjsenus.exe 或 va4sall.exe。
您也可能在搜尋結果頁面得到破損的影像，或訊息找不到搜尋套表標頭或找不到搜尋套表標底。這些錯誤是因 NetQuestion 安裝目錄中遺漏了其它檔案所造成的。您可以在產品 CD 上找到這些檔案，或您可以從 IBM 支援取得檔案。檔案名稱均已在搜尋套表內指定。您可以檢視搜尋套表的原始檔以確定名稱。請尋找下列隱藏輸入欄位的 value= 參數：
<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 的輸出包括下列各項：
Product: va400 (IBM WebSphere Development Tools for AS/400 Help System) Writable directory: C:\Program Files\IBM\WDT400\help No update files for this product Comp: qadtswin (WebSphere Development Tools for AS/400) Zip file: C:\Program Files\IBM\WDT400\help\qadtswin.zip Index: va45uadt ...
產品名稱是 va400。如果您看到您的產品登錄，則可以使用 vahcfg regen 指令重新配置說明。如果您沒有看到產品的登錄， 則必須使用 vahcfg install 指令重新配置說明。本區段稍後會有兩者的詳細說明。
在您執行 vahcfg regen 或 vahcfg install 之前，您也應確定文件目錄所在的磁碟有足夠的可用空間， 可以容納產品說明的搜尋索引。 這些索引是從文件目錄的 *.zip 檔中取出，並由 vahcfg 程式寫入文件目錄的子目錄中。依照一般規則， 您在磁碟上的可用空間量至少必須與文件目錄中壓縮檔所使用的空間量相同。
若要執行 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 搜尋系統在尋找所有相符項目時的速度非常快速，但以同屬搜尋查詢的速度最快。 如果您搜尋符合字串 a* 的項目，則搜尋系統必須找出內含至少一個以字母 a 起首字組的所有文件， 所以這一定會需要較長的時間。但如果您是搜尋特定項目，則最多只需要幾秒鐘的時間即可得到搜尋結果。 如果搜尋所需的時間過久（例如，超過 1 分鐘）， 則可能是發生與在 Windows 2000 系統上使用 Netscape Navigator 4.5 或更高版本相關的問題。 （此問題也會在部份 Windows NT 系統上發生。）
在部份 Windows 2000 機器上使用 Netscape（版本 4.5 到 4.74，其它版本也有可能）有一些已知的問題，可能會造成搜尋線上說明的速度非常緩慢。 當您在這些版本的 Netscape 中提出套表時，Netscape 應用程式會使用機器上大部份可用的處理器循環， 直到收到遠端系統的回應。 （您可以在進行這類搜尋時開啟「Windows 工作管理程式」頁面， 切換至「處理」標籤，然後按一下 CPU 直欄標頭，即可驗證此項。 如果您發生此處所述的問題，則在此清單的頂端會出現 netscape.exe 且會使用 97-99% 的 CPU 時間。）
在執行遠端搜尋（例：搜尋網站）時，這種 CPU 用法通常不是問題。 但是，因為產品的搜尋程式是在您自己的本端機器上執行，如果 Netscape 使用這麼多的 CPU 時間，則此情況表示只剩下非常少的 CPU 時間可供搜尋程式執行搜尋使用。 結果，應該在一秒內傳回結果的搜尋動作，在 Windows 2000 上可能需要數分鐘的時間。
您可以在每一次提出搜尋後，選取不同的非 Netscape 視窗，即可在 Windows 2000 上避免此效能問題。 這通常會造成 Netscape 在等待回應時停止使用過多的 CPU 循環， 且在執行此視窗切換後，通常會在一秒鐘內顯示搜尋結果。 同樣的技術也可以在 Windows NT 上使用，雖然不完全相同。
另外，您可以使用 Microsoft Internet Explorer 來檢視說明，因為使用此瀏覽器不會發生效能問題。
從瀏覽器中執行說明系統搜尋時，您可能會收到下列其中一項錯誤訊息：
這會發生在下列兩種狀況中：
回覆碼 73 通常不會針對真正空的搜尋要求傳回，只針對僅由停止字組組成的要求傳回。 如果在字串顯然不是空的（且不是只有停止字組搜尋）且確實會重新產生表示空搜尋要求的訊息， 則您的搜尋套表可能已受損。 請從產品說明目錄（通常是 INSTALL_DIR\doc 或 INSTALL_DIR\help）中找出搜尋套表 hgssrch.htm 與 hgcsrch.htm， 並在聯絡 IBM 支援時將這些套表提供給支援代表。
您在嘗試搜尋時，可能會看到許多其它的錯誤訊息。 如果您的錯誤是下列其中一項，請在聯絡 IBM 支援前先嘗試執行建議的動作。
原因：說明從屬站無法啟動搜尋服務（或者，若為 Component Broker，則搜尋服務未設定為在登入時自動啟動）。 不論您是在本端機器 (http://localhost:49213) 或在遠端說明伺服器上搜尋，都會發生此問題。
建議動作（本端說明）：
請參閱 3.1 HTTPDL.EXE 未在執行中及特別是有關匯入自動啟動登錄項目的區段，讓搜尋服務在您登入時自動啟動。如需快速解決方案，您可以開啟指令提示並鍵入：
imnss start server如果此指令傳回一則訊息，內含下列字行：
The search service has been started.則您應該能重新執行搜尋，而不會發生此 rc=33 錯誤。
建議動作（遠端提供說明）：
伺服器機器的 NetQuestion 搜尋處理可能不在執行中，因為機器已重新啟動且目前沒有使用者登入機器。請參閱 14.0 開機時啟動 NetQuestion 搜尋服務。
原因： 搜尋程式在搜尋要求中未收到任何有效的索引名稱。 搜尋套表可能已受損，或指定的索引已經沒有登記，或 NetQuestion 安裝可能有問題。
建議動作：首先，從產品說明目錄（INSTALL_DIR\doc 或 INSTALL_DIR\help）中刪除所有 hg*.htm 檔案。 然後，試著為產品重新配置說明。 如果問題持續存在，您可能需要重新安裝 NetQuestion， 然後再次重新配置產品的說明。
原因：搜尋套表指定的搜尋套表標頭或標底（含有要放在搜尋結果上面或下面之 HTML 片段的檔案）不存在。
建議動作：請參閱 4.2 嘗試進行搜尋時發生「找不到檔案」錯誤以取得進一步資訊。
原因：您輸入的搜尋查詢有太多字組相符。 搜尋引擎無法處理其相符超過 1024 個以上不同字組的查詢。 例如，如果您輸入搜尋字串 "a* b* c* d*"（沒有引號）， 則您是要求內含以任一字母 a、b、c 或 d 起首字組的所有文件。 因為有太多字組符合這些搜尋準則，搜尋引擎無法產生有意義、排序的搜尋命中結果清單， 所以它未嘗試執行。
建議動作：請輸入會產生較少字組命中結果的搜尋要求。
原因：您輸入的搜尋查詢在邏輯上無效。 例如，"-java" 的搜尋查詢（顯示所有不含字組 java 的文件）不被視為有效。
建議動作：請輸入至少含有一個非禁止條件的搜尋要求。
原因： 當搜尋程式無法讀取順利完成搜尋作業所需的環境變數時，即會發生此錯誤。 如果您已配置說明在 NetQuestion HTTPDL.EXE Web 伺服器以外的 Web 伺服器上執行， 則您可能需要變更 Web 伺服器設定以確定搜尋 CGI（該程式是從搜尋套表中<套表>標籤的 "action=" 參數中呼叫）可以看見某些環境變數。 在部份 Web 伺服器上，依照預設值，系統環境變數會隱藏起來。 搜尋 CGI 必須存取的變數是 IMNINSTSRV 與 IMNINST。Netscape Enterprise Server 就是一個依照預設值隱藏環境變數的 Web 伺服器範例。
建議動作： 請修改您的 Web 伺服器設定，以將這些環境變數自行匯出至 Web 伺服器 CGI 應用程式， 或讓 CGI 可以看見所有的本端環境變數。在 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 應用程式可以看見環境變數的相關資訊。
原因： rc=32 錯誤或表示在 NetQuestion 無法正確地存取產品索引時發生檔案 NETQ.CFG 的一則錯誤。 因為 NetQuestion 安裝或特定的索引受損，則可能會發生此錯誤， 或您在重新開機後只對指定的索引執行第一次搜尋時，可能會發生此錯誤。 請注意：雖然此錯誤的部份套表訊息提到檔案 NETQ.CFG，但此檔案實際上並不存在； 錯誤是指其它 NetQuestion 索引配置檔有問題。
建議動作：請確定問題的可能原因並加以更正，如下所示：
如果搜尋傳回 rc=76 錯誤訊息，則您的一或多個搜尋索引可能需要重設。請遵循下列步驟以重設索引：
在某些情況下，讓說明正常運作的唯一方法就是解除安裝並重新安裝 NetQuestion， 然後重新配置使用 VisualAge Help System 的產品說明。請注意： 解除安裝 NetQuestion 可能會移除一些產品（如 IBM DB2）所使用的搜尋索引， 這些產品不使用 VisualAge Help System，且在解除安裝 NetQuestion 後， 可能因此無法搜尋這些產品的說明。 您可能必須重新安裝有問題的產品以復置其搜尋索引。
在接下來的指示中，請從指令提示發出所有指令。 開始之前，您必須確定 NetQuestion 安裝目錄。
如果沒有登記任何索引，則 NetQuestion 解除安裝程式（在 NetQuestion 目錄中的 uninstnq.exe）只會移除 NetQuestion。 對於每一個使用 IBM VisualAge Help System 的產品， 您可以先發出 vahcfg remove 指令，即可移除這類產品所登記的所有索引。 請遵循下列步驟：
移除所有這類產品後，您可以鍵入下列指令以檢查是否仍有其它產品登記的索引：
imnixlst
如果產生的清單含有以 DB2、CXX 或 VAC 起首的登錄， 則您大概還有如 DB2、IBM C 與 C++ Compilers 或 VisualAge C++ 4.0 這類產品所登記的索引， 這些產品不使用 VisualAge Help System。如果您是以手動方式解除安裝 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 安裝壓縮檔。下列產品在產品 CD 中有可安裝的 NetQuestion 副本：
若為其它產品，您可以搜尋檔案 ntq_sbcs.iss， 以確定 CD 中是否有可安裝的 NetQuestion 副本。 含有此檔案的目錄應含有 setup.exe 檔，該檔案可以啟動 NetQuestion 安裝。
如果您從 IBM 收到安裝壓縮檔，請將它解壓縮到暫時目錄。
一旦您取得可安裝的 NetQuestion 副本，請遵循下列步驟：
對於您從說明系統中自行移除的每一項產品（使用 vahcfg remove，如區段 11.1 中的指示）， 請執行 vahcfg install，如 6.0 重新配置說明中所述。 您現在應該可以瀏覽及搜尋產品說明。如果錯誤持續存在，請檢查本文件的其它區段以找出可能的解決方案， 或聯絡 IBM 支援。
如果您無法從產品的使用者介面啟動說明， 則可以建立圖示，並在圖示上連按兩下以啟動它（使您在解決問題時，至少可以使用說明）。
注意事項
您可以建立捷徑以啟動產品說明，如下所示：
instance "INSTALL_DIR\DOC_DIR\CONFIG_FILE" open index.htm
其中 INSTALL_DIR 是安裝產品的目錄，DOC_DIR 通常是文件或說明，且 CONFIG_FILE 是產品說明配置檔的名稱（若為 VisualAge for Java，則是 ivjhlp.cfg； 請參閱 2.0 嘗試啟動說明時未發生任何事情，以取得確定其它產品的目錄與配置檔檔名的相關資訊）。如果配置檔的完整路徑中含有空格，請確定該路徑是以引號括住。
您可以在圖示上按一下右鍵，從蹦現功能表中選擇 複製，然後在「Windows 檔案總管」中向下導覽整個 Windows 安裝目錄， 在 ...\Profiles\All Users\Start Menu 下，將該圖示貼到該目錄或適當的子目錄中。
您可以在 Windows NT 或 Windows 2000 Web 伺服器上安裝及配置說明系統， 使組織的其它成員可以透過網路檢視及搜尋線上說明，而不必使用安裝在其工作站上的 NetQuestion 與說明系統程式。
產品注意事項
若要執行此網路安裝，您必須在伺服器中安裝 Web 伺服器軟體， 如 Microsoft Peer Web Services (PWS) 或 Microsoft IIS。 Web 伺服器應有一個 Script 目錄。（在 PWS 與 IIS 中， 您的 Script 目錄通常是在 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
然後，使用者應該只要按下 F1 或從 IBM 應用程式中選取「說明」功能表項目， 即可存取以伺服器為基礎的說明。 或者，使用者可以使用下列 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 Task Scheduler：
若要在說明伺服器上設定「NetQuestion 搜尋伺服器」在開機時啟動：
註：在重新啟動說明伺服器機器後，在出現登入畫面之後，在 Windows 啟動搜尋伺服器之前， 可能需要一分鐘或更長的時間。
若要確定 NetQuestion 安裝目錄的位置，您可以開啟指令提示並鍵入：
set IMNINSTSRV
傳回的目錄就是 NetQuestion 安裝目錄。如果沒有設定變數， 您可以查詢 Windows 登錄以確定安裝目錄。 在指令提示中輸入 regedit， 並展開登錄項目到密碼鎖 HKEY_LOCAL_MACHINE\SOFTWARE\IBM\NetQuestion\CurrentVersion\Installation 目錄。該密碼鎖的"目錄"登錄應指向 NetQuestion 安裝目錄。
在 Windows 95 與 Windows 98 上，如果 IMNINSTSRV 環境變數未設定， 但您可以從登錄中找到目錄，則您可能需要編輯 autoexec.bat 檔案。（如果您在 Windows Millennium Edition 上發生此狀況， 請參閱 17.0 Windows Millennium Edition 的特殊注意事項。） NetQuestion 安裝程序應該已修改了 autoexec.bat，以新增指令 呼叫儲存在 NetQuestion 目錄中的批次檔 imnenv.bat。 新增的指令與下列類似：
if exist _NETQ_DIR_\imnenv.bat call _NETQ_DIR_\imnenv.bat
如果遺漏了此字行，或 _NETQ_DIR_ 指向錯誤的目錄， 請以正確的 NetQuestion 目錄新增字行。您也應驗證在 autoexec.bat 中呼叫的 imnenv.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 程式， 以進行下列環境變更：
Component Broker 不會使用 VisualAge Help System 的從屬站部份， 該部份可以在使用者介面上從 F1 或「說明」功能表動作中啟動說明。 這有兩個重要含意：
Component Broker 在 doc\readme 目錄中提供有關說明疑難排解的其它資訊。
在安裝說明是部份或完全以簡體中文 (locale 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 會針對單位元組及雙位元組搜尋系統使用不同的可執行檔與伺服器。