Fehler in der Hilfefunktion in WebSphere- und VisualAge-Produkten beheben

Die VisualAge-Hilfefunktion aktiviert die Anzeige von Onlinehilfetext für eine Reihe von IBM Softwareprodukten. Wenn Sie F1 drücken oder einen Hilfemenüpunkt aus der Benutzerschnittstelle eines dieser Produkte auswählen, sollte ein Browser geöffnet und Hilfetext für das Produkt angezeigt werden. Haben Sie Probleme beim Starten oder Verwenden der Onlinehilfefunktion für Ihr Produkt, kann dieses Dokument Sie bei der Fehlerbehebung unterstützen.

Die VisualAge-Hilfefunktion besteht aus drei Hauptkomponenten:

In den meisten Fällen werden alle drei Komponenten auf der Maschine ausgeführt, auf der das Produkt installiert ist.

1.0 Startpunkt

Um mit der Lösung Ihres Problem zu beginnen, führen Sie diese drei Schritte aus:

  1. Stellen Sie fest, ob dieses Dokument für Sie hilfreich ist, indem Sie 1.1 Produkte, die die VisualAge-Hilfefunktion verwenden lesen.

  2. Lesen Sie die Zusammenfassung 1.2 Besondere Hinweise und lesen Sie dann alle dort aufgelisteten Abschnitte, die für Ihr Produkt oder Ihre Umgebung gelten.

  3. Starten Sie die eigentliche Fehleranalyse mit dem Abschnitt 1.3 Welche Symptome liegen vor?

1.1 Produkte, die die VisualAge-Hilfefunktion verwenden

Die folgenden IBM Produkte verwenden die VisualAge-Hilfefunktion von Februar 2001:

Verwenden Sie ein IBM Softwareprodukt, das später als November 2000 freigegeben wurde und das nicht in der oben stehenden Liste aufgeführt ist, können Sie bestimmen, ob dieses Produkt die VisualAge-Hilfefunktion verwendet, indem Sie Folgendes in eine Eingabeaufforderung eingeben: 

vahcfg list /f %IMNINSTSRV% | more

und dann nach dem Namen Ihres Produkts in Zeilen suchen, die mit dem Wort Product: beginnen. Ist Ihr Produkt in der Liste aufgeführt, verwendet es die VisualAge-Hilfefunktion. Erscheint es nicht in der Liste oder erhalten Sie eine Nachricht, die angibt, dass der Befehl nicht erkannt wird, können Sie sich an die IBM Unterstützungsfunktion wenden, um zu bestimmen, ob Ihr IBM Produkt die VisualAge-Hilfefunktion verwendet.

1.2 Besondere Hinweise

Sie sollten die folgenden Abschnitte lesen, wenn das Produkt, die Umgebung oder das beschriebene Problem Ihrer Situation entspricht:

1.3 Welche Symptome liegen vor?

Wählen Sie im Hilfemenü des Produkts die Homepage für Hilfe (oder den entsprechenden Menüpunkt für Ihr Produkt aus). Ist kein Hilfemenü verfügbar, versuchen Sie, in einem der Teilfenster der Benutzerschnittstelle Ihres Produkts F1 zu drücken. Was geschieht?

  1. Nichts - fahren Sie mit dem Abschnitt 2.0 Nichts geschieht, wenn versucht wird, die Hilfe zu starten fort.
  2. Ein Browser wird zwar gestartet oder im Vordergrund angezeigt, Folgendes ist jedoch nicht möglich:
    1. Er kann keine Verbindung zu localhost:49213 herstellen - fahren Sie mit 3.0 Verbindung zum Server localhost:49213 herstellen fort.
    2. Er kann keine Verbindung zu einem fernen Host herstellen und Sie verwenden Hilfe, die von einer fernen Einheit zur Verfügung gestellt wird - prüfen Sie, ob der Webserver auf dem fernen Host gestartet und korrekt konfiguriert wurde.
    3. Sie erhalten einen Fehler Datei nicht gefunden - fahren Sie mit 4.0 Fehler "Datei nicht gefunden" fort.
    4. Sie erhalten bei einer Suche andere Nachrichten, die fehlende Dateien angeben oder Sie erhalten beschädigte Images auf Ihrer Suchergebnisseite - fahren Sie mit 4.3 Andere Fehler bei der Suche, die fehlende Dateien angeben fort.
    5. Sie erhalten eine Nachricht Interner Serverfehler oder einen Nachrichtendialog Anwendungsfehler - fahren Sie mit 5.0 Nachrichten "Interner Serverfehler" fort.
  3. Sie erhalten eine Nachricht Das Produkt xxxxx ist der Hilfefunktion nicht bekannt - fahren Sie mit 6.0 Hilfefunktion rekonfigurieren fort.
  4. Sie erhalten eine Nachricht, die Sie auffordert, einen Browser zu verwenden, der Rahmen bearbeiten kann - führen Sie ein Upgrade für Ihren Standard-Browser auf Netscape 4.7 oder höher oder auf Internet Explorer 5 oder höher durch.
  5. Die Hilfe wird korrekt angezeigt.

Wird die Hilfe korrekt angezeigt, gibt es zwei weitere mögliche Faktoren:

  1. Sie möchten auf die Hilfe auf einer fernen Maschine zugreifen. Siehe 12.0 Hilfefunktion auf einem Windows-Server konfigurieren.
  2. Die Suche in der Hilfe funktioniert nicht. Versuchen Sie, eine Suchabfrage in das Eingabefeld "Suchen" einzugeben. Was geschieht?
    1. Nichts - der Browser gerät in eine Schleife und gibt keine Antwort zurück oder es dauert sehr lange, bis eine Antwort zurückgegeben wird - fahren Sie mit 7.0 Zeitlimitprobleme bei der Suche fort.
    2. Sie erhalten einen Fehler Datei nicht gefunden - fahren Sie mit 4.0 Fehler "Datei nicht gefunden" fort.
    3. Sie erhalten eine Nachricht Interner Serverfehler - fahren Sie mit 5.0 Nachrichten "Interner Serverfehler" fort.
    4. Sie erhalten eine Nachricht, die rc=73 oder den Text Die Suchanforderung war leer enthält - fahren Sie mit 8.0 Stoppwörter oder rc=73 fort.
    5. Sie erhalten eine Nachricht, die rc=32 oder eine andere Nachricht zu Fehlern bei der Suche enthält - fahren Sie mit 9.0 Andere Fehler bei der Suche fort.

Ist der aufgetretene Fehler keiner der oben beschriebenen, wenden Sie sich an die IBM Unterstützungsfunktion. Weitere Informationen erhalten Sie über http://www.ibm.com/software/ad/support.

2.0 Nichts geschieht, wenn versucht wird, die Hilfe zu starten

Anmerkung: Dieser Abschnitt gilt nicht für Component Broker oder WebSphere Business Components. Lesen Sie in Bezug auf Component Broker die Informationen in der Hilfe zur Fehlerbehebung im Verzeichnis doc\readme.

Geschieht nichts bei Verwendung von VisualAge für Java, Version 3.5 und beim Starten der VisualAge für Java-IDE über ein Desktop-Symbol, lesen Sie unter 2.1 Sonderfall - VisualAge für Java, Version 3.5 nach.

Geschieht nichts, wenn Sie versuchen, die Hilfe zu starten, sollten Sie als ersten Schritt feststellen, ob Sie die Hilfe von der Befehlszeile aus starten können. Dazu müssen Sie zunächst wissen, in welchem Verzeichnis Ihr Produkt installiert ist. Im nachfolgenden Text sollten Sie jeweils INSTALL_DIR (Installationsverzeichnis) durch das tatsächliche Verzeichnis ersetzen, in dem Ihr Produkt installiert wurde, beispielsweise x:\ibmvjava oder "x:\Programmdateien\IBM\VisualAge für Java". Schließen Sie den gesamten Pfad (INSTALL_DIR einschließlich aller Unterverzeichnisse oder Dateinamen) in Anführungszeichen ein, wenn der Pfad Leerzeichen enthält. Führen Sie diese Schritte aus, um zu versuchen, die Hilfe von der Befehlszeile aus zu starten:

  1. Öffnen Sie eine Eingabeaufforderung.
  2. Wechseln Sie zu dem logischen Laufwerk, auf dem das Produkt installiert ist, und dann in das Verzeichnis auf diesem Laufwerk. Ist Ihr Produkt beispielsweise in "g:\Programmdateien\IBM\VisualAge für Java" installiert, geben Sie Folgendes ein: 
    g:
cd "\Programmdateien\IBM\VisualAge für Java"
  3. Wechseln Sie unter dem Produktverzeichnis in das Verzeichnis, in dem sich die ausführbare Datei vahelp.exe befindet. Sie können den Speicherplatz bestimmen, indem Sie zunächst Folgendes eingeben: 
    dir /s /b vahelp.exe

    Gibt dies Folgendes zurück: 

    g:\Programmdateien\IBM\VisualAge für Java\eab\bin\vahelp.exe

    Würden Sie Folgendes eingeben:

    cd eab\bin
  4. Geben Sie den folgenden Befehl ein (Anführungszeichen sind nur erforderlich, wenn der Pfad Leerzeichen enthält):

Wird die Hilfe von der Befehlszeile aus erfolgreich gestartet und können Sie die Hilfe erfolgreich durchsuchen, ist möglicherweise die Pfaddefinition nicht korrekt und verhindert, dass die Benutzerschnittstelle Ihres Produkts eine Verbindung zu der DLL für die Hilfefunktion herstellen kann. Siehe 2.1 Sonderfall - VisualAge für Java 3.5, oder versuchen Sie bei anderen Produkten, Ihr Produkt zu deinstallieren und erneut zu installieren, da dies in einigen Fällen derartige Probleme behebt.

Sind Sie mit dem Starten der Hilfe von der Befehlszeile aus als Möglichkeit zur Umgehung des Problems oder als vorübergehende Korrektur zufrieden, können Sie dafür ein Symbol auf ihrem Desktop erstellen. Siehe 11.0 Symbol zum Starten der Produkthilfe erstellen.

Wird die Hilfe von der Befehlszeile aus nicht geladen, oder wird sie zwar von der Befehlszeile aus, aber nicht vom Produkt aus geladen, sind möglicherweise nicht die korrekten Dateizuordnungen für Ihren Browser in der Windows-Registrierungsdatenbank definiert. Siehe 16.0 HTML-Dateizuordnungen in der Windows-Registrierungsdatenbank definieren.

Wird auch durch das Ändern der Dateizuordnungen der Fehler nicht behoben, können Sie wie folgt versuchen, eine Protokolldatei aus der Hilfefunktion abzurufen:

  1. Editieren Sie die Konfigurationsdatei für die Produkthilfe (INSTALL_DIR\HELP_DIR\CONFIG_FILE) in einem Texteditor (beispielsweise Notepad) und fügen Sie am Ende der Datei die folgende Zeile hinzu:
    HTMLHELP_LOG=1
  2. Sichern Sie die Datei. Beachten Sie, dass Sie die Datei als Textdatei sichern, wenn Sie einen Editor wie WordPad verwenden.
  3. Verlassen Sie Ihr IBM Produkt und starten Sie es erneut.
  4. Drücken Sie F1 oder verwenden Sie das Hilfemenü, um die Hilfe vom Produkt aus zu starten.

Das Verzeichnis, auf das die Umgebungsvariable TMP zeigt, sollte eine oder mehrere Dateien der Art HTML*.C2T enthalten. Diese Dateien enthalten detaillierte Protokolldaten zu Anforderungen, die an die Hilfefunktion gesendet wurden. Sie können diese Dateien zur Analyse an die IBM Unterstützungsfunktion senden. Unter Umständen unterliegt das Anfordern von Unterstützung einer Gebühr. Sie können auch versuchen, diese Dateien selbst zu untersuchen, um die Ursache des Fehlers festzustellen.

Enthält Ihr Verzeichnis TEMP keine HTML*.C2T-Dateien, versuchen Sie erneut, die Hilfe von der Befehlszeile aus aufzurufen. Werden HTML*.C2T-Dateien nur von der Befehlszeile aus erstellt, liegt der Fehler bei Ihrem Produkt, das die Hilfe aufruft. Werden bei keiner der Methoden zum Aufrufen der Hilfe Protokolldateien erstellt, liegt ein Fehler in der Hilfefunktion selbst vor. In jedem der beiden Fälle können Sie sich an die IBM Unterstützungsfunktion wenden.

Vergessen Sie nicht, am Ende der Fehlerbehebung die Zeile HTMLHELP_LOG=1 aus Ihrer Konfigurationsdatei für die Produkthilfe zu entfernen, da durch das Protokollieren bei jedem Anfordern von Hilfe unnötige Protokolldateien erstellt werden.

Ist es immer noch nicht möglich, mit einer der Methoden die Hilfe zu starten, prüfen Sie, ob Ihre Konfigurationsdatei für die Produkthilfe noch gültig ist. Öffnen Sie INSTALL_DIR\HELP_DIR\CONFIG_FILE in einem Editor und überprüfen Sie Folgendes:

2.1 Sonderfall - VisualAge für Java, Version 3.5

Können Sie bei VisualAge für Java, Version 3.5, die Hilfe nicht von der IDE, sondern nur von der Befehlszeile aus starten, rufen Sie die IDE unter Umständen mit der falschen Verknüpfung auf. Dies geschieht, wenn Sie manuell eine Verknüpfung zu der IDE auf Ihrem Desktop oder im Menü "Start" erstellen oder editieren und die IDE mit dieser Verknüpfung aufrufen. Dies kann auch geschehen, wenn Sie eine Verknüpfung verwenden, die für Version 3.0 oder 3.02 erstellt wurde, und Sie diese Verknüpfung jetzt zum Starten von Version 3.5 verwenden. Führen Sie diese Schritte aus, um festzustellen, ob dies die Fehlerursache ist:

  1. Verlassen Sie jede aktive VisualAge für Java-IDE-Sitzung und warten Sie zehn Sekunden, nachdem das letzte VisualAge für Java-Fenster nicht mehr angezeigt wird, um sicherzustellen, dass das Programm seine Prozedur zum Schließen abgeschlossen hat.
  2. Starten Sie die VisualAge für Java-IDE mit dem Menü "Start" (Start > Programme > IBM VisualAge für Java für Windows V3.5 > IBM VisualAge für Java).
  3. Drücken Sie in der IDE F1.

Funktioniert die Hilfe, wenn Sie die IDE statt über das Symbol oder die Verknüpfung, das bzw. die Sie normalerweise verwenden, vom Menü "Start" aus aufrufen, zeigt dieses Symbol oder diese Verknüpfung wahrscheinlich auf VAJ_INSTALL_DIR\ide\program\ide.exe, die zwar die IDE erfolgreich startet, aber nicht die Hilfe unterstützt, da die Umgebungsvariable PATH nicht auf die DLL für die Hilfefunktion zeigt. Sie können diesen Fehler beheben, indem Sie das Feld Ziel der Verknüpfung so korrigieren, dass es auf VAJ_INSTALL_DIR\ide\program\ivjenv.bat zeigt. Diese Stapeldatei ändert Ihre Windows-Umgebungsvariablen so, dass die Hilfe von der IDE aus korrekt arbeitet.

3.0 Verbindung zum Server localhost:49213 herstellen

Hat das Starten der Hilfe zur Folge, dass ein Browser geöffnet wird oder im Vordergrund angezeigt wird, kann der Browser aber keine Verbindung zu localhost:49213 herstellen, gibt es drei mögliche Fehlerursachen:

Prüfen Sie jeden der folgenden Unterabschnitte nacheinander, um alle möglichen Fehler, die auf eine fehlerhafte Konfiguration des Webservers oder Browsers hinweisen, zu beheben.

3.1 HTTPDL.EXE ist nicht aktiv

HTTPDL.EXE ist ein HTTP-Serverprozess, der nur den lokalen Zugriff unterstützt. Er ist Teil der Komponente NetQuestion. Mit ihm werden Ihrem lokalen Browser Hilfetextseiten zur Verfügung gestellt. Prüfen Sie, ob der Prozess HTTPDL.EXE in Ihrer Task-Liste angezeigt wird.

Ist die Task nicht vorhanden, konnte die Hilfefunktion die Task möglicherweise nicht starten. Versuchen Sie zunächst, die Task von der Befehlszeile aus zu starten, um festzustellen, ob eine Fehlernachricht zurückgegeben wird:

  1. Wechseln Sie in das Verzeichnis, in dem NetQuestion installiert ist (siehe 15.0 NetQuestion-Installationsverzeichnis suchen).

  2. Geben Sie folgenden Befehl ein:
    httpdl -r httpd.cnf

Wird daraufhin der Fehler Binding the socket failed (Binden des Socket fehlgeschlagen) zurückgegeben, ist wahrscheinlich bereits ein Prozess HTTPDL.EXE am Anschluss 49213 aktiv (dies ist der TCP/IP-Anschluss, der von dem Prozess HTTPDL.EXE verwendet wird). Wird ein anderer Fehler zurückgegeben, wenden Sie sich an die IBM Unterstützungsfunktion. Erfolgt die Rückkehr des Befehls ohne Fehler, prüfen Sie die Task-Liste, um sicherzustellen, dass der Prozess im Hintergrund ausgeführt wird. Versionen von HTTPDL.EXE mit dem Datum 12.02.2000 oder früher sperren die Eingabeaufforderung, wenn kein Fehler erkannt wird; bei späteren Versionen wird die Ausführung ohne Sperren der Eingabeaufforderung fortgesetzt. Sperrt Ihre Version die Eingabeaufforderung, drücken Sie Strg+Untr und geben Sie den folgenden Befehl ein, um den Prozess stattdessen als Hintergrundprozess zu starten: 

nqdetach httpdl.exe -r httpd.cnf

Versuchen Sie jetzt, die Seite erneut in Ihren Browser zu laden. Wird die Seite korrekt angezeigt, hatte die Hilfefunktion Probleme beim Starten des HTTP-Servers (oder bei Component Broker ist der Server nicht zum Starten zur Anmeldezeit definiert). Siehe 13.0 NetQuestion-Server automatisch starten.

Wird die Seite immer noch nicht angezeigt, lesen Sie unter 3.2 HTTPDL.EXE ist falsch konfiguriert und 3.3 Browser benötigt Proxy-Überschreibungen nach.

3.2 HTTPDL.EXE ist falsch konfiguriert

Gelegentlich kann es vorkommen, dass die Konfigurationsdatei httpd.cnf, die von HTTPDL.EXE verwendet wird, falsche Pfadangaben enthält. Führen Sie diese Schritte aus, um zu überprüfen, ob sie korrekt konfiguriert ist:

  1. Suchen Sie über Start > Suchen alle Dateien mit dem Namen HTTPDL.EXE auf Ihren lokalen Festplattenlaufwerken. Überprüfen Sie, ob nur eine einzige Kopie vorhanden ist. Sind mehrere Kopien vorhanden, benennen Sie alle Kopien um, die sich nicht im NetQuestion-Installationsverzeichnis befinden. (Das Umbenennen gibt Ihnen die Möglichkeit, die Dateien später wiederherzustellen, falls es sich herausstellt, dass diese Dateien beispielsweise von einem anderen Webserver benötigt werden.)
  2. Editieren Sie die Datei httpd.cnf, die im NetQuestion-Installationsverzeichnis gespeichert ist. Suchen Sie alle Zeilen, die Pfadangaben enthalten. In der Regel handelt es sich dabei um die folgenden Zeilen: 
    Serverroot    C:\IMNNQ_NT
Exec    /cgi-bin/*  C:\IMNNQ_NT\*
Pass    /icons/*    C:\IMNNQ_NT\*
Pass    /*          C:\IMNNQ_NT\*

    Überprüfen Sie, ob der angegebene Pfad mit dem Verzeichnis übereinstimmt, in dem die Datei httpd.cnf gespeichert ist. Ist dies nicht der Fall, ändern Sie die Angabe an allen oben aufgeführten Stellen, um den tatsächlichen Pfad widerzuspiegeln.

  3. Überprüfen Sie, ob in httpd.cnf die folgenden Einträge vorhanden sind: 
    Hostname localhost
Port 49213

    Ersetzen Sie alle vorhandenen Zeilen Hostname oder Port durch die oben angegebenen, sofern sie abweichend sind.

  4. Hatten Sie in Schritt 2 oder 3 Änderungen an httpd.cnf vorgenommen, beenden Sie den Prozess HTTPDL.EXE und versuchen Sie erneut, die Hilfe zu starten. Wird der Fehler damit nicht behoben, lesen Sie den nächsten Abschnitt.

3.3 Browser benötigt Proxy-Überschreibungen

Gelegentlich kann es vorkommen, dass Ihr Browser keine Verbindung zum lokalen Webserver HTTPDL.EXE herstellen kann, da er versucht, die Maschine mit dem Namen localhost über einen Proxyserver zu lokalisieren. Dies ist typischerweise dann der Fall, wenn Ihr Browser für die manuelle oder automatische Proxy-Konfiguration konfiguriert ist. Wird die manuelle Proxy-Konfiguration verwendet, können Sie Ihre Browser-Einstellungen ändern, um zu verhindern, dass der Browser versucht, den Namen localhost über einen Proxyserver aufzulösen. Wird die automatische Proxy-Konfiguration verwendet, müssen Sie den Eigner Ihrer Datei für die automatische Proxy-Konfiguration bitten, 127.0.0.1 als Proxy-Ausnahme auf dem Proxyserver hinzuzufügen.

Um zu bestimmen, ob Ihr Browser für die manuelle Proxy-Konfiguration konfiguriert ist, und um Proxy-Überschreibungen hinzuzufügen, falls dies der Fall ist, führen Sie folgende Schritte aus. Diese Anweisungen gelten für die angegebenen Browser-Versionen; verwenden Sie eine andere Browser-Version, können die Schritte anders aussehen:

Für Netscape 4.7:

  1. Wählen Sie in Netscape Communicator Edit > Preferences (Editieren > Benutzervorgaben) aus.
  2. Erweitern Sie den Eintrag Advanced (Erweitert) im linken Teilfenster, indem Sie das +-Symbol links daneben anklicken.
  3. Wählen Sie den Eintrag Proxies neben Advanced (Erweitert) aus.
  4. Der rechte Rahmen sollte anzeigen, ob die automatische oder manuelle Proxy-Konfiguration verwendet wird oder ob eine Direktverbindung zum Internet besteht. Wird die manuelle Proxy-Konfiguration verwendet, fahren Sie mit dieser Gruppe von Schritten fort; wird sie nicht verwendet, fahren Sie nicht fort.
  5. Wählen Sie die Schaltfläche View (Anzeigen) neben Manual proxy configuration (Manuelle Proxy-Konfiguration) aus.
  6. Stellen Sie sicher, dass die Adressen localhost:49213 und 127.0.0.1 beide in der Liste der Proxy-Ausnahmen angezeigt werden. Stellen Sie außerdem sicher, dass sie durch ein Komma und nicht durch Semikolons voneinander getrennt sind. (Stellen Sie bei anderen Versionen von Netscape sicher, dass als Trennzeichen das im Dialog angegebene verwendet wird. Beispielsweise enthält der Dialog in Netscape 4.7 den Text Use commas (,) to separate entries (Verwenden Sie das Komma (,) als Trennzeichen).) Führen Sie die erforderlichen Änderungen durch und schließen Sie alle Dialoge, bis Sie zum Haupt-Browser-Fenster zurückkehren.

Für Internet Explorer 5.0:

  1. Wählen Sie im Internet Explorer Extras > Internetoptionen aus.
  2. Klicken Sie auf der Registerkarte Verbindungen die Schaltfläche LAN-Einstellungen an.
  3. Ist Proxyserver verwenden ausgewählt, fahren Sie mit dieser Gruppe von Schritten fort; ist diese Option nicht ausgewählt, fahren Sie nicht fort.
  4. Wird ein Markierungsfeld Proxyserver für lokale Adressen umgehen angezeigt, stellen Sie sicher, dass es ausgewählt ist.
  5. Wählen Sie Erweitert aus.
  6. Stellen Sie sicher, dass die Einträge localhost, localhost:49213 und 127.0.0.1 in der Liste der Proxy-Ausnahmen angezeigt werden, und stellen Sie sicher, dass Sie durch ein Semikolon und nicht durch ein Komma voneinander getrennt sind. Führen Sie die erforderlichen Änderungen durch und schließen Sie alle Dialoge, bis Sie zum Haupt-Browser-Fenster zurückkehren.

Sie sollten auch die Datei %SystemRoot%\system32\drivers\etc\hosts aktualisieren, indem Sie die folgende Zeile hinzufügen: 

127.0.0.1     localhost

sofern die Datei besteht, diese Zeile aber noch nicht vorhanden ist. Wenn Sie diesen Wert ändern, müssen Sie möglicherweise das Programm verlassen und Ihren Browser erneut starten, damit die Änderung wirksam wird.

Haben Sie alle Änderungen an der Browser-Konfiguration oder der Datei ...\etc\hosts durchgeführt, versuchen Sie erneut, die Hilfe-Homepage in Ihren Browser zu laden. Treten beim Herstellen der Verbindung zu localhost:49213 weiterhin Fehler auf, wenden Sie sich an die IBM Unterstützungsfunktion.

Ist der Zugriff auf Ihren automatisch konfigurierten Proxyserver nicht möglich, wenn Sie versuchen, die Hilfe anzuzeigen, kann Ihr Browser möglicherweise localhost nicht in die lokale Adresse 127.0.0.1 auflösen. Sie können dieses Problem vorübergehend beheben (während der Proxyserver nicht verfügbar ist), indem Sie in Schritt 4 (Netscape) oder Schritt 3 (Internet Explorer) zur Direktverbindung zum Internet wechseln.

4.0 Fehler "Datei nicht gefunden"

Erhalten Sie einen Fehler Datei nicht gefunden, wenn Sie versuchen, die Hilfe anzuzeigen oder eine Suche auszuführen, fehlt möglicherweise eine Datei im NetQuestion-Installationsverzeichnis. Lesen Sie die folgenden Abschnitte, um weitere Informationen zu erhalten.

4.1 Fehler "Datei nicht gefunden", wenn versucht wird, die Homepage oder andere Hilfe anzuzeigen

Erhalten Sie einen Fehler Datei nicht gefunden, wenn Sie versuchen, die Hilfe anzuzeigen, befindet sich die Datei vahwebx.exe wahrscheinlich nicht im NetQuestion-Installationsverzeichnis. Prüfen Sie das Verzeichnis in einer Eingabeaufforderung oder in Windows Explorer, um zu überprüfen, ob die Datei vorhanden ist. Ist dies der Fall, liegt wahrscheinlich ein Fehler bei der Konfiguration des lokalen Webservers in NetQuestion vor; möglicherweise zeigt httpd.cnf auf das falsche Verzeichnis. Siehe 3.2 HTTPDL.EXE ist falsch konfiguriert weiter oben. Fehlt die Datei vahwebx.exe, können Sie versuchen, einen oder mehrere der folgenden Schritte auszuführen:

Laden Sie die Browser-Seite erneut. Funktioniert die Hilfe jetzt, haben Sie den Fehler behoben. Erhalten Sie weiterhin einen Fehler Datei nicht gefunden, wenden Sie sich an die IBM Unterstützungsfunktion. Erhalten Sie die Nachricht Keine Hilfe für Produkt xxxxx registriert, lesen Sie unter 6.0 Hilfefunktion rekonfigurieren nach.

4.2 Fehler "Datei nicht gefunden", wenn versucht wird, eine Suche auszuführen

Erhalten Sie einen Fehler Datei nicht gefunden, wenn Sie versuchen, die Hilfe zu durchsuchen, ist das in Ihrem Suchformular angegebene Suchprogramm unter Umständen nicht an der korrekten Speicherposition installiert. Führen Sie diese Schritte aus, um den Namen und die Speicherposition zu bestimmen:

  1. Wählen Sie in Ihrem IBM Produkt Hilfe > Suchen aus, um das Suchformular in einem Browser-Fenster zu öffnen.
  2. Zeigen Sie in dem Browser die Quelle für das Suchformular an. Geben Sie dazu wie folgt vor:
  3. Suchen Sie in der Formularquelle nach der Zeichenfolge "action=". Es sollte eine ähnliche Zeile wie eine der folgenden angezeigt werden: 
    <form action="http://localhost:49213/cgi-bin/ivjsenus.exe"...>
<form action="http://localhost:49213/cgi-bin/va4sall.exe"...>

    Der Name des Suchprogramms ist der Teil des Attributs action= hinter "cgi-bin", das heißt in den oben stehenden Beispielen ivjsenus.exe oder va4sall.exe.

  4. Überprüfen Sie, ob sich diese Datei im NetQuestion-Installationsverzeichnis befindet. Ist dies der Fall und erhalten Sie bei der Suche weiterhin Fehler Datei nicht gefunden, lesen Sie unter 3.2 HTTPDL.EXE ist falsch konfiguriert weiter oben nach. Fehlt die Datei, können Sie sie gegebenenfalls von Ihrer Produkt-CD kopieren. Suchen Sie die Produkt-CD für dieses Suchprogramm. Ist sie vorhanden, kopieren Sie sie in das NetQuestion-Verzeichnis. Fordern Sie andernfalls eine Kopie über die IBM Unterstützungsfunktion an.

4.3 Andere Fehler bei der Suche, die fehlende Dateien angeben

Möglicherweise erhalten Sie auch beschädigte Images auf Ihrer Suchergebnisseite oder eine Nachricht Suchformular-Header nicht gefunden oder Suchformularfußzeile nicht gefunden. Die Ursache für diese Fehler sind andere Dateien, die in Ihrem NetQuestion-Installationsverzeichnis fehlen. Gegebenenfalls können Sie diese auf Ihrer Produkt-CD finden oder über die IBM Unterstützungsfunktion anfordern. Die Dateinamen sind alle in dem Suchformular angegeben. Sie können die Quelle für Ihr Suchformular anzeigen, um die Namen zu bestimmen. Suchen Sie nach den Parametern value= der folgenden verdeckten Eingabefelder: 

<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">

Die hervorgehobenen Einträge gelten für VisualAge für Java. Äquivalente Einträge für andere Produkt umfassen statt ivj:

5.0 Nachrichten "Interner Serverfehler"

Eine Nachricht Interner Serverfehler gibt normalerweise an, dass eine Anwendung, die auf dem Webserver ausgeführt wird, abgestürzt ist. Es ist auch möglich, dass ein Windows-Dialog mit dem Titel program.exe - Anwendungsfehler angezeigt wird und eine Nachricht, die mit Die Anweisung bei "0xnnnnnnnn" hat auf Speicher bei "0xnnnnnnnn" Bezug genommen beginnt. Wird dieser Dialog verlassen, indem Sie OK auswählen, zeigt der Browser die Nachricht Interner Serverfehler an.

Tritt dieser Fehler während einer Suchoperation auf, können Fehler in Ihren Produktsuchindizes vorliegen. Versuchen Sie, für Ihr Produkt die Hilfefunktion zu rekonfigurieren, und geben Sie dann die Suchabfrage erneut ein. Wird der Fehler damit nicht behoben, wenden Sie sich an die IBM Unterstützungsfunktion.

Tritt dieser Fehler beim normalen Durchsuchen der Hilfe auf, liegen möglicherweise Fehler mit Verzeichnisberechtigungen auf einem NTFS-Dateisystem vor. Melden Sie sich von Ihrem Windows NT- oder Windows 2000-System ab, melden Sie sich wieder als Administrator an und stellen Sie sicher, dass für alle Dateien und Ordner sowohl im NetQuestion-Installationsverzeichnis als auch im Verzeichnis für die Produkthilfe (abhängig von dem Produkt ist dies _INSTALL_DIR\doc oder INSTALL_DIR\help) die Sicherheitsberechtigungen auf Vollzugriff - Alle Rechte gesetzt sind. Gehen Sie dazu wie folgt vor:

  1. Starten Sie Windows Explorer und navigieren Sie zu dem Verzeichnis, das Sie überprüfen oder ändern möchten.
  2. Klicken Sie mit der rechten Maustaste den Verzeichnisnamen an.
  3. Wählen Sie Eigenschaften und dann Berechtigungen aus.
  4. Stellen Sie sicher, dass beide Kontrollkästchen (Berechtigungen für existierende Dateien ersetzen und Berechtigungen für Unterverzeichnisse ersetzen) ausgewählt sind.
  5. Fügen Sie einen Benutzereintrag für Jede hinzu, sofern keiner vorhanden ist, indem Sie Hinzufügen auswählen und die Anweisungen befolgen.
  6. Stellen Sie sicher, dass Jeder mindestens über den Zugriff Sonderzugriff (RX) (R) (R = Lesen, X = Ausführen) verfügt, oder dass die Zugriffsart auf Vollzugriff gesetzt ist.

Haben Sie Änderungen an Berechtigungen vorgenommen, schließen Sie diese Dialoge, und versuchen Sie, die Seite erneut zu laden. Mussten Sie keine Änderungen an Berechtigungen vornehmen oder bleiben die Fehler nach Durchführung der Änderungen bestehen, versuchen Sie, die Datei vahelp.cfg aus dem NetQuestion-Installationsverzeichnis zu löschen und dann für Ihr Produkt die Hilfefunktion zu rekonfigurieren.

Werden weiterhin Nachrichten Interner Serverfehler angezeigt, wenden Sie sich an die IBM Unterstützungsfunktion.

6.0 Hilfefunktion rekonfigurieren

Es kann vorkommen, dass die Hilfefunktion die Hilfe für ein bestimmtes Produkt falsch konfiguriert hat oder dass Sie einige Konfigurationsdaten löschen mussten, während Sie versucht haben, Fehler an einer Installation zu beheben. Sie können die Hilfe für Ihr Produkt rekonfigurieren, indem Sie die unten stehenden Anweisungen ausführen. Bevor Sie beginnen, muss Ihnen Folgendes bekannt sein:

Im Rahmen des ersten Teils dieses Prozesses müssen Sie bestimmen, ob die Hilfe bereits konfiguriert ist und nur aktualisiert werden muss. Um festzustellen, ob die Hilfe für Ihr Produkt konfiguriert ist, geben Sie Folgendes in eine Eingabeaufforderung ein: 

vahcfg list /f %IMNINSTSRV% | more

Es sollte eine Reihe von Produkten und Komponenten für jedes Produkt aufgelistet werden, für das die Hilfe konfiguriert wurde. Wird ein Produkt angezeigt, dessen Verzeichnis mit Ihrem Produktverzeichnis übereinstimmt, notieren Sie den Namen dieses Produkts. Umfasst die Ausgabe von vahcfg list beispielsweise Folgendes: 

Produkt: va400 (IBM WebSphere Development Tools für AS/400 - Hilfefunktion)
Verzeichnis mit Schreibzugriff: C:\Programmdateien\IBM\WDT400\help
Keine Aktualisierungsdateien für dieses Produkt
Komp.: qadtswin (WebSphere Development Tools für AS/400)
Zip-Datei: C:\Programmdateien\IBM\WDT400\help\qadtswin.zip
Index: va45uadt
...

Der Produktname ist va400. Wird ein Eintrag für Ihr Produkt angezeigt, können Sie die Hilfe mit dem Befehl vahcfg regen rekonfigurieren. Wird kein Eintrag für Ihr Produkt angezeigt, müssen Sie die Hilfe mit dem Befehl vahcfg install rekonfigurieren. Beide Befehle sind weiter hinten in diesem Abschnitt beschrieben.

6.1 Plattenspeicherplatz freigeben

Bevor Sie den Befehl vahcfg regen oder vahcfg install ausführen, sollten Sie außerdem sicherstellen, dass auf der Platte, auf der sich das Dokumentationsverzeichnis befindet, ausreichend freier Speicherbereich zur Verfügung steht, um die Suchindizes für die Produkthilfe aufzunehmen. Diese Indizes werden von dem Programm vahcfg aus den *.zip-Dateien in dem Dokumentationsverzeichnis extrahiert und in Unterverzeichnisse des Dokumentationsverzeichnisses geschrieben. Als Richtlinie wird empfohlen, mindestens so viel freien Speicherbereich auf der Platte verfügbar zu haben, wie Speicherbereich für die zip-Dateien in dem Dokumentationsverzeichnis benötigt wird.

6.2 Verwendung von vahcfg regen

Um vahcfg regen auszuführen, geben Sie den folgenden Befehl ein:

vahcfg regen /p Produktname /f %IMNINSTSRV%

Dabei ist Produktname der Produktname, den Sie beim Ausführen des Befehls vahcfg list notiert haben.

6.3 Verwendung von vahcfg install

Um vahcfg install auszuführen, geben Sie den folgenden Befehl ein: 

vahcfg install /w docdir /f %IMNINSTSRV%

Dabei ist docdir der vollständige Pfad zu dem Verzeichnis, das die Produkthilfedateien enthält. Enthält dieses Verzeichnis Leerzeichen in seinem Namen (z. B. c:\Programmdateien\IBM\VisualAge für Java..., schließen Sie den gesamten Verzeichnispfad in Anführungszeichen ein.

6.4 Nach der Ausführung von vahcfg install oder vahcfg regen

Versuchen Sie nach der Installation oder Neugenerierung (die unter Umständen mehrere Minuten dauert), die Hilfe erneut zu laden. Bleibt der Fehler, den Sie beheben wollten, bestehen, führen Sie die Schritte unter 6.5 Protokolldatei mit vahcfg regen oder vahcfg install erstellen aus, benachrichtigen Sie die IBM Unterstützungsfunktion und leiten Sie die Protokolldatei an die IBM Unterstützungsfunktion weiter.

6.5 Protokolldatei mit vahcfg regen oder vahcfg install erstellen

Hatten Sie versucht, die Hilfe für Ihr Produkt mit vahcfg regen oder vahcfg install erneut zu generieren bzw. zu installieren, und wurden Ihre Fehler in der Hilfefunktion durch diesen Versuch nicht behoben, führen Sie folgende Schritte aus, um eine Protokolldatei zu erstellen, mit der die IBM Unterstützungsfunktion Ihre Fehler genauer diagnostizieren kann:

  1. Setzen Sie in einer Eingabeaufforderung die Umgebungsvariable VAHCFG_LOG so, dass Sie auf eine neue Datei in einem Verzeichnis mit Schreibzugriff zeigt. Beispiel:
    SET VAHCFG_LOG=c:\config.log
  2. Hatten Sie versucht, vahcfg install auszuführen, und traten Fehler auf, führen Sie die beiden folgenden Befehle aus:
    vahcfg remove /p Produktname /f %IMNINSTSRV%
    vahcfg install /w docdir
  3. Hatten Sie versucht, vahcfg regen auszuführen, und traten Fehler auf, führen Sie den Befehl vahcfg regen erneut aus.

Die generierte Protokolldatei können Sie dann der IBM Unterstützungsfunktion zur Verfügung stellen.

Beachten Sie, dass einige frühere Versionen von vahcfg keine Protokolldatei erstellen. Versionen, die das Protokollieren nicht unterstützen, senden die gesamte Ausgabe an den Bildschirm; Versionen, die das Protokollieren unterstützen, drucken eine Nachricht, die angibt, wo die Daten protokolliert werden.

7.0 Zeitlimitprobleme bei der Suche

Die NetQuestion-Suchfunktion ist - außer bei sehr generischen Suchabfragen - beim Suchen nach Übereinstimmungen extrem schnell. Suchen Sie nach Übereinstimmungen für die Zeichenfolge a*, muss die Suchfunktion all Dokumente finden, die mindestens ein Wort enthalten, das mit dem Buchstaben a beginnt, was bedeutet, dass eine solche Suche immer länger dauert. Ist Ihre Suche jedoch spezifisch, können Sie Suchergebnisse nach maximal einigen wenigen Sekunden erwarten. Scheint eine Suche übermäßig lang zu dauern (beispielsweise mehr als 1 Minute), liegt möglicherweise ein Problem bei der Verwendung von Netscape Navigator 4.5 oder höher auf einem Windows 2000-System vor. (Dieses Problem kann auch auf einigen Windows NT-Systemen auftreten.)

Bei einigen Windows 2000-Maschinen liegt ein bekanntes Problem mit Netscape (Versionen 4.5 bis 4.74 und möglicherweise weitere Versionen) vor, das die Suche in der Onlinehilfefunktion extrem verlangsamt. Wird ein Formular in diesen Versionen von Netscape übergeben, verwendet die Netscape-Anwendung möglichst viele verfügbare Prozessorzyklen auf Ihrer Maschine, bis eine Antwort vom fernen System empfangen wird. (Sie können dies überprüfen, indem Sie die Seite für den Task-Manager von Windows während einer derartigen Suche öffnen, zu der Registerkarte "Prozesse" wechseln und die Spalte für die CPU-Nutzung anklicken. Liegt bei Ihnen das beschriebene Problem vor, wird netscape.exe am Anfang dieser Liste angezeigt und verwendet 97-99% der CPU-Zeit.)

Diese CPU-Nutzung ist in der Regel kein Problem, wenn eine ferne Suche (z. B. auf einer Website) ausgeführt wird. Da das Suchprogramm des Produkts jedoch auf Ihrer eigenen lokalen Maschine ausgeführt wird, bedeutet die Tatsache, dass Netscape so viel CPU-Zeit in Anspruch nimmt, dass nur sehr wenig CPU-Zeit für die Ausführung der Suche durch das Suchprogramm übrig bleibt. Demzufolge kann eine Suchaktion, die innerhalb einer Sekunde ein Ergebnis zurückgeben sollte, unter Windows 2000 mehrere Minuten dauern.

Dieses Leistungsproblem bei Windows 2000 können Sie verhindern, indem Sie nach jedem Übergeben einer Suchanforderung ein anderes Nicht-Netscape-Fenster auswählen. In der Regel hat dies zur Folge, dass Netscape nicht mehr übermäßig viele CPU-Zyklen verwendet, während auf eine Antwort gewartet wird, und Suchergebnisse werden normalerweise innerhalb einer Sekunde nach diesem Fensterwechsel angezeigt. Dieselbe Technik funktioniert unter Umständen auch unter Windows NT, wenn auch weniger konsistent.

Alternativ können Sie Microsoft Internet Explorer zum Anzeigen der Hilfe verwenden, da das Leistungsproblem bei diesem Browser nicht auftritt.

8.0 Stoppwörter oder rc=73

Sie können eine der folgenden Fehlernachrichten empfangen, wenn Sie von Ihrem Browser aus eine Suche in der Hilfefunktion ausführen:

Für diese Bedingung sind zwei Situationen denkbar:

Der Rückkehrcode 73 wird in der Regel nicht für eine Suchanforderung zurückgegeben, die wirklich leer ist, sondern nur für eine Suchanforderung, die ausschließlich aus Stoppwörtern besteht. Kann die Nachricht, die eine leere Suchanforderung angibt, problemlos reproduziert werden, wenn der Suchbegriff definitiv nicht leer ist (und es sich nicht um eine Suche handelt, bei der ausschließlich Stoppwörter angegeben wurden), ist möglicherweise Ihr Suchformular beschädigt. Lokalisieren Sie die Suchformulare hgssrch.htm und hgcsrch.htm im Verzeichnis für die Produkthilfe (in der Regel INSTALL_DIR\doc oder INSTALL_DIR\help) und stellen Sie diese Ihrem Ansprechpartner zur Verfügung, wenn Sie sich an die IBM Unterstützungsfunktion wenden.

9.0 Andere Fehler bei der Suche

Bei dem Versuch, eine Suche auszuführen, kann jede Nachricht einer Reihe von Fehlernachrichten angezeigt werden. Tritt einer der folgenden Fehler auf, versuchen Sie, die empfohlene Aktion auszuführen, bevor Sie die IBM Unterstützungsfunktion benachrichtigen.

9.1 Der angegebene NetQuestion-Server ist nicht verfügbar. (rc=33)

Ursache: Der Hilfe-Client konnte den Suchservice nicht starten (oder bei Component Broker ist der Suchservice nicht für den automatischen Start zur Anmeldezeit definiert). Dieser Fehler kann unabhängig davon auftreten, ob die Suche auf der lokalen Maschine (http://localhost:49213) oder auf einem fernen Hilfeserver erfolgt.

Empfohlene Aktion (lokale Hilfe):

Lesen Sie unter 3.1 HTTPDL.EXE ist nicht aktiv nach und lesen Sie dort speziell den Abschnitt über das Importieren der Registrierungsdatenbankeinträge zum automatischen Starten, so dass der Suchservice automatisch gestartet wird, wenn Sie sich anmelden. Als schnelle Möglichkeit zur Umgehung können Sie eine Eingabeaufforderung öffnen und Folgendes eingeben: 

imnss start server

Wird auf diesen Befehl ein Nachricht mit der folgenden Zeile zurückgegeben: 

Der Suchservice wurde gestartet.

sollten Sie die Suche ohne den Fehler mit rc=33 ausführen können.

Empfohlene Aktion (fern zur Verfügung gestellte Hilfe):

Der NetQuestion-Suchvorgang der Servermaschine ist möglicherweise nicht aktiv, da für die Maschine ein Warmstart ausgeführt wurde und derzeit niemand an der Maschine angemeldet ist. Siehe 14.0 NetQuestion-Suchservice zur Boot-Zeit starten.

9.2 Kein Ziel für Suche angegeben

Ursache: Das Suchprogramm hat keine gültigen Indexnamen in der Suchanforderung empfangen. Möglicherweise wurde das Suchformular beschädigt oder die angegebenen Indizes sind nicht mehr registriert oder es liegt ein Fehler in der NetQuestion-Installation vor.

Empfohlene Aktion: Löschen Sie zunächst alle hg*.htm-Dateien aus dem Verzeichnis für die Produkthilfe (INSTALL_DIR\doc oder INSTALL_DIR\help). Versuchen Sie dann, für Ihr Produkt die Hilfe zu rekonfigurieren. Bleibt der Fehler bestehen, müssen Sie möglicherweise NetQuestion erneut installieren und dann die Hilfe für Ihr Produkt rekonfigurieren.

9.3 Suchformular-Header nicht gefunden | Suchformularfußzeile nicht gefunden

Ursache: Das Suchformular hat einen Suchformular-Header oder eine Suchformularfußzeile (eine Datei, die ein HTML-Fragment enthält, das über oder unter Suchergebnissen eingefügt werden soll) angegeben, der bzw. die nicht vorhanden ist.

Empfohlene Aktion: Unter 4.2 Fehler "Datei nicht gefunden", wenn versucht wird, eine Suche auszuführen befinden sich weitere Informationen.

9.4 Abfrage zu komplex. Suchanforderung neu formulieren. (rc=22)

 Ursache: Sie haben eine Suchabfrage eingegeben, die zu viele Wortübereinstimmungen zurückgibt. Die Suchmaschine kann eine Abfrage, die Übereinstimmungen für mehr als 1024 unterschiedliche Wörter enthält, nicht bearbeiten. Geben Sie beispielsweise den Suchbegriff "a* b* c* d*" (ohne die Anführungszeichen) ein, fordern Sie alle Dokumente an, die Wörter enthalten, die mit einem der Buchstaben a, b, c oder d beginnen. Da so viele Wörter mit diesen Suchkriterien übereinstimmen, kann die Suchmaschine keine sinnvolle sortierte Liste der gefundenen Suchbegriffe erstellen und versucht dies auch erst gar nicht.

Empfohlene Aktion: Geben Sie eine Suchanforderung ein, die weniger gefundene Suchbegriffe zurückgibt.

9.5 Die angegebene Bedingung ist ungültig

Ursache: Sie haben eine Suchabfrage eingegeben, die logisch nicht gültig ist. Beispielsweise wird eine Suchabfrage "-java" (alle Dokumente anzeigen, die nicht das Wort java enthalten) nicht als gültig betrachtet.

Empfohlene Aktion: Geben Sie eine Suchanforderung ein, die mindestens einen zulässigen Begriff enthält.

9.6 Die NetQuestion-Konfigurationsdatei (NETQ.CFG) ist fehlerhaft oder wurde nicht gefunden. (rc=77)

Ursache: Dieser Fehler kann auftreten, wenn das Suchprogramm Umgebungsvariablen, die für eine erfolgreiche Suchoperation erforderlich sind, nicht lesen kann. Haben Sie die Hilfe für die Ausführung auf einem anderen Webserver als den HTTPDL.EXE-Webserver von NetQuestion konfiguriert, müssen Sie unter Umständen die Webservereinstellungen ändern, um sicherzustellen, dass bestimmte Umgebungsvariablen für die Such-CGI (das Programm, das mit dem Parameter "action=" des Befehls <form> in dem Suchformular aufgerufen wird) sichtbar sind. Auf einigen Webservern sind Systemumgebungsvariablen standardmäßig verdeckt. Die Variablen, für die die Such-CGI Zugriff benötigt, sind IMNINSTSRV und IMNINST. Netscape Enterprise Server ist ein Beispiel für einen Webserver, der Umgebungsvariablen standardmäßig verdeckt.

Empfohlene Aktion: Ändern Sie Ihre Webservereinstellungen, um entweder diese Umgebungsvariablen manuell in Webserver-CGI-Anwendungen zu exportieren oder um alle lokalen Umgebungsvariablen für CGIs sichtbar zu machen. Führen Sie dazu auf Netscape Enterprise Server (NES) diese Schritte aus:

  1. Öffnen Sie x:\Netscape_Enterprise_Server-Verzeichnis\https-Servername\config\obj.conf; dabei ist Netscape_Enterprise_Server-Verzeichnis das Verzeichnis, in dem Sie NES installiert haben und Servername der Name des Hilfeservers, der während der Installation von NES angegeben wurde.
  2. Sie müssen die Werte der NetQuestion-Umgebungsvariablen bestimmen. Geben Sie in eine Eingabeaufforderung Folgendes ein: 
    set imn

    Das System sollte Einstellungen für die Variablen IMNINST und IMNINSTSRV zurückgeben, wie beispielsweise: 

    IMNINST=help
IMNINSTSRV=C:\IMNNQ_NT
  3. Fügen Sie, abhängig von den oben stehenden Ergebnissen, direkt unter den anderen Zeilen, die mit einer Anweisung "Init" beginnen, obj.conf die folgenden Zeilen hinzu. Stellen Sie sicher, dass Sie nur SCHRÄGSTRICHE (/) verwenden, wenn Sie den Pfad für IMNINSTSRV hinzufügen: 
    Init fn="init-cgi" IMNINSTSRV=c:/imnnq_nt
Init fn="init-cgi" IMNINST=help
  4. Stoppen Sie Netscape Enterprise Server. Wird die folgende Warnung angezeigt:

    "WARNUNG: Die Konfigurationsdatei wurde u. U. manuell editiert. Verwenden Sie diese Schaltfläche, um die neuesten Konfigurationsdateien zu laden."

    klicken Sie Konfigurationsdateien laden an.

  5. Starten Sie Netscape Enterprise Server.
  6. Wiederholen Sie die Suche.

Ziehen Sie bei anderen Webservern die Webserverdokumentation zu Rate, um zu bestimmen, wie Umgebungsvariablen für CGI-Anwendungen sichtbar gemacht werden.

9.7 Andere NETQ.CFG-Fehler oder rc=32

Ursache: Ein Fehler mit rc=32 oder ein Fehler, der die Datei NETQ.CFG angibt, tritt auf, wenn NetQuestion nicht korrekt auf einen Produktindex zugreifen kann. Dieser Fehler kann auftreten, wenn die NetQuestion-Installation oder ein bestimmter Index beschädigt wurde, oder er kann nur bei der ersten Suche auftreten, die Sie für einen bestimmten Index nach einem Warmstart ausführen. Beachten Sie, dass - obwohl die Nachricht in einigen Fällen für diesen Fehler die Datei NETQ.CFG erwähnt - diese Datei eigentlich nicht vorhanden ist; der Fehler bezieht sich auf Probleme mit anderen NetQuestion-Indexkonfigurationsdateien.

Empfohlene Aktion: Bestimmen Sie die wahrscheinliche Ursache für den Fehler und korrigieren Sie den Fehler wie nachfolgend beschrieben:

9.8 Indexrücksetzung oder Fehler mit rc=76

Wird auf eine Suche eine Fehlernachricht mit rc=76 zurückgegeben, müssen möglicherweise ein oder mehrere Ihrer Suchindizes zurückgesetzt werden. Führen Sie diese Schritte aus, um Ihre Indizes zurückzusetzen:

  1. Zeigen Sie die Quelle für das Suchformular in Ihrem Browser an. Suchen Sie nach allen Zeilen, die den HTML-Befehl <input type=hidden name=indexname value=ixname> enthalten.
  2. Geben Sie für jeden Wert ixname den folgenden Befehl in die Eingabeaufforderung ein:
    nqreset ixname
  3. Wiederholen Sie die Suche, nachdem Sie alle betroffenen Indizes zurückgesetzt haben. Bleibt der Fehler bei der Suche bestehen oder tritt er später erneut auf, wenden Sie sich an die IBM Unterstützungsfunktion.

10.0 NetQuestion erneut installieren

In einigen Situationen besteht die einzige Möglichkeit, eine korrekte Funktionsweise der Hilfe zu erzielen darin, NetQuestion zu deinstallieren und dann erneut zu installieren und anschließend die Hilfe für Produkte, die die VisualAge-Hilfefunktion verwenden, zu rekonfigurieren. Beachten Sie, dass beim Deinstallieren von NetQuestion möglicherweise Suchindizes entfernt werden, die von Produkten, wie beispielsweise IBM DB2, verwendet werden, die nicht die VisualAge-Hilfefunktion verwenden, und daher nach dem erneuten Installieren von NetQuestion die Suche in der Hilfe für diese Produkte verhindern können. Unter Umständen müssen Sie das betreffende Produkt erneut installieren, um seine Suchindizes wiederherzustellen.

Geben Sie in den nachfolgenden Anweisungen alle Befehle von einer Eingabeaufforderung aus ein. Bevor Sie beginnen, müssen Sie das NetQuestion-Installationsverzeichnis bestimmen.

10.1 vahcfg remove für alle aufgelisteten Produkte ausführen

Das NetQuestion-Deinstallationsprogramm uninstnq.exe im NetQuestion-Verzeichnis entfernt NetQuestion nur, wenn keine Indizes registriert sind. Sie können zunächst alle Indizes entfernen, die von Produkten registriert sind, die die IBM VisualAge-Hilfefunktion verwenden, indem Sie den Befehl vahcfg remove für jedes dieser Produkte eingeben. Führen Sie diese Schritte aus:

  1. Führen Sie den Befehl vahcfg list /f %IMNINSTSRV% | more aus und notieren Sie sich jeden Produktnamen (wie unter 6.0 Hilfefunktion rekonfigurieren beschrieben).
  2. Führen Sie für jeden Produktnamen den Befehl vahcfg remove /p Produktname /f %IMNINSTSRV% aus.

10.2 Alle verbleibenden Indizes entfernen

Nach dem Entfernen all dieser Produkte können Sie prüfen, ob noch Indizes für andere Produkte registriert sind, indem Sie den folgenden Befehl eingeben: 

imnixlst

Enthält die daraufhin angezeigte Liste Einträge, die mit DB2, CXX oder VAC beginnen, sind wahrscheinlich Indizes für Produkte wie DB2, IBM C- und C++-Compiler oder VisualAge C++ 4.0 registriert, die nicht die VisualAge-Hilfefunktion verwenden. Setzen Sie die manuelle Deinstallation von NetQuestion fort, gehen diese Indizes verloren und Sie müssen unter Umständen die entsprechenden Produkte erneut installieren, um die Hilfe für diese Produkte wieder durchsuchen zu können. Sind derartige Indizes immer noch aufgelistet und akzeptieren Sie, dass Suchfähigkeiten für diese Produkte verloren gehen können oder dass diese Produkte erneut installiert werden müssen, können Sie wie folgt das Löschen der verbleibenden Indizes fortsetzen:

Sind Indizes aufgelistet, deren Namen mit IVJ3, VJ32, IWZ oder VA45 beginnen, können Sie gefahrlos gelöscht werden, da Sie später mit vahcfg install wiederhergestellt werden können.

Können Sie wegen eines NetQuestion-Fehlers nicht alle verbleibenden Indizes löschen, müssen Sie NetQuestion manuell entfernen (siehe Abschnitt 11.4 weiter unten).

10.3 uninstnq ausführen

Geben Sie den Befehl uninstnq ein und warten Sie einige Minuten, bis das NetQuestion-Verzeichnis fast leer ist. Das Verzeichnis sollte keine Dateien enthalten, die mit imn* oder imq* beginnen. Unter Umständen müssen Sie bis zu zehn Minuten warten, bis dieser Vorgang beendet ist. Enthält das Verzeichnis nach zehn Minuten immer noch Dateien, die mit imn* oder imq* beginnen, sind möglicherweise noch Indizes vorhanden, die für den Suchservice registriert sind (kehren Sie in diesem Fall zu Abschnitt 11.2 zurück), oder die NetQuestion-Installation ist unter Umständen beschädigt (fahren Sie mit Abschnitt 11.4 fort). Führen Sie andernfalls einen Warmstart aus und fahren Sie mit Abschnitt 11.5 fort.

10.4 NetQuestion manuell entfernen

Können Sie NetQuestion nicht mit der uninstnq.exe entfernen, können Sie NetQuestion wie folgt manuell entfernen:

  1. Führen Sie das Programm regedit von einer Eingabeaufforderung oder über Start > Ausführen aus.
  2. Erweitern Sie den Eintrag HKEY_LOCAL_MACHINE\Software\IBM in der Registrierungsdatenbank.
  3. Löschen Sie den Eintrag NetQuestion und alle untergeordneten Einträge.
  4. Entfernen Sie den NetQuestion-Verzeichnisnamen aus der Umgebungsvariablen PATH.
  5. Entfernen Sie die Umgebungsvariable IMNINSTSRV.
  6. Löschen Sie alle Dateien aus dem NetQuestion-Verzeichnis, die diesen Platzhalterzeichenangaben entsprechen, indem Sie den folgenden Befehl in eine Eingabeaufforderung eingeben, wenn dieses Verzeichnis das aktuelle Verzeichnis ist:
    del http*.* 302.* 404.* 500.* im*.* nq*.*
  7. Löschen Sie das Unterverzeichnis "instance" aus Explorer oder löschen Sie es durch Eingabe des folgenden Befehls:
    rmdir /s /q instance
  8. Führen Sie einen Warmstart aus.

Um Umgebungsvariablen zu ändern oder zu entfernen, führen Sie die nachfolgenden plattformspezifischen Schritte aus:

10.5 Reinstallation von NetQuestion

Um NetQuestion erneut zu installieren, benötigen Sie Ihre Produkt-CD oder eine NetQuestion-Installations-zip-Datei von der IBM Unterstützungsfunktion. Die folgenden Produkte enthalten eine installierbare Kopie von NetQuestion auf ihrer Produkt-CD:

Bei anderen Produkten können Sie bestimmen, ob eine installierbare Kopie von NetQuestion auf der CD vorhanden ist, indem Sie nach einer Datei mit dem Namen ntq_sbcs.iss suchen. Das Verzeichnis, das diese Datei enthält, sollte eine Datei setup.exe enthalten, mit der die NetQuestion-Installation gestartet werden kann.

Erhalten Sie eine Installations-zip-Datei von IBM, entzippen Sie diese in ein temporäres Verzeichnis.

Nachdem eine installierbare Kopie von NetQuestion verfügbar ist, führen Sie diese Schritte aus:

  1. Starten Sie setup.exe, indem Sie die Datei in Explorer doppelt anklicken, oder indem Sie eine Eingabeaufforderung öffnen, in das Verzeichnis wechseln, das den NetQuestion-Installationscode enthält, und setup eingeben.
  2. Wählen Sie eine vollständige Installation aus.
  3. Überschreiben Sie das Standardverzeichnis, um auf das Verzeichnis zu zeigen, in dem NetQuestion zuvor installiert war. Wenn Sie das Standardverzeichnis überschreiben und auf ein neues Verzeichnis zeigen, stellen Sie sicher, dass der Name maximal 8 Zeichen umfasst, keine Leerzeichen enthält und sich auf der Stammverzeichnisebene eines Laufwerks befindet. Dies verringert die Wahrscheinlichkeit, dass später Fehler in der Hilfefunktion auftreten.
  4. Führen Sie einen Warmstart aus, nachdem die Installation abgeschlossen ist.
  5. Sind die alten und die neuen NetQuestion-Verzeichnisse unterschiedlich, kopieren Sie den Header und die Fußzeile für das Suchformular, die .gif-Dateien, das Suchprogramm und die Dateien für die Hilfefunktion (vah*.exe, vahwebx.cat) aus dem alten Verzeichnis in das neue Verzeichnis. Informationen zu diesen Dateien befinden sich unter 4.0 Fehler "Datei nicht gefunden".

10.6 Hilfe für installierte Produkte rekonfigurieren

Führen Sie für jedes Produkt, das Sie manuell aus der Hilfefunktion entfernt haben (mit vahcfg remove, siehe Abschnitt 11.1), vahcfg install aus (wie unter 6.0 Hilfefunktion rekonfigurieren beschrieben). Sie sollten jetzt Ihre Produkthilfe anzeigen und durchsuchen können. Bleiben Fehler bestehen, prüfen Sie andere Abschnitte dieses Dokuments auf mögliche Lösungen oder wenden Sie sich an die IBM Unterstützungsfunktion.

11.0 Symbol zum Starten der Produkthilfe erstellen

Können Sie die Hilfe von der Benutzerschnittstelle Ihres Produkts aus nicht starten, können Sie ein Symbol erstellen, um die Hilfe durch Doppelklicken auf das Symbol zu starten (so dass Sie zumindest die Hilfefunktion verwenden können, während Sie an der Lösung Ihres Problems arbeiten).

Anmerkungen

  1. Bei Component Broker enthält das Menü "Start" bereits einen Eintrag für die Component Broker-Onlinebibliothek zum Starten der Produkthilfe; die Informationen in diesem Abschnitt sind damit nicht zutreffend.
  2. Bei WebSphere Development Tools für AS/400 enthält das Menü "Start" bereits eine Reihe von Einträgen zum Starten der Produkthilfe (Start - Programmdateien - IBM WebSphere Development Tools für AS/400 - Dokumentation), Sie können aber auch Ihr eigenes Desktop-Symbol mit der unten beschriebenen Methode erstellen.
  3. Bei VisualAge TPF für Windows NT enthält das Menü "Start" auf Workstations, auf denen die Hilfe lokal installiert ist, bereits einen Eintrag zum Starten der Produkthilfe. Führen Sie diese Schritte nur aus, wenn Sie sich dafür entschieden haben, über den fernen Zugriff auf die Hilfe zuzugreifen, oder wenn Sie das Symbol Ihrem Desktop hinzufügen möchten, während gleichzeitig die Auswahl im Menü "Start" verfügbar sein soll.

Sie können eine Verknüpfung zum Starten der Produkthilfe erstellen, indem Sie folgende Schritte ausführen:

  1. Klicken Sie in der Task-Leiste mit der rechten Maustaste und wählen Sie Alle Fenster minimieren aus.
  2. Klicken Sie auf einer leeren Stelle auf dem Desktop mit der rechten Maustaste und wählen Sie Neu - Verknüpfung aus.
  3. Klicken Sie im Dialog Verknüpfung erstellen die Schaltfläche Durchsuchen an, um das Produktinstallationsverzeichnis zu lokalisieren.
  4. Suchen Sie in diesem Verzeichnis oder in einem der zugehörigen Unterverzeichnisse nach der Datei vahelp.exe. Bei VisualAge für Java befindet sich die Datei im Verzeichnis eab\bin.
  5. Klicken Sie die Datei vahelp.exe doppelt an. Im Dialog Verknüpfung erstellen sollte der Eingabebereich Befehlszeile jetzt den vollständigen Pfad (in Anführungszeichen, sofern der Pfad Leerzeichen enthält) zu vahelp.exe zeigen.
  6. Editieren Sie den Eingabebereich Befehlszeile und fügen Sie am Ende der Zeile (einschließlich eines führenden Leerzeichens) Folgendes hinzu: 
    instance "INSTALL_DIR\DOC_DIR\CONFIG_FILE" open index.htm

    Dabei ist INSTALL_DIR das Verzeichnis, in dem das Produkt installiert ist, DOC_DIR ist in der Regel doc oder help und CONFIG_FILE ist der Name der Konfigurationsdatei für die Produkthilfe (ivjhlp.cfg für VisualAge für Java; Informationen über das Bestimmen der Namen der Verzeichnisse und Konfigurationsdateien für andere Produkte befinden sich unter 2.0 Nichts geschieht, wenn versucht wird, die Hilfe zu starten). Stellen Sie sicher, dass der vollständige Pfad für die Konfigurationsdatei in Anführungszeichen eingeschlossen ist, wenn dieser Pfad Leerzeichen enthält.

  7. Klicken Sie Weiter an.
  8. Geben Sie einen Namen für die Verknüpfung ein, beispielsweise "IBM VisualAge für Java-Onlinehilfe".
  9. Klicken Sie Fertig stellen an.
  10. Klicken Sie die erstellte Verknüpfung auf dem Desktop doppelt an, um sicherzustellen, dass sie funktioniert.
  11. Um die Darstellung des Verknüpfungssymbols zu ändern, klicken Sie mit der rechten Maustaste die Verknüpfung an und wählen Sie Eigenschaften, dann die Registerkarte Verknüpfung und schließlich Anderes Symbol aus und durchsuchen Sie die Liste der verfügbaren Symbole oder Ihr Dateisystem nach einem neuen Symbol.

Sie können das erstellte Symbol dem Menü "Start" hinzufügen, indem Sie das Symbol mit der rechten Maustaste anklicken, Kopieren im Kontextmenü auswählen, dann in Windows Explorer bis zum Windows-Installationsverzeichnis unter ...\Profiles\All Users\Startmenü navigieren und das Symbol in dieses Verzeichnis oder ein entsprechendes Unterverzeichnis dieses Verzeichnisses einfügen.

12.0 Hilfefunktion auf einem Windows-Server konfigurieren

Sie können die Hilfefunktion auf einem Windows NT- oder Windows 2000-Webserver installieren und konfigurieren, so dass andere Mitarbeiter Ihres Unternehmens die Onlinehilfe über ein Netz anzeigen und durchsuchen können, ohne den auf ihren Workstations installierten Code von NetQuestion und der Hilfefunktion verwenden zu müssen.

Produkthinweise

  1. Bei VisualAge COBOL und VisualAge TPF können Benutzer angeben, dass NetQuestion oder die Hilfefunktion nicht lokal installiert werden soll. Bei anderen Produkten können Benutzer die lokalen Kopien entfernen, indem Sie einfach die Schritte zum Entfernen in den Abschnitten 6.0 Hilfefunktion rekonfigurieren und 10.0 NetQuestion erneut installieren ausführen.
  2. Bei VisualAge TPF wird das Produkt mit integrierten Dienstprogrammen zur Konfiguration der Hilfe für den Server ausgeliefert. Erfolgt die Installation mit Hilfe der setup.exe auf der Produkt-CD, werden Sie aufgefordert anzugeben, ob von anderen Benutzern in dem Netz ein ferner Zugriff auf die Hilfe erfolgt. Antworten Sie mit Ja. Haben Sie das Hilfepaket vom Web heruntergeladen, führen Sie insthelp.exe aus.

Zur Ausführung dieser Netzinstallation muss auf dem Server eine Webserversoftware, wie beispielsweise Microsoft Peer Web Services (PWS) oder Microsoft IIS, installiert sein. Auf dem Webserver sollte ein Verzeichnis scripts vorhanden sein. (Bei PWS und IIS befindet sich das Verzeichnis scripts in der Regel unter x:\inetpub.) Führen Sie nach dem Installieren der Serversoftware die folgenden Schritte aus:

  1. Installieren Sie das IBM Softwareprodukt auf dem Server.
  2. Kopieren Sie die folgenden Dateien aus dem NetQuestion-Verzeichnis in das Verzeichnis x:\inetpub\scripts, sofern Sie in dem NetQuestion-Verzeichnis vorhanden sind: 
    vahwebx.exe
vahwebx.cat
vahelp.cfg
*foot.htm
*head.htm
*henus.htm

    Die ersten drei Dateien sind erforderlich; nachfolgende Dateien sollten, falls vorhanden, kopiert werden, fehlen Sie jedoch im NetQuestion-Verzeichnis, besteht keine Notwendigkeit, sie in das Verzeichnis x:\inetpub\scripts zu kopieren.

  3. Editieren Sie die Datei imnmap.dat, die sich im Verzeichnis %IMNINSTSRV%\instance\help\data\ befindet. Diese Datei enthält den Anfangsteil der Web-Adresse für jeden Index. Ändern Sie alle Vorkommen der Unterzeichenfolge http://localhost:49213/cgi-bin in http://server.city.domain.organization/scripts (wie beispielsweise http://cobweb.stl.ibm.com/scripts). Diese Änderung bewirkt, dass die Links, die für gefundene Suchbegriffe generiert werden, eine ferne (nicht localhost) Web-Adresse zur Folge haben, so dass ein Benutzer den Links von jedem Computer aus folgen kann.
  4. Editieren Sie die folgenden Dateien, die in dem Verzeichnis, in dem die Hilfe für das Produkt gespeichert ist, erstellt wurden: hgssrch.htm und hgcsrch.htm. Ändern Sie http://localhost:49213/cgi-bin in http://server.city.domain.organization/scripts.
  5. Kopieren Sie die in den Suchformularen angegebene Such-CGI (z. B. iwzihenes.exe, ivjsenus.exe, va4sall.exe) aus dem NetQuestion-Verzeichnis in das Verzeichnis x:\inetpub\scripts.
  6. Kopieren Sie *star*.gif in ein neues Unterverzeichnis icons unter dem Verzeichnis x:\inetpub\wwwroot.
  7. Ändern Sie bei Component Broker die Einstellung der Umgebungsvariablen VABHELP von http://localhost:49213/cgi-bin in http://server.city.domain.organization/scripts. Bei anderen Produkten als Component Broker muss jeder Benutzer seine Produktkonfigurationsdatei (*.cfg in seinem Verzeichnis für die Produkthilfe) editieren und die folgenden Einträge in die angegebenen Werte ändern: 
    HTML_HOSTNAME=server.city.domain.organization
CGI_BIN_DIR=scripts
START_LITE_DAEMON=0
START_NETQ_DAEMON=0

Benutzer sollten dann auf die serverbasierte Hilfe zugreifen können, indem Sie einfach F1 drücken oder einen Hilfemenüpunkt in ihrer IBM Anwendung auswählen. Oder Sie können mit folgender URL auf die Hilfe zugreifen:

http://IhrHost/scripts/vahwebx.exe/help/Produktname/Extract/0/index.htm

Dabei ist Produktname:

Führen Sie später vahcfg install oder vahcfg regen auf dem Serversystem aus, müssen Sie die Zuordnungsdatei aus Schritt 3 oben erneut editieren.

Nachdem die Benutzer ihre Konfigurationsdateien für die Produkthilfe so geändert haben, dass sie auf den Server zeigen, können Sie gefahrlos den folgenden Befehl ausführen, um alle *.toc-, *.htm- und *.zip-Dateien sowie Suchindexdateien aus ihrem Verzeichnis für die Produkthilfe zu löschen: 

vahcfg remove /p Produktname /f %IMNINSTSRV%

Oder Sie können einfach die *.toc-, *.htm- und *.zip-Dateien manuell löschen. Mit dieser Methode werden jedoch nicht die Indexverzeichnisse unter dem Verzeichnis für die Produkthilfe gelöscht, so dass auch diese manuell gelöscht werden müssen.

13.0 NetQuestion-Server automatisch starten

Lesen Sie statt dieses Abschnitts unter 14.0 NetQuestion-Suchservice zur Boot-Zeit starten nach, wenn Sie den Server in einer Netzhilfekonfiguration konfigurieren.

Sie können die HTTP- und Suchserver für den automatischen Start bei der Anmeldung definieren, indem Sie zwei Einträge in der Registrierungsdatenbank auf Ihrem System definieren. Um diese Einträge zu definieren, führen Sie diese Schritte aus:

  1. Erstellen Sie eine Datei mit dem Namen NetQuestionAutoStart.reg mit Hilfe eines Texteditors, wie beispielsweise NOTEPAD. Geben Sie den folgenden Text ein (verwenden Sie Kopieren und Einfügen): 
    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. Ändern Sie die Zeichenfolge %IMNINSTSRV% in Ihrer Version in den Wert des NetQuestion-Installationsverzeichnisses.
  3. Sichern Sie die Datei.
  4. Klicken Sie NetQuestionAutoStart.reg in Windows Explorer doppelt an.

Damit werden zwei Einträge in Ihre Registrierungsdatenbank importiert, so dass bei der nächsten Anmeldung (oder beim Warmstart unter Windows 95 oder Windows 98) die Server automatisch gestartet werden sollten.

14.0 NetQuestion-Suchservice zur Boot-Zeit starten

Verwenden Sie eine Netzhilfekonfiguration, bei der die Hilfe von einem Server und nicht von Ihrer eigenen Maschine zur Verfügung gestellt wird, können Fehler beim Ausführen der Suche auf der fernen Maschine auftreten. Ist der Suchdämon von NetQuestion für den automatischen Start definiert (während der Produktinstallation oder durch Ausführen der Schritte unter 13.0 NetQuestion-Server automatisch starten), startet der Dämon erst, wenn sich ein Benutzer bei der Servermaschine anmeldet. Das heißt, nach einem Warmstart für das System und vor dem ersten Anmelden des Benutzers der Maschine ist der Suchdämon nicht aktiv. Sie können jedoch den Suchdämon zur Boot-Zeit mit Hilfe von Windows Task Scheduler starten. Die Anweisungen in diesem Abschnitt gelten für die Maschine, die die Hilfe zur Verfügung stellt.

Anmerkung: Verwenden Sie keine Netzhilfekonfiguration, ist es nicht erforderlich, die Schritte in diesem Abschnitt auszuführen.

Bevor Sie beginnen, sollten Sie das NetQuestion-Installationsverzeichnis bestimmen. Unter Umständen möchten Sie auch eine gewisse manuelle Bereinigung in der Registrierungsdatenbank ausführen. Ihre Registrierungsdatenbank enthält möglicherweise Einträge zum Starten des NetQuestion-Suchdämons zur Anmeldezeit. Soll der Dämon zur Boot-Zeit gestartet werden, ist der Eintrag in der Registrierungsdatenbank unnötig. Um die Registrierungsdatenbank zu bereinigen, gehen Sie wie folgt vor:

  1. Wählen Sie im Menü "Start" Ausführen aus.
  2. Geben Sie regedit ein und klicken Sie OK an.
  3. Folgen Sie der Baumstruktur bis zu HKEY_LOCAL_MACHINE - SOFTWARE - Microsoft - Windows - CurrentVersion - Run.
  4. Wählen Sie im rechten Teilfenster für den Ordner "Run" den folgenden Schlüssel aus und löschen Sie diesen:
  5. Sie können auch den Eintrag für das automatische Starten des NetQuestion-HTTP-Servers entfernen, wenn Sie auf der Servermaschine nicht direkt auf die Hilfe zugreifen werden. Wählen Sie dazu den folgenden Schlüssel aus und löschen Sie diesen:
  6. Schließen Sie den Registrierungseditor.

Jetzt können Sie Windows anweisen, die Server zur Boot-Zeit zu starten. Prüfen Sie zunächst, ob der Microsoft Windows Task Scheduler auf der Maschine installiert ist, die als Hilfeserver agiert:

  1. Öffnen Sie Windows Explorer oder NT Explorer.
  2. Prüfen Sie die Teilordner des Ordners "Arbeitsplatz". Wird zusammen mit Ihren lokalen Laufwerken und Netzlaufwerken ein Ordner mit dem Namen "Geplante Vorgänge" angezeigt, ist Task Scheduler auf Ihrer Maschine installiert. Fahren Sie mit Schritt 5 fort.
  3. Ist Task Scheduler auf Ihrer Maschine nicht installiert, müssen Sie Task Scheduler installieren. Task Scheduler ist mit Internet Explorer kombiniert. Dieses Programm befindet sich in der Kategorie "Zusätzliche Explorer-Erweiterungen" und ist eine zusätzliche Komponente, die Sie installieren müssen. Die Methode zum Hinzufügen von Komponenten zu Internet Explorer ist von Ihrer Internet Explorer-Version und Ihrer verwendeten Windows-Version abhängig. Das Dokument "How to Add and Remove Internet Explorer Components" (Vorgehensweise beim Hinzufügen und Entfernen von Internet Explorer-Komponenten) unter http://support.microsoft.com/support/kb/articles/Q171/2/29.ASP enthält weitere Details.
  4. Nachdem Sie Task Scheduler installiert haben, führen Sie, wenn aufgefordert, einen Warmstart aus und öffnen Sie "Arbeitsplatz".

Um den NetQuestion-Suchserver zum Starten zur Boot-Zeit auf dem Hilfeserver zu definieren, gehen Sie wie folgt vor:

  1. Klicken Sie im Ordner "Geplante Vorgänge" Geplanten Task hinzufügen an.
  2. Der Assistent für geplante Tasks wird geöffnet. Klicken Sie Weiter an, um fortzufahren.
  3. Wählen Sie ein beliebiges Programm aus der Liste aus (es wird zu einem späteren Zeitpunkt geändert) und klicken Sie Weiter an.
  4. Ordnen Sie Ihrer Task einen Namen zu. Geben Sie beispielsweise "NetQuestion-Suchserver" ein.
  5. Wählen Sie die Option Beim Starten des Computers aus und klicken Sie Weiter an.
  6. Geben Sie den Benutzernamen des Benutzers ein, der Eigner des Prozesses sein soll (beispielsweise der Serveradministrator) und geben Sie - wie angefordert - das zugehörige Kennwort ein. Klicken Sie Weiter an.
  7. Wählen Sie das Kontrollkästchen Weitere Eigenschaften für diesen Task beim Klicken auf "Fertig stellen" öffnen aus.
  8. Klicken Sie Fertig stellen an.
  9. Die Seite mit den Eigenschaften für "NetQuestion-Suchserver" wird geöffnet. Ändern Sie auf der Registerkarte "Task" das Feld Starten in NQ_DIR\imnss.exe start server.
    Dabei ist NQ_DIR das NetQuestion-Installationsverzeichnis.
  10. Geben Sie in das Feld Ausführen in das NetQuestion-Installationsverzeichnis ein.
  11. Stellen Sie sicher, dass das Kontrollkästchen Aktiviert ausgewählt ist.
  12. Wählen Sie auf der Registerkarte Einstellungen die Option Task beenden nach xxx Stunde(n) und xxx Minute(n) aus.

Anmerkung: Nachdem für die Hilfeservermaschine ein Warmstart ausgeführt wurde, kann es nach dem Erscheinen der Anmeldeanzeige eine ganze Minute oder länger dauern, bis Windows den Suchserver startet.

15.0 NetQuestion-Installationsverzeichnis suchen

Sie können die Position des NetQuestion-Installationsverzeichnisses bestimmen, indem Sie eine Eingabeaufforderung öffnen und Folgendes eingeben: 

set IMNINSTSRV

Das zurückgegebene Verzeichnis ist das NetQuestion-Installationsverzeichnis. Ist die Variable nicht gesetzt, können Sie das Installationsverzeichnis über die Windows-Registrierungsdatenbank bestimmen. Geben Sie regedit in eine Eingabeaufforderung ein und erweitern Sie die Einträge in der Registrierungsdatenbank bis zu dem Schlüssel HKEY_LOCAL_MACHINE\SOFTWARE\IBM\NetQuestion\CurrentVersion\Installation Directory. Der Eintrag "Directory" dieses Schlüssels sollte auf das NetQuestion-Installationsverzeichnis zeigen.

Ist unter Windows 95 und Windows 98 die Umgebungsvariable IMNINSTSRV nicht definiert, können Sie das Verzeichnis aber über die Registrierungsdatenbank bestimmen, müssen Sie möglicherweise Ihre Datei autoexec.bat editieren. (Tritt diese Bedingung unter Windows Millennium Edition auf, lesen Sie unter 17.0 Besondere Hinweise zur Windows Millennium Edition nach.) Der NetQuestion-Installationsprozess sollte Ihre Datei autoexec.bat insofern geändert haben, dass ein Befehl zum Aufrufen der Stapeldatei imnenv.bat, die im NetQuestion-Verzeichnis gespeichert ist, hinzugefügt wurde. Der hinzugefügte Befehl sieht in etwa wie folgt aus: 

if exist _NETQ_DIR_\imnenv.bat call _NETQ_DIR_\imnenv.bat

Fehlt diese Zeile oder zeigt _NETQ_DIR_ auf das falsche Verzeichnis, fügen Sie die Zeile mit dem korrekten NetQuestion-Verzeichnis hinzu. Sie sollten außerdem sicherstellen, dass die Stapeldatei imnenv.bat, die in autoexec.bat aufgerufen wird, tatsächlich vorhanden ist und Einträge enthält, die auf das aktuelle Verzeichnis und nicht auf ein anderes NetQuestion-Verzeichnis zeigen. Der Inhalt der Stapeldatei imnenv.bat sollte wie folgt aussehen: 

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

16.0 HTML-Dateizuordnungen in der Windows-Registrierungsdatenbank definieren

Können Sie die Hilfe weder vom Browser aus noch von einer Befehlszeile aus starten, ist möglicherweise nicht die korrekte Dateizuordnung für HTML-Dateien definiert. Der Client-Code der Hilfefunktion verwendet Einträge in der Registrierungsdatenbank, um den Standard-System-Browser auf der Basis dieser Dateizuordnungen zu bestimmen. Die können Ihre Dateizuordnungen mit Hilfe des Registrierungseditors überprüfen:

  1. Wählen Sie im Menü "Start" Ausführen aus.
  2. Geben Sie regedit in den Dialog "Ausführen" ein.
  3. Erweitern Sie im Registrierungseditor HKEY_CLASSES_ROOT.
  4. Ein Eintrag für .htm sollte angezeigt werden. Der Standardwert für diesen Eintrag sollte entweder "NetscapeMarkup" lauten (wenn Netscape Ihr Standard-Browser ist) oder "htmlfile" (wenn Internet Explorer Ihr Standard-Browser ist).

Wird kein derartiger Eintrag angezeigt, können Sie den Eintrag wie folgt hinzufügen:

  1. Starten Sie den Browser, der als Ihr Standard-System-Browser registriert werden soll.
  2. Zeigt der Browser einen Dialog an, in dem Sie aufgefordert werden, anzugeben, ob dies Ihr Standard-Browser werden soll, antworten Sie mit "Ja". Andernfalls können Sie Ihren Browser so definieren, dass Sie beim nächsten Starten zu dieser Angabe aufgefordert werden:

    Für Netscape Communicator:

    1. Verlassen Sie alle Netscape-Fenster.
    2. Suchen Sie Ihre Benutzervorgabendatei prefs.js. Sie ist in der Regel in einem Verzeichnis unter dem Netscape-Produktinstallationsverzeichnis gespeichert. Der übliche Pfad ist Netscape-Installationsverzeichnis\users\Benutzername\prefs.js; dabei ist Benutzername entweder "default" (Standard) oder der Name, mit dem Sie sich bei Windows anmelden.
    3. Editieren Sie die Datei mit einem Texteditor für unstrukturierten Text und entfernen Sie die Zeile: 
      user_pref("browser.wfe.ignore_def_check", true);
    4. Sichern Sie die Datei (stellen Sie sicher, dass Sie die Datei als unstrukturierten Text sichern, sofern Sie WordPad verwendet haben).
    5. Starten Sie Netscape erneut und registrieren Sie Netscape als den Standard-Browser.

    Für Internet Explorer:

    1. Lokalisieren Sie den Menüpunkt Optionen oder Internetoptionen. Abhängig von der Version von Explorer, die Sie verwenden, können Sie auf Ihre Browser-Optionen über das Menü "Extras", "Datei" oder "Ansicht" zugreifen.
    2. Wählen Sie die Registerkarte Programme des Dialogs aus.
    3. Wählen Sie das Kontrollkästchen Auf Internet Explorer als Standard-Browser überprüfen aus.
    4. Verlassen Sie Internet Explorer.
    5. Starten Sie Internet Explorer erneut und registrieren Sie Internet Explorer als den Standard-Browser.

17.0 Besondere Hinweise zur Windows Millennium Edition

Verwenden Sie Windows Millennium Edition, werden Änderungen, die Sie an der Datei autoexec.bat zum Laden der NetQuestion-Umgebungsvariablen vorgenommen haben, möglicherweise selbst nach einem Warmstart nicht wirksam; unter Umständen verschwinden die Änderungen nach einem Warmstart. Dies kann zur Folge haben, dass die NetQuestion-Umgebungsvariablen undefiniert bleiben, was wiederum zu den folgenden Arten von Fehlern führen kann:

Ob dies der Grund für Fehler in der Hilfefunktion ist, kann festgestellt werden, indem Sie nach dem Warmstart prüfen, ob die Umgebungsvariablen korrekt definiert sind. Sind sie immer noch nicht definiert, können Sie mit dem Programm msconfig.exe, das sich im Windows-Systemverzeichnis befindet, die folgenden Umgebungsänderungen durchführen:

18.0 Besondere Hinweise zu Component Broker

Component Broker verwendet nicht den Client-Teil der VisualAge-Hilfefunktion, der die Hilfe über eine F1- oder Hilfemenüaktion in der Benutzerschnittstelle startet. Dies hat zwei wichtige Auswirkungen:

Component Broker stellt zusätzliche Informationen zur Fehlerbehebung in der Hilfefunktion im Verzeichnis doc\readme zur Verfügung.

19.0 Besondere Hinweise zu DBCS-Systemen

Auf Systemen, bei denen die installierte Hilfe teilweise oder ganz in vereinfachtem Chinesisch (Ländereinstellung zh_CN), Taiwanisch (zh_TW), Koreanisch (ko_KR) oder Japanisch (ja_JP) geschrieben ist, müssen Sie den Befehl vahcfg und die NetQuestion-Befehle wie folgt ändern:

Diese Änderungen sind erforderlich, da NetQuestion für seine Single-Byte- und Double-Byte-Suchfunktionen unterschiedliche ausführbare Dateien und Server verwendet.