Résolution des incidents dans l'aide des produits WebSphere et VisualAge

Le système d'aide de VisualAge permet d'afficher les informations d'aide en ligne de plusieurs logiciels IBM. Lorsque vous appuyez sur F1 ou que vous sélectionnez une option dans le menu Aide à partir de l'interface utilisateur de l'un de ces produits, un navigateur comportant l'aide relative à ce produit s'ouvre. Si des incidents se produisent lors du démarrage ou de l'utilisation de l'aide en ligne de votre produit, ce document peut vous aider à les résoudre.

Le système d'aide de VisualAge comporte trois composants principaux :

Dans la plupart des cas, ces trois composants sont exécutés sur la machine sur laquelle le produit est installé.

1.0 Où commencer ?

Pour commencer à résoudre votre incident, suivez la procédure ci-après.

  1. Déterminez si ce document peut vous aider en lisant la section 1.1 Produits utilisant le système d'aide de VisualAge.
  2. Lisez le récapitulatif 1.2 Considérations spéciales, puis lisez les sections s'appliquant à votre produit ou à votre environnement.

  3. Commencez l'analyse de l'incident avec la section 1.3 Quels sont les symptômes ?

1.1 Produits utilisant le système d'aide de VisualAge

Les produits IBM suivants utilisent le système d'aide de VisualAge, tel qu'il est en février 2001 :

Si vous utilisez un logiciel IBM mis sur le marché après novembre 2000 et qu'il ne se trouve pas dans la liste ci-dessus, vous pouvez déterminer si ce produit utilise le système d'aide de VisualAge en entrant la commande suivante à partir d'une invite de commande :

vahcfg list /f %IMNINSTSRV% | more

et en recherchant le nom du produit sur les lignes commençant par Product:. Si votre produit apparaît dans la liste, il utilise le système d'aide de VisualAge. S'il n'apparaît pas dans la liste ou si vous obtenez un message indiquant que la commande n'est pas reconnue, vous pouvez contacter le support technique IBM afin de déterminer si votre produit IBM utilise le système d'aide de VisualAge.

1.2 Remarques particulières

Vous devez lire les section suivantes si le produit, l'environnement ou l'incident décrit correspond à votre situation :

1.3 Quels sont les symptômes ?

A partir du menu Aide du produit, choisissez la page d'accueil de l'aide (ou l'option de menu correspondante dans votre produit). Si aucun menu d'aide n'est disponible, appuyez sur F1 dans un des panneaux de l'interface utilisateur du produit. Que se passe-t-il ?

  1. Rien - reportez-vous à la section 2.0 Rien ne se passe lorsque vous tentez de lancer l'aide
  2. Un navigateur est lancé ou passe au premier plan :
    1. Il ne peut pas se connecter à localhost:49213 - reportez-vous à la section 3.0 Connexion au serveur localhost:49213.
    2. Il ne peut pas se connecter à un hôte éloigné et vous accédez à l'aide à distance - vérifiez que l'hôte éloigné a été démarré et qu'il est correctement configuré.
    3. Vous obtenez une erreur Fichier non trouvé - reportez-vous à la section 4.0 Erreurs Fichier non trouvé.
    4. Vous obtenez d'autres messages indiquant que des fichiers sont manquants lors d'une recherche, ou des images endommagées dans la page des résultats de la recherche - reportez-vous à la section 4.3 Autres erreurs de recherche impliquant des fichiers manquants.
    5. Vous obtenez un message Internal server error ou une boîte de dialogue de message Erreur d'application - reportez-vous à la section 5.0 Messages d'erreur de serveur interne.
  3. Vous obtenez un message The product xxxxx is unknown to the help system - reportez-vous à la section 6.0 Nouvelle configuration de l'aide.
  4. Vous obtenez un message demandant d'utiliser un navigateur gérant les cadres - utilisez comme navigateur par défaut Netscape 4.7 ou version ultérieure ou Internet Explorer 5 ou version ultérieure.
  5. L'aide s'affiche correctement.

Lorsque l'aide s'affiche correctement, vous devez encore prendre en compte deux autres éléments :

  1. Vous voulez accéder à l'aide à partir d'une machine éloignée. Reportez-vous à la section 12.0 Configuration du système d'aide sur un serveur Windows.
  2. La recherche dans l'aide ne fonctionne pas. Entrez une requête dans la zone d'entrée de recherche. Que se passe-t-il ?
    1. Rien - la recherche effectuée par le navigateur n'aboutit pas ou se prolonge de manière excessive - reportez-vous à la section 7.0 Dépassement de délai lors de la recherche.
    2. Vous obtenez une erreur Fichier non trouvé - reportez-vous à la section 4.0 Erreurs Fichier non trouvé.
    3. Vous obtenez un message Internal server error - reportez-vous à la section 5.0 Messages d'erreur de serveur interne.
    4. Vous obtenez un message contenant rc=73 ou The search request was empty - reportez-vous à la section 8.0 Mots non significatifs ou rc=73.
    5. Vous obtenez un message contenant rc=32 ou d'autres messages d'erreur de recherche - reportez-vous à la section 9.0 Autres erreurs de recherche.

Si l'incident rencontré n'est pas cité ci-dessus, contactez le support technique IBM. Pour plus d'informations, consultez le site http://www.ibm.com/software/ad/support.

2.0 Rien ne se passe lorsque vous tentez de lancer l'aide

Remarque : Cette section ne concerne ni Component Broker ni WebSphere Business Components. Pour Component Broker, reportez-vous aux informations relatives à la résolution des incidents de l'aide dans le répertoire doc\readme.

Si rien ne se passe avec VisualAge for Java, Version 3.5 et que vous utilisez une icône du bureau afin de lancer l'environnement IDE VisualAge for Java, reportez-vous à la section 2.1 Cas particulier  - VisualAge for Java, Version 3.5.

Si rien ne se passe lorsque vous tentez de lancer l'aide, vous devez tout d'abord déterminer si vous pouvez y parvenir à partir de la ligne de commande. Pour cela, vous devez savoir dans quel répertoire est installé le produit. Dans le texte qui suit, remplacez REP_INSTALL, par le répertoire dans lequel le produit est installé, par exemple x:\ibmvjava ou "x:\Program Files\IBM\VisualAge for Java". Placez le chemin complet entre guillemets (REP_INSTALL plus tout sous-répertoire ou nom de fichier) lorsqu'il contient des caractères d'espacement. Suivez la procédure ci-dessous lorsque vous tentez de lancer l'aide à partir de la ligne de commande :

  1. Ouvrez une fenêtre d'invite de commande.
  2. Accédez au disque logique sur lequel le produit est installé, puis au répertoire de ce disque. Par exemple, si votre produit est installé dans "g:\Program Files\IBM\VisualAge for Java", entrez :
    g:
    cd "\Program Files\IBM\VisualAge for Java"
  3. Accédez au répertoire sous le répertoire du produit dans lequel se trouve l'exécutable vahelp.exe. Vous pouvez déterminer son emplacement en entrant tout d'abord :
    dir /s /b vahelp.exe

    Si vous obtenez :

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

    vous devez alors entrer :

    cd eab\bin
  4. Lancez la commande suivante (les guillemets sont nécessaires uniquement si le chemin contient des caractères d'espacement) :

S'il est possible de lancer l'aide à partir de la ligne de commande et d'effectuer des recherches dans l'aide, un incident lié à la configuration du chemin empêche l'interface utilisateur du produit de se connecter à la DLL du système d'aide. Reportez-vous à la section 2.1 Cas particulier  - VisualAge for Java 3.5, ou pour les autres produits, essayez de désinstaller et de réinstaller le produit.

Si le lancement de l'aide à partir de la ligne de commande vous convient en tant que solution palliative ou correctif temporaire, vous pouvez créer une icône sur votre bureau pour cela. Reportez-vous à la section 11.0 Création d'une icône de lancement de l'aide du produit.

Si l'aide ne se charge pas à partir de la ligne de commande ou si elle se charge de cette manière mais non dans le produit, les associations de fichier adaptées à votre navigateur n'ont pas été configurées dans le registre Windows. Reportez-vous à la section 16.0 Définition d'associations de fichiers HTML dans le registre Windows.

Si la modification des associations de fichiers n'apporte aucune aide, vous pouvez suivre la procédure ci-après permettant d'extraire un fichier journal du système d'aide.

  1. Editez le fichier de configuration d'aide du produit (REP_INSTALL\REP_AIDE\FICHIER_CONFIG) dans un éditeur de texte (le Bloc-notes, par exemple) et ajoutez la ligne suivante à la fin du fichier :
    HTMLHELP_LOG=1
  2. Sauvegardez le fichier. Sauvegardez-le au format texte seulement si vous utilisez un éditeur de type WordPad.
  3. Quittez et relancez votre produit IBM.
  4. Appuyez sur F1 ou utilisez le menu Aide pour lancer l'aide à partir du produit.

Le répertoire désigné par la variable d'environnement TMP doit contenir un ou plusieurs fichiers de type HTML*.C2T. Ces fichiers comportent des informations de journal détaillées sur les requêtes effectuées dans le système d'aide. Vous pouvez envoyer ces fichiers au support technique IBM afin qu'ils soient analysés. Les interventions peuvent être payantes. Vous pouvez tenter d'examiner ces fichiers vous-même afin de déterminer la cause de l'échec.

Si vous ne voyez aucun fichier HTML*.C2T dans le répertoire TEMP, essayez à nouveau d'appeler l'aide à partir de la ligne de commande. Si les fichiers HTML*.C2T sont créés uniquement à partir de la ligne de commande, l'incident découle de l'appel de l'aide par le produit. Si aucune méthode d'appel d'aide ne génère de fichiers d'aide, le système d'aide lui-même est défectueux. Dans ce cas, vous pouvez contacter le support technique IBM.

Pensez à supprimer la ligne HTMLHELP_LOG=1 du fichier de configuration d'aide du produit lorsque vous avez terminé. Sinon, des fichiers journaux non nécessaires seront générés à chaque interrogation de l'aide.

Si vous ne pouvez toujours pas lancer l'aide, vérifiez que le fichier de configuration de l'aide du produit est toujours valide. Ouvrez le fichier REP_INSTALL\REP_AIDE\FICHIER_CONFIG dans un éditeur et vérifiez les éléments suivants :

2.1 Cas particulier - VisualAge for Java, Version 3.5

Pour VisualAge for Java, Version 3.5, si vous ne pouvez pas lancer l'aide à partir de l'environnement IDE mais que vous pouvez effectuer cette action à partir de la ligne de commande, il est possible que vous appeliez l'environnement IDE à l'aide du mauvais raccourci. Cela se produit si vous créez ou modifiez manuellement un raccourci vers l'environnement IDE sur votre bureau ou dans le menu Démarrer et que vous appelez l'environnement IDE à partir de ce raccourci. Cela peut également se produire si vous utilisez un raccourci créé pour la version 3.0 ou 3.02 pour le lancement de la version 3.5. Suivez la procédure ci-après afin de déterminer si un incident de ce type s'est produit.

  1. Quittez toute session IDE VisualAge for Java en cours d'exécution et attendez 10 secondes jusqu'à ce que la dernière fenêtre VisualAge for Java disparaisse afin de vous assurer que le programme a terminé sa procédure d'arrêt.
  2. Lancez l'environnement IDE VisualAge for Java à l'aide du menu Démarrer (Démarrer > Programmes > IBM VisualAge for Java pour Windows V3.5 > IBM VisualAge for Java).
  3. Appuyez sur F1 dans l'environnement IDE.

Si l'aide fonctionne lorsque vous appelez l'environnement IDE à partir du menu Démarrer, et non à partir de l'icône ou du raccourci que vous utilisez d'habitude, cette icône ou ce raccourci désigne probablement le fichier REP_INSTALL_VAJ\ide\program\ide.exe, qui lance l'environnement IDE mais ne prend pas en charge l'aide car la variable d'environnement PATH ne désigne pas la DLL du système d'aide. Vous pouvez résoudre cette erreur en modifiant la zone Cible du raccourci afin qu'elle désigne le fichier REP_INSTALL_VAJ\ide\program\ivjenv.bat. Ce fichier de commandes change les variables d'environnement Windows afin que l'aide fonctionne correctement à partir de l'environnement IDE.

3.0 Connexion au serveur localhost:49213

Si, lorsque vous lancez l'aide, un navigateur s'ouvre ou passe au premier plan mais ne peut pas se connecter à localhost:49213, il existe trois causes possibles :

Vérifiez chaque sous-section ci-dessu afin de résoudre tout incident possible lié à une configuration incorrecte du navigateur ou du serveur Web.

3.1 HTTPDL.EXE n'est pas en cours d'exécution

HTTPDL.EXE est un processus de serveur HTTP qui prend en charge l'accès local uniquement. Il fait partie du composant NetQuestion. Il est utilisé pour diriger les pages d'aide vers votre navigateur local. Vérifiez si le processus HTTPDL.EXE apparaît dans la liste des tâches.

Si la tâche ne se trouve pas dans la liste, le système n'a sans doute pas pu le lancer. Essayez d'abord de l'appeler à partir de la ligne de commande pour voir si un message d'erreur est renvoyé.

  1. Accédez au répertoire dans lequel NetQuestion est installé (reportez-vous à la section 15.0 Recherche du répertoire d'installation de NetQuestion)

  2. Lancez la commande :
    httpdl -r httpd.cnf

Si le système renvoie l'erreur Binding the socket failed, un processus HTTPDL.EXE est probablement en cours d'exécution sur le port 49213 (port TCP/IP utilisé par le processus HTTPDL.EXE). S'il renvoie une autre erreur, contactez le support technique IBM. Si aucune erreur n'est renvoyée, vérifiez la liste des tâches afin de vous assurer qu'elle s'exécute en arrière-plan. Les versions de HTTPDL.EXE du 02/12/2000 ou les versions ultérieures verrouillent l'invite de commande si elles ne détectent aucune erreur. Avec les versions ultérieures, l'exécution se poursuit sans verrouillage de l'invite de commande. Si votre version verrouille l'invite de commande, appuyez sur Ctrl+Pause et lancez la commande suivante afin de démarrer le processus en tant que processus détaché :

nqdetach httpdl.exe -r httpd.cnf

Essayez ensuite à nouveau de charger la page dans votre navigateur. Si la page s'affiche correctement, le système a rencontré des difficultés lors du démarrage du serveur HTTP (ou, pour Component Broker, le serveur n'est pas configuré pour démarrer lors de la connexion). Reportez-vous à la section 13.0 Démarrage automatique des serveurs NetQuestion.

Si la page ne s'affiche toujours pas, reportez-vous à la section 3.2 La configuration de HTTPDL.EXE est incorrecte et 3.3 Une substitution de proxy est nécessaire pour le navigateur.

3.2 La configuration de HTTPDL.EXE est incorrecte

Le fichier de configuration httpd.cnf, utilisé par HTTPDL.EXE, peut contenir des informations de chemin incorrectes. Suivez la procédure ci-après pour vérifier que la configuration est correcte :

  1. Utilisez la boîte de dialogue Démarrer > Rechercher(Démarrer > Rechercher sous Windows 2000) pour trouver tous les fichiers nommés HTTPDL.EXE sur vos disques durs locaux. Vérifiez qu'il existe une seule copie. S'il existe plusieurs copies, renommez celles qui ne se trouvent pas dans le répertoire d'installation de NetQuestion. (En les renommant, vous pouvez les restaurer ultérieurement en cas de nécessité, par exemple par un autre serveur Web.)
  2. Editez le fichier httpd.cnf qui apparaît dans le répertoire d'installation de NetQuestion. Recherchez toutes les lignes contenant des informations relatives au chemin. Ci-dessous, se trouvent les lignes concernées :
    Serverroot    C:\IMNNQ_NT
    Exec    /cgi-bin/*  C:\IMNNQ_NT\*
    Pass    /icons/*    C:\IMNNQ_NT\*
    Pass    /*          C:\IMNNQ_NT\*

    Vérifiez que le chemin indiqué correspond au répertoire dans lequel est stocké le fichier httpd.cnf. Si ce n'est pas le cas, changez-le dans les occurrences ci-dessous afin qu'il corresponde au chemin.

  3. Toujours dans le fichier httpd.cnf, vérifiez que les entrées suivantes sont présentes :
    Hostname localhost
    Port 49213

    Remplacez toutes les lignes Hostname ou Port existantes par les éléments ci-dessus en cas de différences.

  4. Si vous avez apporté des modifications au fichier httpd.cnf aux étapes 2 ou 3, terminez le processus HTTPDL.EXE et essayez à nouveau de lancer l'aide. Si l'incident n'est pas résolu, passez à la section suivante.

3.3 Une substitution de proxy est nécessaire pour le navigateur

Il arrive que le navigateur ne puisse pas se connecter au serveur Web local HTTPDL.EXE lorsqu'il recherche la machine nommée localhost via un serveur proxy. Cela se produit principalement lorsque le navigateur est paramétré pour une configuration de proxy manuelle ou automatique. Si vous utilisez une configuration de proxy manuelle, vous pouvez modifier vos paramètres de navigateur afin d'éviter que ce dernier tente de résoudre localhost via un serveur proxy. Si vous utilisez la configuration de proxy automatique, vous devez demander au propriétaire du fichier de configuration du proxy automatique d'ajouter 127.0.0.1 en tant qu'exception proxy au niveau du serveur proxy.

Pour déterminer si le navigateur est paramétré pour une configuration de proxy manuelle et pour l'ajout d'une substitution de proxy, suivez la procédure ci-après. Ces instructions concernent les versions de navigateur indiquées. Si vous utilisez un autre navigateur, la procédure peut être différente.

Pour Netscape 4.7 :

  1. A partir de Netscape Communicator, sélectionnez Edition > Préférences.
  2. Développez l'entrée Avancées dans la sous-fenêtre de gauche en cliquant sur le symbole + à sa gauche.
  3. Sélectionnez l'entrée Proxy sous Avancées.
  4. La sous-fenêtre de droite doit indiquer si la configuration est manuelle ou automatique ou si vous disposez d'une connexion directe à Internet. Si la configuration est manuelle, poursuivez la procédure, sinon arrêtez.
  5. Sélectionnez le bouton Afficher à côté de Configuration manuelle du Proxy.
  6. Assurez-vous que les adresses localhost:49213 et 127.0.0.1 apparaissent dans la liste des exceptions de proxy. Assurez-vous également qu'elles sont séparées par une virgule et non par des points-virgules. (Pour les autres versions de Netscape, assurez-vous que le caractère de séparation est celui identifié dans la boîte de dialogue. Par exemple, la boîte de dialogue Netscape 4.7 contient le texte Séparer les entrées par des virgules (,).) Effectuez les autres modifications requises et fermez les boîtes de dialogue jusqu'à ce que vous reveniez à la fenêtre principale du navigateur.

Pour Internet Explorer 5.0 :

  1. Dans Internet Explorer, sélectionnez Outils > Options Internet.
  2. Dans l'onglet Connexions, cliquez sur Paramètres LAN.
  3. Si l'option Utiliser un serveur proxy est sélectionnée, poursuivez la procédure, sinon arrêtez.
  4. Si une case Ne pas utiliser de serveur proxy pour les adresses locales apparaît, assurez-vous qu'elle est cochée.
  5. Sélectionnez Avancées
  6. Assurez-vous que les entrées localhost, localhost:49213 et 127.0.0.1 apparaissent toutes dans la liste des exceptions de proxy et vérifiez également qu'elles sont séparées par un point-virgule et non par une virgule. Effectuez les autres modifications requises et fermez les boîtes de dialogue jusqu'à ce que vous reveniez à la fenêtre principale du navigateur.

Vous devez également mettre à jour le fichier %SystemRoot%\system32\drivers\etc\hosts en ajoutant la ligne :

127.0.0.1     localhost

si le fichier existe mais que cette ligne ne s'y trouve pas. Si vous modifiez cette valeur, il peut s'avérer nécessaire de quitter et de relancer le navigateur pour que la modification prenne effet.

Si vous avez apporté des modifications à la configuration du navigateur ou au fichier ...\etc\hosts, essayez de recharger la page d'accueil de l'aide dans le navigateur. Si vous obtenez toujours des erreurs en essayant de vous connecter à locahost:49213, contactez le support technique IBM.

Si le serveur proxy automatique n'est pas accessible lorsque vous tentez d'afficher l'aide, le navigateur n'est peut-être pas en mesure de résoudre localhost en fonction de l'adresse locale 127.0.0.1. Vous pouvez corriger cette erreur de manière temporaire (lorsque le proxy n'est pas disponible) en modifiant la connexion directe à Internet à l'étape 4 (Netscape) ou à l'étape 3 (Internet Explorer) ci-dessus.

4.0 Erreurs Fichier non trouvé

Si vous obtenez une erreur Fichier non trouvé lorsque vous tentez d'afficher l'aide ou que vous effectuez une recherche, il peut manquer un fichier dans le répertoire d'installation de NetQuestion. Pour en savoir plus, lisez les sections ci-dessous.

4.1 Erreurs Fichier non trouvé lors d'une tentative d'affichage de la page d'accueil ou d'autres pages d'aide

Si vous obtenez une erreur Fichier non trouvé lorsque vous tentez d'afficher l'aide, le fichier vahwebx.exe peut ne pas se trouver dans le répertoire d'installation de NetQuestion. Utilisez la ligne de commande ou l'explorateur Windows pour vérifier si le fichier se trouve dans le répertoire. Si c'est le cas, l'erreur peut être liée à la configuration du serveur Web local. httpd.cnf peut désigner un répertoire incorrect. Reportez-vous à la section 3.2 La configuration de HTTPDL.EXE est incorrecte ci-dessus. Si le fichier vahwebx.exe n'existe pas dans ce répertoire, vous pouvez suivre une des procédures ci-dessous.

Rechargez la page du navigateur. Si l'aide fonctionne, la procédure a réussi. Si vous continuez d'obtenir une erreur Fichier non trouvé, contactez le support technique IBM. Si vous obtenez le message There is no help registered for product xxxxx, reportez-vous à la section 6.0 Nouvelle configuration de l'aide.

4.2 Erreurs Fichier non trouvé lors d'une recherche

Si vous obtenez un message Fichier non trouvé lorsque vous effectuez une recherche dans l'aide, le programme de recherche indiqué dans votre formulaire de recherche n'est peut-être pas installé à l'emplacement correct. Pour déterminer son nom et son emplacement, suivez la procédure ci-après.

  1. Dans votre produit IBM, sélectionnez Aide > Recherche pour ouvrir le formulaire de recherche dans une fenêtre de navigateur.
  2. Dans le navigateur, affichez la source de chaque formulaire de recherche. Vous pouvez effectuer cette action de la manière suivante :
  3. Dans la source du formulaire, cherchez la chaîne "action=". L'une des lignes suivantes doit s'afficher :
    <form action="http://localhost:49213/cgi-bin/ivjsenus.exe"...>
    <form action="http://localhost:49213/cgi-bin/va4sall.exe"...>

    Le nom du programme de recherche correspond à la partie de l'attribut action= après "cgi-bin", c'est-à-dire ivjsenus.exe ou va4sall.exe dans les exemples ci-dessus.

  4. Vérifiez que ce fichier se trouve dans le répertoire d'installation de NetQuestion. S'il s'y trouve et que vous continuez d'obtenir des erreurs Fichier non trouvé lors de la recherche, reportez-vous à la section 3.2 La configuration de HTTPDL.EXE est incorrecte ci-dessus. S'il n'y est pas, vous pouvez le copier à partir du CD-ROM du produit. Recherchez le produit. Si vous le trouvez, copiez-le dans le répertoire NetQuestion. Sinon, contactez le support technique IBM afin d'en obtenir une copie.

4.3 Autres erreurs de recherche impliquant des fichiers manquants

Vous pouvez également obtenir des images endommagées dans la page des résultats de la recherche ou un message Search form header not found ou Search form footer not found. Ces erreurs sont provoquées par des fichiers manquants dans le répertoire d'installation de NetQuestion. Vous pouvez trouver ces fichiers sur le CD du produit ou vous pouvez vous les procurer auprès du support technique IBM. Les noms de fichier sont tous indiqués dans le formulaire de recherche. Vous pouvez afficher la source du formulaire de recherche afin de déterminer les noms. Recherchez les paramètres value= des zones d'entrée masquées suivantes :

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

Les entrées mises en évidence concernent VisualAge for Java. Les entrées équivalentes pour les autres produits comportent, à la place de l'élément ivj :

5.0 Messages d'erreur de serveur interne

Un message Internal serveur error indique généralement qu'une application en cours d'exécution sur le serveur Web s'est arrêtée brutalement. Vous pouvez également obtenir une boîte de dialogue ayant comme titre program.exe - Application Error et un message commençant par The instruction at "0xnnnnnnnn" referenced memory at "0xnnnnnnnn". Si vous voulez fermer cette boîte de dialogue en sélectionnant OK, le navigateur affiche alors le message Internal serveur error.

Si cette erreur se produit lors d'une opération de recherche, des erreurs risquent de se produire dans les index de recherche du produit. Essayez de reconfigurer l'aide de votre produit puis entrez à nouveau la requête de recherche. Si l'erreur persiste, contactez le support technique IBM.

Si cette erreur se produit lorsque vous naviguez dans l'aide, il est possible que vous ne disposiez pas des droits d'accès aux répertoires appropriés au niveau d'un système de fichiers NTFS. Déconnectez-vous du système Windows NT ou Windows 2000, connectez-vous en tant qu'administrateur et vérifiez que tous les fichiers et dossiers du répertoire d'installation de NetQuestion et du répertoire d'aide du produit (_REP_INSTALL\doc ou REP_INSTALL\help, en fonction du produit) disposent des permissions de sécurité Tout le monde - Contrôle total. Pour cela :

  1. Lancez l'explorateur Windows et placez le curseur sur le répertoire à vérifier ou à changer.
  2. Cliquez avec le bouton droit de la souris sur le nom du répertoire.
  3. Sélectionnez Propriétés, puis Sécurité.
  4. Cliquez sur le bouton Permissions et vérifiez que les cases à cocher (pour le remplacement des permissions sur les fichiers et les sous-répertoires existants) sont sélectionnées.
  5. Ajoutez une entrée utilisateur pour Tout le monde s'il n'en existe aucune, en sélectionnant Ajouter et en suivant les instructions.
  6. Assurez-vous que l'entrée Tout le monde dispose au moins de l'accès Accès spécial (RX) (R) ou attribuez la valeur Contrôle total au niveau d'accès.

Si vous avez apporté des modifications aux droits d'accès, fermez ces boîtes de dialogue et essayez de recharger la page. S'il n'était pas nécessaire d'apporter des modifications aux droits d'accès ou si l'erreur persiste une fois que vous avez effectué les modifications, tentez de supprimer le fichier vahelp.cfg du répertoire d'installation de NetQuestion puis de reconfigurer l'aide de votre produit.

Si des messages Internal server error apparaissent encore, contactez le support technique IBM.

6.0 Nouvelle configuration de l'aide

Dans certains cas, l'aide d'un produit a été mal configurée, ou certaines informations de configuration ont été supprimées lors de la résolution des erreurs d'installation. Vous pouvez reconfigurer l'aide du produit en suivant les instructions ci-dessous. Avant de commencer, vous devez connaître :

La première partie de ce processus consiste à déterminer si l'aide est déjà configurée et doit simplement être régénérée. Pour déterminer si l'aide du produit est configurée, entrez la commande suivante :

vahcfg list /f %IMNINSTSRV% | more

Une liste des composants et des produits qui ont été configurés pour l'aide s'affiche. Si vous voyez un produit dont le répertoire correspond au répertoire de votre produit, notez son nom. Par exemple, si la sortie de vahcfg list inclut les éléments suivants :

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

Le nom du produit est va400. Si vous voyez une entrée correspondant au produit, vous pouvez reconfigurer l'aide en utilisant la commande vahcfg regen. S'il n'existe pas d'entrée pour le produit, vous devez reconfigurer l'aide en utilisant la commande vahcfg install. Ces deux commandes seront décrites ultérieurement.

6.1 Espace disque libre

Avant de lancer vahcfg regen ou vahcfg, vous devez également vous assurer que le disque sur lequel se trouve le répertoire de la documentation contient suffisamment d'espace disponible pour gérer les index de recherche de l'aide du produit. Ces index sont extraits des fichiers *.zip dans le répertoire de la documentation et enregistrés dans les sous-répertoires du répertoire de la documentation par le programme vahcfg. Vous devez disposer d'au moins d'autant d'espace disque disponible que l'espace nécessaire à l'utilisation des fichiers compressés dans le répertoire de documentation.

6.2 Utilisation de vahcfg regen

Pour exécuter vahcfg regen, lancez la commande suivante :

vahcfg regen /p nomproduit /f %IMNINSTSRV%

nomproduit correspond au nom du produit noté lors de l'exécution de vahcfg list.

6.3 Utilisation de vahcfg install

Pour exécuter vahcfg install, émettez la commande suivante :

vahcfg install /w repdoc /f %IMNINSTSRV%

repdoc correspond au chemin complet du répertoire contenant les fichiers d'aide du produit. Si ce répertoire contient des caractères d'espacement (par exemple c:\Program Files\IBM\...), placez le chemin entre guillemets.

6.4 Après l'exécution de vahcfg install ou de vahcfg regen

Après l'installation ou la régénération (opérations pouvant prendre plusieurs minutes), essayez de relancer l'aide. Si l'erreur que vous tentiez de corriger persiste, suivez la procédure de la section 6.5 Extraction d'un fichier journal de vahcfg regen ou de vahcfg install, contactez le support technique IBM et transmettez-lui le fichier journal.

6.5 Extraction d'un fichier journal à partir de vahcfg regen ou de vahcfg install

Si vous avez tenté de régénérer ou d'installer l'aide du produit à l'aide de vahcfg regen ou de vahcfg install et que vos erreurs ne sont toujours pas résolues, suivez la procédure ci-après permettant de générer un fichier journal que le support technique IBM peut utiliser ultérieurement pour effectuer un diagnostic :

  1. A partir d'une invite de commande, définissez la variable d'environnement VAGCFG_LOG de telle sorte qu'elle désigne un nouveau fichier se trouvant dans un répertoire autorisant l'accès en écriture. Par exemple :
    SET VAHCFG_LOG=c:\config.log
  2. Si vous avez lancé la commande vahcfg install et rencontré des difficultés, lancez les deux commandes suivantes :
    vahcfg remove /p nomproduit /f %IMNINSTSRV%
    vahcfg install /w repdoc
  3. Si vous avez lancé la commande vahcfg regen et rencontré des difficultés, lancez à nouveau la commande vahcfg regen.

Vous pouvez alors fournir le fichier journal généré au support technique IBM.

Certaines versions antérieures de vahcfg ne génèrent pas de fichier journal. Les versions ne prenant pas en charge la journalisation affichent la sortie à l'écran. Les versions prenant en charge la journalisation affichent un message indiquant l'emplacement où les informations sont consignées.

7.0 Dépassement de délai lors de la recherche

Le système de recherche NetQuestion est très rapide sauf dans le cas des requêtes génériques. Si vous recherchez les occurrences de la chaîne a*, le système doit trouver tous les documents contenant au minimum un terme commençant par la lettre a. Le processus est donc toujours plus long. Si vous effectuez une recherche plus spécifique, les résultats apparaissent dans les quelques secondes qui suivent. Si la recherche dure trop longtemps (plus d'1 minute par exemple), il est possible qu'un incident lié à l'utilisation de Netscape Navigator 4.5 ou version suivante se soit produit sur le système Windows 2000. (Cet incident peut se produire également sur certains systèmes Windows NT.)

Un incident susceptible de ralentir considérablement l'aide en ligne a été détecté avec Netscape (versions 4.5 à 4.74 et peut-être d'autres) sur certaines machines Windows 2000. Lorsque vous soumettez une recherche à partir des versions ci-dessus, Netscape utilise la plupart des cycles processeur disponibles sur la machine jusqu'à réception d'une réponse du système éloigné. (Pour vérifier, vous pouvez ouvrir la page du Gestionnaire des tâches Windows pendant une recherche, basculer vers l'onglet Processus et cliquer sur l'en-tête de colonne UC. Si l'incident décrit ci-dessus se produit, netscape.exe apparaît au début de cette liste et utilise entre 97 et 99 % du temps UC.)

Cette utilisation de l'UC ne présente pas d'inconvénient lors d'une recherche à distance (sur un site Web, par exemple). Etant donné que le programme de recherche du produit est exécuté sur votre machine locale et que Netscape utilise beaucoup de temps UC, le temps UC restant est insuffisant pour l'exécution de la recherche. Ainsi, une opération de recherche qui devrait prendre une seconde peut durer plusieurs minutes sous Windows 2000.

Pour éviter cette perte de performances sous Windows 2000, vous pouvez sélectionner une fenêtre distincte, non Netscape après avoir lancé chacune des recherches. Netscape n'utilise plus des cycles UC excessifs lors de l'attente d'une réponse et les résultats de la recherche s'affichent généralement dans la seconde qui suit le changement de fenêtre. Cette technique fonctionne également sous Windows NT mais elle moins fiable.

Une autre solution consiste à afficher l'aide dans Microsoft Internet Explorer car aucune perte de performances ne se produit avec ce navigateur.

8.0 Mots non significatifs ou rc=73

L'un des messages d'erreur suivants peut apparaître lorsque vous effectuez une recherche dans le système d'aide à partir du navigateur :

Ces messages peuvent apparaître dans les deux cas de figure suivants :

Le code retour 73 est renvoyé en général lorsqu'une recherche contient uniquement des mots non significatifs et non lorsque la requête de recherche est vide. Si vous obtenez le même message en indiquant une requête de recherche non vide (et ne contenant pas uniquement des mots non significatifs), votre formulaire de recherche est probablement altéré. Localisez les formulaires de recherche hgssrch.htm et hgcsrch.htm dans le répertoire d'installation de l'aide du produit (REP_INSTALL\doc ou REP_INSTALL\help, en général) et faites-les parvenir au responsable technique IBM.

9.0 Autres erreurs de recherche

D'autres messages d'erreur peuvent être générés lors d'une recherche. Si l'une des erreurs suivantes se produit, exécutez l'action recommandée avant de prendre contact avec le support technique IBM.

9.1 Le serveur NetQuestion indiqué n'est pas disponible. (rc=33)

Cause : Le client sur lequel l'aide est installée n'a pas pu lancer le service de recherche (ou pour Component Broker, le service de recherche n'est pas configuré pour démarrer lors de la connexion).  Cette erreur peut se produire lorsque vous effectuez une recherche sur la machine locale (http://localhost:49213) ou sur un serveur d'aide éloigné.

Action recommandée (aide installée en local) :

Reportez-vous à la section 3.1 HTTPDL.EXE n'est pas en cours d'exécution et plus particulièrement au paragraphe ayant trait à l'importation des entrées de registre de démarrage automatique, afin que le service de recherche soit lancé automatiquement lorsque vous vous connectez. Une solution rapide consiste à accéder à une invite de commande et à entrer la commande suivante :

imnss start server

Si cette commande renvoie un message contenant la ligne :

The search service has been started.

vous pouvez relancer la recherche sans que cette dernière renvoie l'erreur rc=33.

Action recommandée (aide installée sur un serveur éloigné) :

Il est possible que le processus de recherche NetQuestion du serveur ne s'exécute pas si la machine a été redémarrée et qu'aucun utilisateur n'est connecté. Reportez-vous à la section 14.0 Lancement du service de recherche NetQuestion au démarrage.

9.2 Aucune cible n'est indiquée pour la recherche

Cause : Aucun nom d'index valide n'a été indiqué dans la requête de recherche. Il est possible que le formulaire de recherche soit altéré ou que les index indiqués ne soit plus enregistrés ou encore qu'un incident lié à l'installation de NetQuestion se soit produit.

Action recommandée : Dans un premier temps, supprimez tous les fichiers hg*.htm du répertoire d'installation de l'aide du produit (REP_INSTALL\doc ou REP_INSTALL\help). Essayez ensuite de reconfigurer l'aide du produit. Si l'incident n'est pas résolu, vous pouvez être amené à réinstaller NetQuestion et à configurer une nouvelle fois l'aide du produit.

9.3 En-tête | bas de page du formulaire de recherche introuvables

Cause : Le formulaire de recherche ne contient aucun en-tête ni bas de page (fichier contenant un fragment de code HTML devant être placé au-dessus ou au-dessous des résultats de la recherche).

Action recommandée : Pour plus d'informations, reportez-vous à la section 4.2 Erreurs Fichier non trouvé lors d'une recherche.

9.4 Requête trop complexe. Reformulez la requête de recherche. (rc=22)

 Cause : Un trop grand nombre d'occurrences ont été trouvées pour la requête de recherche. Le moteur de recherche ne peut pas traiter une requête pour laquelle plus de 1024 occurrences ont été trouvées. Par exemple, en entrant la chaîne de recherche "a* b* c* d*" (sans taper les guillemets), vous recherchez tous les documents qui contiennent les mots commençant par la lettre a, b, c ou d. Etant donné le nombre considérable de mots remplissant ces critères, le moteur de recherche ne peut pas générer une liste d'occurrences significative et triée.

Action recommandée : Entrez une requête de recherche susceptible de produire un nombre d'occurrences limité.

9.5 La condition indiquée est non valide

Cause : La requête de recherche entrée n'est pas valide en terme de logique. Par exemple, la requête "-java" (qui consiste à afficher tous les documents ne contenant pas le terme java) n'est pas considérée comme valide.

Action recommandée : Entrez une requête de recherche qui contient au moins un terme autorisé.

9.6 Le fichier de configuration NetQuestion (NETQ.CFG) est erroné ou introuvable. (rc=77)

Cause : Cette erreur peut se produire lorsque le programme de recherche ne peut pas lire les variables d'environnement nécessaires au bon déroulement de l'opération. Si l'aide est configurée pour fonctionner sur le serveur Web HTTPDL.EXE de NetQuestion, vous pouvez être amené à modifier les paramètres de ce serveur afin que certaines variables d'environnement soient visibles dans le programme CGI de recherche (programme appelé par le paramètre "action=" de la balise <form> du formulaire de recherche). Sur certains serveurs Web, les variables d'environnement sont masquées par défaut. Le programme CGI de recherche doit pouvoir accéder aux variables IMNINSTSRV et IMNINST. Netscape Enterprise Server fait partie des serveurs Web pour lesquels les variables d'environnement sont masquées par défaut.

Action recommandée : Modifiez les paramètres du serveur Web pour pouvoir exporter manuellement ces variables d'environnement vers les applications CGI du serveur Web ou rendre les variables d'environnement locales visibles dans les programmes CGI. Pour effectuer cette opération sur Netscape Enterprise Server, procédez comme suit :

  1. Ouvrez x:\répertoire_netscape_enterprise_server\https-nom_serveur\config\obj.conf, où répertoire_netscape_enterprise_server correspond au répertoire d'installation du serveur NES et nom_serveur correspond au nom du serveur sur lequel l'aide est installée, comme indiqué lors de l'installation du serveur NES.
  2. Vous devez connaître les valeurs des variables d'environnement NetQuestion. A l'invite de commande, entrez :
    set imn

    Le système renvoie les valeurs affectées aux variables IMNINST et IMNINSTSRV, telles que :

    IMNINST=help
    IMNINSTSRV=C:\IMNNQ_NT
  3. En fonction des résultats ci-dessus, ajoutez les lignes suivantes dans le fichier obj.conf en les plaçant juste après les lignes commençant par une instruction "Init". Utilisez uniquement des BARRES OBLIQUES (/) lorsque vous ajoutez le chemin IMNINSTSRV :
    Init fn="init-cgi" IMNINSTSRV=c:/imnnq_nt
    Init fn="init-cgi" IMNINST=help
  4. Arrêtez Netscape Enterprise Server. Si l'avertissement suivant apparaît à l'écran :

    "WARNING: The configuration files have been edited by hand. Use this button to load the latest configuration files."

    cliquez sur Load Configuration files.

  5. Démarrez Netscape Enterprise Server.
  6. Faites une nouvelle tentative de recherche.

Pour savoir comment rendre les variables d'environnement visibles dans les applications CGI avec d'autres serveurs Web, reportez-vous à la documentation du serveur utilisé.

9.7 Autres erreurs NETQ.CFG ou rc=32

Cause : Une erreur rc=32 ou une erreur liée au fichier NETQ.CFG se produit lorsque NetQuestion ne peut pas accéder à un index du produit. Cette erreur peut se produire si l'installation de NetQuestion ou un index donné a été altéré ou uniquement lors de la première recherche portant sur un index donné à la suite d'une réinitialisation. Bien que le fichier NETQ.CFG soit mentionné dans les messages concernant les différentes variantes de cette erreur, celui-ci n'a pas d'existence réelle. L'erreur concerne des incidents liés à d'autres fichiers de configuration d'index NetQuestion.

Action recommandée : Identifiez la cause probable de l'erreur et suivez les instructions ci-dessous pour la corriger :

9.8 Reconfiguration de l'index ou erreurs rc=76

Si une recherche renvoie un message d'erreur rc=76, il peut s'avérer nécessaire de reconfigurer un ou plusieurs index de recherche. Pour redéfinir les index, procédez comme suit :

  1. Affichez le code source du formulaire de recherche à partir du navigateur. Recherchez les lignes qui contiennent la balise HTML <input type=hidden name=indexname value=ixname>
  2. Pour chaque valeur ixname, entrez la commande suivante au niveau de l'invite :
    nqreset ixname
  3. Faites une nouvelle tentative de recherche après avoir redéfini tous les index concernés. Si l'erreur de recherche persiste ou se produit à nouveau ultérieurement, prenez contact avec le support technique IBM.

10.0 Réinstallation de NetQuestion

La seule solution pour que l'aide fonctionne correctement consiste parfois à désinstaller puis réinstaller NetQuestion et à reconfigurer l'aide des produits faisant appel au système d'aide VisualAge. La désinstallation de NetQuestion peut entraîner la suppression des index de recherche des produits qui n'utilisent pas le système d'aide VisualAge (IBM DB2, par exemple) et interdire ensuite les recherches dans l'aide de ces produits une fois NetQuestion réinstallé. Il peut s'avérer nécessaire de réinstaller les produits en question afin de restaurer leurs index de recherche.

Dans toutes les instructions qui vont suivre, lancez les commandes à partir d'une invite. Vous devez avant tout identifier le répertoire d'installation de NetQuestion.

10.1 Lancement de la commande vahcfg remove pour tous les produits répertoriés

Le programme de désinstallation de NetQuestion, uninstnq.exe, situé dans le répertoire NetQuestion, ne supprimera NetQuestion que si aucun index n'est enregistré. Si vous voulez supprimer d'abord tous les index enregistrés par les produits utilisant le système d'aide IBM VisualAge, lancez la commande vahcfg remove pour chacun de ces produits. Procédez comme suit :

  1. Lancez la commande vahcfg list /f %IMNINSTSRV% | more et notez le nom de chaque produit (comme indiqué à la section 6.0 Reconfiguration de l'aide).
  2. Pour chaque nom de produit, lancez la commande vahcfg remove /p nomprod /f %IMNINSTSRV%

10.2 Suppression de tous les index restants

Après avoir supprimé tous les produits de ce type, vous pouvez vérifier s'il existe encore des index enregistrés pour d'autres produits en entrant la commande suivante :

imnixlst

Si la liste générée contient des entrées commençant par DB2, CXX ou VAC, il existe probablement des index enregistrés dans des produits tels que DB2, IBM C, C++ Compilers ou VisualAge C++ 4.0 qui n'utilisent pas le système d'aide VisualAge. Une désinstallation manuelle de NetQuestion provoque la suppression de tous ces index et il est alors nécessaire de réinstaller les produits correspondants afin d'autoriser les recherches dans l'aide de ces produits. Si de tels index apparaissent encore dans la liste et que vous êtes prêt à renoncer aux fonctions de recherche dans ces produits ou à réinstaller ces produits, procédez à la suppression des index restants en procédant de la manière suivante :

Si des index dont les noms commencent par IVJ3, VJ32, IWZ ou VA45 apparaissent dans la liste, il est possible de les supprimer sans risque dans la mesure où ils pourront être restaurés à l'aide de la commande vahcfg install.

Si une erreur NetQuestion vous empêche de supprimer tous les index restants, il peut s'avérer nécessaire de supprimer manuellement NetQuestion (reportez-vous à la section 11.4 ci-après).

10.3 Lancement de la commande uninstnq

Lancez la commande uninstnq et, au bout de quelques minutes, vous pourrez constater que le répertoire NetQuestion est pratiquement vide. Ce dernier ne doit contenir aucun fichier commençant par imn* ou imq*. Il faudra peut-être patienter dix minutes avant d'obtenir ce résultat. Si, passé ce délai, le répertoire contient encore des fichiers imn* ou imq*, il existe probablement des index enregistrés dans le service de recherche (reportez-vous à la section 11.2) ou l'installation de NetQuestion est altérée (reportez-vous dans ce cas à la section 11.4). Sinon, réinitialisez le système et reportez-vous à la section 11.5.

10.4 Suppression manuelle de NetQuestion

Si vous ne pouvez pas supprimer NetQuestion à l'aide de la commande uninstnq.exe, utilisez la procédure manuelle :

  1. Exécutez le programme regedit à partir d'une invite de commande ou à partir de l'option de menu Démarrer > Exécuter.
  2. Développez l'entrée de registre HKEY_LOCAL_MACHINE\Software\IBM.
  3. Supprimez l'entrée NetQuestion et toutes ses sous-entrées.
  4. Supprimez le nom de répertoire NetQuestion dans la variable d'environnement PATH.
  5. Supprimez la variable d'environnement IMNINSTSRV.
  6. A partir d'une invite de commande, placez-vous dans le répertoire NetQuestion et supprimez tous les fichiers correspondant aux spécifications définies ci-dessous à l'aide des caractères génériques :
    del http*.* 302.* 404.* 500.* im*.* nq*.*
  7. Supprimez le sous-répertoire "instance" à partir de l'explorateur ou en entrant la commande suivante :
    rmdir /s /q instance
  8. Réinitialisez le système.

Pour modifier ou supprimer des variables d'environnement, suivez la procédure adaptée à la plateforme utilisée :

10.5 Réinstallation de NetQuestion

Pour réinstaller NetQuestion, vous devez disposer du CD-ROM du produit ou d'un fichier d'installation NetQuestion compressé fourni par le support technique IBM. Le CD-ROM des produits suivants contiennent une copie installable de NetQuestion :

Pour savoir si le CD-ROM des autres produits contient une copie installable de NetQuestion, recherchez un fichier appelé ntq_sbcs.iss. Le répertoire dans lequel se trouve ce fichier doit contenir un fichier setup.exe permettant de lancer l'installation de NetQuestion.

Si IBM vous a fait parvenir un fichier d'installation compressé, décompressez-le dans un répertoire temporaire.

Une fois que êtes en possession d'une copie installable de NetQuestion, suivez la procédure ci-dessous :

  1. Pour lancez le programme setup.exe, cliquez deux fois dessus dans l'explorateur ou, à partir d'une invite de commande, placez-vous dans le répertoire contenant le code d'installation de NetQuestion et entrez setup.
  2. Choisissez une installation complète.
  3. Remplacez le répertoire par défaut par le répertoire d'installation d'origine de NetQuestion. Si vous remplacez le répertoire par défaut par un autre, assurez-vous que le nom du nouveau répertoire ne comporte pas plus de 8 caractères, qu'il ne contient pas d'espace et se trouve à la racine d'une unité. Les risques d'incident susceptibles de se produire dans l'aide sont ainsi limités. 
  4. Réinitialisez le système une fois l'installation terminée.
  5. Si l'ancien et le nouveau répertoire NetQuestion sont différents, copiez vers ce dernier le fichier d'en-tête et de bas de page du formulaire de recherche, les fichiers .gif, les fichiers du programme de recherche et les fichiers d'aide (vah*.exe, vahwebx.cat). Pour obtenir des informations sur ces fichiers, reportez-vous à la section 4.0 Erreurs Fichier non trouvé.

10.6 Nouvelle configuration de l'aide des produits installés

Pour chaque produit supprimé manuellement dans le système d'aide (à l'aide de la commande vahcfg remove, comme indiqué à la section 11.1), lancez la commande vahcfg install, comme indiqué à la section 6.0 Nouvelle configuration de l'aide. Vous devez être en mesure de naviguer et d'effectuer des recherches dans l'aide de votre produit. Si des erreurs continuent à se produire, recherchez des solutions possibles dans les autres sections du présent document ou contactez le support technique IBM.

11.0 Création d'une icône de lancement de l'aide du produit

Si vous ne pouvez pas accéder à l'aide à partir de l'interface utilisateur du produit, créez une icône qui, en cliquant deux fois dessus, donne accès à l'aide. Vous avez ainsi la possibilité de consulter l'aide lors de la résolution des incidents.

Remarques

  1. Les informations fournies dans cette section ne s'appliquent pas à Component Broker. Le menu Démarrer contient déjà une entrée correspondant à la bibliothèque en ligne Component Broker à partir de laquelle il est possible de lancer l'aide du produit.
  2. En ce qui concerne Websphere Development Tools for AS/400, le menu Démarrer contient déjà des entrées permettant de lancer l'aide du produit (Démarrer - Programmes - IBM Websphere Development Tools for AS/400 - Documentation). Vous pouvez aussi créer une icône sur le bureau en suivant la procédure décrite plus loin.
  3. En ce qui concerne VisualAge TPF for Windows NT, exécuté sur des machines où l'aide est installée en local, le menu Démarrer contient déjà une entrée permettant de lancer l'aide du produit. Si vous voulez accéder à distance à l'aide ou ajouter une icône sur le bureau en plus de l'accès à partir du menu Démarrer, suivez la procédure ci-dessous.

Pour créer un raccourci afin de lancer l'aide du produit, procédez comme suit :

  1. Placez le curseur sur la barre de tâches, cliquez sur le bouton droit de la souris et sélectionnez Réduire toutes les fenêtres.
  2. Placez le curseur sur un emplacement vide du bureau, cliquez sur le bouton droit de la souris et sélectionnez Nouveau - Raccourci.
  3. Dans la boîte de dialogue Création d'un raccourci, cliquez sur Parcourir pour rechercher le répertoire d'installation du produit.
  4. Dans ce répertoire ou dans l'un de ses sous-répertoires, recherchez le fichier vahelp.exe. Pour VisualAge for Java, ce fichier se trouve dans le répertoire eab\bin.
  5. Cliquez deux fois sur le fichier vahelp.exe. La zone d'entrée Ligne de commande de la boîte de dialogue Création d'un raccourci contient désormais le chemin d'accès complet au fichier vahelp.exe (entre guillemets si le chemin contient des espaces).
  6. Modifiez la zone d'entrée Ligne de commande et ajoutez l'instruction suivante (en entrant un espace avant) à la fin de la ligne :
    instance "REP_INSTALL\REP_DOC\FICHIER_CONFIG" open index.htm

    où REP_INSTALL est le répertoire d'installation du produit, REP_DOC est le répertoire contenant la documentation ou l'aide et FICHIER_CONFIG est le nom du fichier de configuration de l'aide du produit (ivjhlp.cfg pour VisualAge for Java ; pour obtenir des informations sur les noms des fichiers de configuration des autres produits, reportez-vous à section 2.0 Rien ne se passe lorsque vous tentez de lancer l'aide). Si le chemin d'accès au fichier de configuration contient des espaces, assurez-vous qu'il est entre guillemets.

  7. Cliquez sur Suivant.
  8. Entrez le nom du raccourci, par exemple "Aide en ligne d'IBM VisualAge for Java".
  9. Cliquez sur Terminer.
  10. Cliquez deux fois sur le raccourci que vous venez de créer pour vérifier s'il fonctionne.
  11. Pour modifier l'apparence de l'icône de raccourci, cliquez dessus avec le bouton droit, sélectionnez Propriétés, puis, dans l'onglet Raccourci, sélectionnez Changer d'icône et parcourez la liste des icônes disponibles ou recherchez une nouvelle icône dans le système de fichiers.

Si vous voulez ajouter la nouvelle icône dans le menu Démarrer, cliquez dessus avec le bouton droit, choisissez Copier dans le menu en incrustation, puis, dans l'explorateur Windows, accédez au répertoire d'installation de Windows, sous ...\Profiles\All Users\Menu Démarrer et collez l'icône dans ce répertoire ou dans un de ses sous-répertoires.

12.0 Configuration du système d'aide sur un serveur Windows

Vous pouvez installer et configurer le système d'aide sur un serveur Web Windows NT ou Windows 2000 de manière à ce que les autres membres de votre entreprise puissent accéder à l'aide en ligne sur le réseau et y faire des recherches sans devoir utiliser ni NetQuestion ni le code du système d'aide installé sur leurs postes de travail.

Remarques relatives aux produits

  1. Pour VisualAge COBOL et VisualAge TPF, les utilisateurs ont la possibilité de ne pas installer NetQuestion ou le système d'aide en local. Pour les autres produits, les utilisateurs peuvent supprimer les copies en local en suivant la procédure décrite aux sections 6.0 Nouvelle configuration de l'aide et 10.0 Réinstallation de NetQuestion.
  2. Pour VisualAge TPF, le produit livré intègre des utilitaires permettant de configurer l'aide pour un accès à partir du serveur. Si vous effectuez l'installation à partir du fichier setup.exe installé sur le CD-ROM du produit, vous devez indiquer si d'autres utilisateurs du réseau peuvent avoir accès à l'aide à distance. Répondez Oui. Si vous avez téléchargé le module d'aide à partir du Web, exécutez le programme insthelp.exe.

Pour effectuer cette installation réseau, un logiciel serveur Web, tel que Microsoft Peer Web Services (PWS) ou Microsoft IIS, doit être installé sur le serveur. Le serveur Web doit comporter un répertoire de scripts. (Pour PWS et IIS, le répertoire de scripts est installé dans x:\inetpub.) Après avoir installé le logiciel serveur, suivez la procédure ci-dessous :

  1. Installez le logiciel IBM sur le serveur.
  2. Si le répertoire NetQuestion contient les fichiers suivants, copiez ces derniers dans le répertoire x:\inetpub\scripts :
    vahwebx.exe
    vahwebx.cat
    vahelp.cfg
    *foot.htm
    *head.htm
    *henus.htm

    Les trois premiers fichiers sont obligatoires, contrairement aux autres qui, s'ils ne se trouvent dans le répertoire NetQuestion, n'ont pas besoins d'être copiés dans le répertoire x:\inetpub\scripts.

  3. Modifiez le fichier imnmap.dat qui se trouve dans le répertoire %IMNINSTSRV%\instance\help\data\. Ce fichier contient la première partie de l'adresse Web de chaque index. Remplacez toutes les occurrences de la sous-chaîne http://localhost:49213/cgi-bin par http://serveur.ville.domaine.société/scripts (comme par exemple http://cobweb.stl.ibm.com/scripts). A la suite de cette modification, les liens générés pour les recherches désignent une adresse Web éloignée (différente de localhost) afin qu'un utilisateur puisse accéder à ces liens à partir de n'importe quel ordinateur.
  4. Modifiez les fichiers suivants qui ont été créés dans le répertoire d'aide du produit : hgssrch.htm et hgcsrch.htm. Remplacez http://localhost:49213/cgi-bin par http://serveur.ville.domaine.société/scripts.
  5. Copiez le programme CGI de recherche indiqué (fichiers iwzihenes.exe, ivjsenus.exe et va4sall.exe) dans les formulaires de recherche du répertoire NetQuestion vers le répertoire x:\inetpub\scripts.
  6. Copiez le fichier *star*.gif vers un nouveau sous-répertoire d'icônes, sous x:\inetpub\wwwroot.
  7. Pour Component Broker, modifiez la configuration de la variable d'environnement VABHELP en remplaçant http://localhost:49213/cgi-bin par http://serveur.ville.domaine.société/scripts. Pour les produits autres que Component Broker, chaque utilisateur doit modifier le fichier de configuration du produit (*.cfg situé dans le répertoire d'aide du produit) et attribuer aux entrées suivantes les valeurs ci-dessous :

HTML_HOSTNAME=serveur.ville.domaine.société
CGI_BIN_DIR=scripts
START_LITE_DAEMON=0
START_NETQ_DAEMON=0

Les utilisateurs peuvent alors accéder à l'aide installée sur le serveur en appuyant sur la touche F1 ou en sélectionnant l'option de menu Aide dans leur application IBM. Ils ont également la possibilité d'utiliser l'URL suivante pour accéder à l'aide :

http://NomHôte/scripts/vahwebx.exe/help/nomprod/Extract/0/index.htm

nomprod correspond à :

Si vous êtes amené ultérieurement à lancer la commande vahcfg install ou vahcfg regen sur le serveur, vous devez à nouveau modifier le fichier de mappage comme indiqué à l'étape 3 présentée plus haut.

Après avoir modifié les fichiers de configuration d'aide du produit de manière à ce qu'ils désignent le serveur, les utilisateurs peuvent lancer en toute sécurité la commande suivante permettant de supprimer tous les fichiers *.toc, *.htm et *.zip, ainsi que les fichiers d'index de recherche dans le répertoire d'aide du produit :

vahcfg remove /p nomprod /f %IMNINSTSRV%

Les utilisateurs peuvent également supprimer manuellement les fichiers *.toc, *.htm et *.zip. Cette méthode ne supprime pas les répertoires d'index situés dans le répertoire d'aide du produit et il est donc nécessaire de les effacer manuellement.

13.0 Démarrage automatique des serveurs NetQuestion

Si vous configurez le serveur dans une configuration d'aide en réseau, reportez-vous plutôt à la section 14.0 Lancement du service de recherche NetQuestion au démarrage.

Vous pouvez configurer le serveur HTTP et le serveur de recherche de manière à ce qu'ils démarrent automatiquement à la connexion en définissant deux entrées de registre sur le système. Pour définir ces entrées, procédez comme suit :

  1. A l'aide d'un éditeur de texte, tel que le Bloc-notes, créez un fichier appelé NetQuestionAutoStart.reg. Entrez le texte suivant (en utilisant la fonction copier-coller) :
    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. Modifiez la valeur de la chaîne %IMNINSTSRV% dans la version du produit en la remplaçant par celle du répertoire d'installation de NetQuestion.
  3. Sauvegardez le fichier.
  4. Cliquez deux fois sur le fichier NetQuestionAutoStart.reg à partir de l'explorateur Windows.

Deux entrées sont importées dans le registre afin que les serveurs démarrent automatiquement lors de votre prochaine connexion (ou de la prochaine réinitialisation sous Windows 95, Windows 98 ou Windows ME).

14.0 Lancement du service de recherche NetQuestion au démarrage

Si vous utilisez une configuration d'aide en réseau où l'aide est installée sur le serveur et non sur votre machine locale, des incidents risquent de se produire lorsque vous effectuez des recherches sur la machine éloignée. Lorsque le démon de recherche NetQuestion est configuré pour un lancement automatique (dès l'installation du produit ou après l'exécution de la procédure décrite à la section 13.0 Démarrage automatique des serveurs NetQuestion), il n'est lancé qu'au moment où un utilisateur se connecte au serveur. Ainsi, après une réinitialisation du système, le démon de recherche n'est pas exécuté tant qu'un utilisateur de la machine ne s'est pas connecté. Vous pouvez cependant utiliser le Planificateur de tâches Windows pour lancer le démon de recherche au démarrage. Les instructions présentées dans cette section s'appliquent à la machine sur laquelle l'aide est installée.

Remarque : Si vous n'utilisez pas une configuration d'aide en réseau, la procédure décrite dans cette section ne s'applique pas.

Vous devez avant tout identifier le répertoire d'installation de NetQuestion. Un nettoyage manuel du registre peut également s'avérer nécessaire. Le registre peut en effet contenir des entrées destinées à lancer le démon de recherche NetQuestion lors de la connexion. Si vous souhaitez que le démon soit lancé au démarrage, cette entrée de registre est superflue. Pour nettoyer le registre, procédez comme suit :

  1. Dans le menu Démarrer, sélectionnez Exécuter.
  2. Entrez regedit et cliquez sur OK.
  3. Dans l'arborescence, sélectionnez HKEY_LOCAL_MACHINE - SOFTWARE - Microsoft - Windows - CurrentVersion - Run
  4. Dans la sous-fenêtre située à droite du dossier Run, sélectionnez et supprimez la clé suivante :
  5. Si vous ne souhaitez pas accéder directement à l'aide sur le serveur, vous pouvez supprimer l'entrée de démarrage automatique du serveur HTTP NetQuestion. Pour cela, sélectionnez et supprimez la clé suivante :
  6. Fermez l'éditeur du registre.

Vous pouvez maintenant configurer Windows de manière à ce que les serveurs démarrent lors de la réinitialisation. Vérifiez d'abord que le serveur sur lequel est installée l'aide comporte le Planificateur de tâches Microsoft Windows :

  1. Ouvrez l'explorateur Windows.
  2. Recherchez les sous-dossiers contenus dans le dossier Poste de travail. Si vous trouvez, au même niveau que les unités locales et réseau, un dossier appelé Tâches planifiées, le Planificateur de tâches est installé sur votre machine. Passez à l'étape 5.
  3. Si le Planificateur de tâches n'est pas installé sur votre machine, vous devez procéder à son installation. Le Planificateur de tâches est intégré à Internet Explorer. Ce nouveau composant qui fait partie de la catégorie "Améliorations supplémentaires de Internet Explorer" doit être installé. La méthode à suivre pour ajouter des composants dans Internet Explorer varie en fonction de la version d'Internet Explorer et de Windows que vous utilisez. Pour plus de détails, reportez-vous au document "How to Add and Remove Internet Explorer Components", disponible à l'adresse http://support.microsoft.com/support/kb/articles/Q171/2/29.ASP.
  4. Après avoir installé le Planificateur de tâches, réinitialisez le système, si nécessaire, et ouvrez Poste de travail.

Pour configurer le serveur de recherche NetQuestion de manière à ce qu'il démarre à la réinitialisation sur le serveur de l'aide, procédez comme suit :

  1. Dans le dossier Tâches planifiées, cliquez sur Création d'une tâche planifiée.
  2. L'assistant du même nom s'affiche. Cliquez sur Suivant pour continuer.
  3. Sélectionnez un programme au hasard dans la liste (vous ferez un autre choix ultérieurement) et cliquez sur Suivant.
  4. Attribuez un nom à la tâche. Par exemple, "Serveur de recherche NetQuestion".
  5. Sélectionnez le bouton d'option Au démarrage de mon ordinateur et cliquez sur Suivant.
  6. Entrez le nom d'utilisateur du propriétaire du processus (l'administrateur du serveur, par exemple), ainsi que son mot de passe. Cliquez sur Suivant.
  7. Cochez la case Ouvrir les propriétés avancées de cette tâche lorsque je cliquerai sur 'Terminer'.
  8. Cliquez sur Fin.
  9. La page des propriétés du serveur de recherche NetQuestion s'affiche. Dans l'onglet Tâche, remplacez le contenu de la zone Exécuter par REP_NQ\imnss.exe start server
    REP_NQ correspond au répertoire d'installation de NetQuestion.
  10. Dans la zone Commencer dans, entrez le répertoire d'installation de NetQuestion.
  11. Assurez-vous que la case Activée est cochée.
  12. Dans l'onglet Paramètres, décochez la case Arrêter la tâche si elle s'exécute durant xxx heure(s) xxx minute(s).

Remarque : Une fois que le serveur sur lequel l'aide est installée a été réinitialisé, le serveur de recherche peut démarrer une minute environ seulement après l'affichage de l'écran de connexion.

15.0 Recherche du répertoire d'installation de NetQuestion

Vous pouvez connaître l'emplacement du répertoire d'installation de NetQuestion en ouvrant une invite de commande et en entrant :

set IMNINSTSRV

Cette commande renvoie le répertoire recherché. Si la variable n'est pas définie, vous pouvez rechercher le répertoire d'installation en consultant le registre Windows. Entrez regedit au niveau d'une invite de commande et développez les entrées de registre HKEY_LOCAL_MACHINE\SOFTWARE\IBM\NetQuestion\CurrentVersion\Installation Directory. L'entrée "Directory" correspondant à cette clé doit désigner le répertoire d'installation de NetQuestion.

Si la variable d'environnement IMNINSTSRV n'est pas définie sous Windows 95, Windows 98 et Windows ME et que vous avez utilisé le registre pour trouver le répertoire, il peut s'avérer nécessaire de modifier le fichier autoexec.bat. (Si ce cas de figure se produit sous Windows Millennium Edition, reportez-vous à la section 17.0 Remarques s'appliquant à Windows Millennium Edition.) Au cours du processus d'installation de NetQuestion, le fichier autoexec.bat a été modifié par l'ajout d'une commande permettant d'appeler le fichier de commandes imnenv.bat enregistré dans le répertoire NetQuestion. La commande ajoutée est la suivante :

if exist _REP_NETQ_\imnenv.bat call _REP_NETQ_\imnenv.bat

Si cette ligne n'existe pas ou si _REP_NETQ_ désigne un répertoire erroné, ajoutez cette ligne sur laquelle figure le répertoire NetQuestion correct. Assurez-vous également que le fichier de commandes imnenv.bat appelé dans le fichier autoexec.bat existe et qu'il contient des entrées désignant le répertoire en cours et non pas un autre répertoire NetQuestion. Le contenu du fichier imnenv.bat doit être le suivant :

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

16.0 Définition d'associations de fichiers HTML dans le registre Windows

Si l'aide ne peut être lancée ni à partir du navigateur ni à partir d'une invite de commande, l'association de fichiers définie pour les fichiers HTML est probablement incorrecte. Le code client du système d'aide utilise les entrées du registre pour déterminer, en fonction de ces associations de fichiers, le navigateur par défaut. Vous pouvez vérifier les associations de fichiers à l'aide de l'éditeur du registre :

  1. Dans le menu Démarrer, sélectionnez Exécuter.
  2. Dans la boîte de dialogue Exécuter, entrez regedit.
  3. Dans l'éditeur du registre, développez HKEY_CLASSES_ROOT.
  4. Recherchez l'entrée .htm. La valeur par défaut de cette entrée est "NetscapeMarkup" (si Netscape est utilisé par défaut) ou "htmlfile" (si Internet Explorer est utilisé par défaut).

S'il n'existe aucune entrée de ce type, vous pouvez l'ajouter de la manière suivante :

  1. Lancez le navigateur à enregistrer en tant que navigateur par défaut du système.
  2. Si une boîte de dialogue s'affiche dans le navigateur pour vous demander si ce dernier doit devenir le navigateur par défaut, répondez oui. Sinon, vous pouvez configurer le navigateur de manière à ce que cette question vous soit posée lors de son prochain lancement :

    Pour Netscape Communicator :

    1. Fermez toutes les fenêtres Netscape.
    2. Recherchez le fichier de préférences, prefs.js. Il se trouve généralement dans un sous-répertoire du répertoire d'installation du produit Netscape. Son chemin d'accès est généralement le suivant : Répertoire_installation_Netscape\users\nomutilisateur\prefs.js où nomutilisateur correspond à "default" ou au nom sous lequel vous vous êtes connecté à Windows.
    3. Modifiez le fichier en utilisant un éditeur de texte à plat et supprimez la ligne suivante :
      user_pref("browser.wfe.ignore_def_check", true);
    4. Sauvegardez le fichier (au format texte si vous avez utilisé WordPad).
    5. Relancez Netscape et enregistrez-le en tant que navigateur par défaut.

    Pour Internet Explorer :

    1. Recherchez l'option de menu Options ou Options Internet. Selon la version Internet Explorer utilisée, les options du navigateur sont disponibles à partir du menu Outils, Fichier ou Affichage.
    2. Cliquez sur l'onglet Programmes de la boîte de dialogue.
    3. Cochez la case Au démarrage, vérifier si Internet Explorer est le navigateur par défaut.
    4. Quittez Internet Explorer.
    5. Relancez Internet Explorer et enregistrez-le en tant que navigateur par défaut.

17.0 Remarques relatives à Windows Millennium Edition

Si vous utilisez Windows Millennium Edition, les modifications apportées au fichier autoexec.bat pour le chargement des variables d'environnement NetQuestion peuvent ne pas prendre effet même une fois le système réinitialisé. Les modifications peuvent disparaître après la réinitialisation. De cette manière, les variables d'environnement peuvent rester non définies, ce qui peut provoquer les erreurs suivantes :

Vous pouvez déterminer si ces erreurs sont à l'origine des incidents dans l'aide en vérifiant, après la réinitialisation, si les variables d'environnement sont correctement définies. Si elles ne sont pas définies, vous pouvez utiliser le programme msconfig.exe qui se trouve dans le répertoire du système Windows, afin d'apporter les modifications d'environnement suivantes :

18.0 Remarques relatives à Component Broker

Component Broker n'utilise pas la partie client du système d'aide de VisualAge, partie qui lance l'aide lorsque vous appuyez sur F1 ou lorsque vous sélectionnez le menu Aide dans l'interface utilisateur. En voici deux implications :

Component Broker offre des informations supplémentaires sur la résolution des incidents de l'aide dans le répertoire doc\readme.

19.0 Remarques relatives aux systèmes DBCS

Sur les systèmes sur lesquels l'aide installée est en partie ou totalement rédigée en chinois simplifié (environnement local zh_CN), taïwannais (zh_TW), coréen (ko_KR) ou japonais (ja_JP), vous devez apporter les modifications suivantes aux commandes vahcfg et NetQuestion :

Ces modifications sont requises car NetQuestion utilise des fichiers exécutables et des serveurs différents pour ses systèmes de recherche utilisant des caractères à simple octet ou des caractères à double octet.