Resolución de problemas de la ayuda en los productos WebSphere y VisualAge

El sistema de ayuda de VisualAge permite la visualización de información de ayuda en línea para diversos productos de software IBM. Al pulsar F1 o seleccionar la opción de menú Ayuda desde la interfaz de usuario de uno de estos productos, debe abrirse un navegador y visualizarse ayuda para el producto. Si tiene problemas al iniciar o utilizar la ayuda en línea del producto, este documento puede ayudarle a resolverlos.

El sistema de ayuda de VisualAge consta de tres componentes principales:

En la mayoría de los casos, los tres componentes se ejecutan en la máquina en la que está instalado el producto.

1.0 Dónde empezar

Para empezar a resolver el problema, siga estos tres pasos:

  1. Determine si este documento puede ayudarle, leyendo la sección 1.1 Productos que utilizan el sistema de ayuda de VisualAge

  2. Lea el resumen 1.2 Consideraciones especiales y, a continuación, lea las secciones que aparezcan en la lista y que hagan referencia a su producto o entorno

  3. Inicie el análisis del problema propiamente dicho en la sección 1.3 ¿Cuáles son los síntomas?

1.1 Productos que utilizan el sistema de ayuda de VisualAge

Los siguientes productos IBM utilizan el sistema de ayuda de VisualAge a partir de Febrero de 2001:

Si utiliza un producto de software IBM comercializado después de Noviembre de 2000 y no se encuentra en la lista anterior, puede determinar si dicho producto utiliza el sistema de ayuda de VisualAge escribiendo lo siguiente en un indicador de mandatos: 

vahcfg list /f %IMNINSTSRV% | more

y buscando el nombre del producto en las líneas que empiezan por Product:. Si el producto aparece en la lista, significa que utiliza el sistema de ayuda de VisualAge. Si no aparece en la lista, o si obtiene un mensaje que indica que el mandato no se ha reconocido, puede ponerse en contacto con el servicio de soporte de IBM para determinar si el producto IBM utiliza el sistema de ayuda de VisualAge.

1.2 Consideraciones especiales

Debe leer las secciones siguientes si el producto, entorno o problema descrito coincide con su situación:

1.3 ¿Cuáles son los síntomas?

En el menú de ayuda del producto, elija la página inicial de ayuda (o la opción de menú correspondiente al producto). Si no hay ningún menú de ayuda disponible, intente pulsar F1 desde uno de los paneles de la interfaz de usuario del producto. ¿Qué ocurre?

  1. Nada - vaya a la sección 2.0 No ocurre nada al intentar iniciar la ayuda
  2. Se abre un navegador, pero:
    1. No puede conectarse a localhost:49213 - vaya a la sección 3.0 Conexión al servidor localhost:49213
    2. No puede conectarse a un sistema principal remoto, y el usuario está utilizando ayuda servida remotamente - compruebe que el servidor web del sistema principal remoto se haya iniciado y esté configurado correctamente
    3. Recibe un error Archivo no encontrado - vaya a la sección 4.0 Errores de Archivo no encontrado
    4. Recibe otros mensajes que indican que faltan archivos durante durante una búsqueda, o que hay enlaces de imagen rotos en la página de resultados de búsqueda - vaya a la sección 4.3 Otros errores de búsqueda que implican archivos que faltan
    5. Recibe un mensaje de Error interno del servidor o un diálogo de mensaje de Error de aplicación - vaya a la sección 5.0 Mensajes de error interno del servidor
  3. Recibe el mensaje El producto xxxxx es desconocido para el sistema de ayuda - vaya a la sección 6.0 Reconfiguración de la ayuda
  4. Recibe un mensaje que le indica que utilice un navegador capaz de manejar marcos - actualice el navegador por omisión a Netscape 4.7 o posterior, o bien Internet Explorer 5 o posterior.
  5. La ayuda se visualiza correctamente.

Si la ayuda se visualiza correctamente, las dos cuestiones potenciales restantes son:

  1. Desea acceder a la ayuda en un sistema remoto. Consulte la sección 12.0 Configuración del sistema de ayuda en un servidor Windows.
  2. La función de búsqueda de la ayuda no funciona. Intente entrar una consulta de búsqueda en el campo de entrada de búsqueda. ¿Qué ocurre?
    1. Nada - el navegador queda suspendido y no se recibe ninguna respuesta, por lo menos durante un largo tiempo - vaya a la sección 7.0 Problemas de tiempo de espera durante la búsqueda
    2. Recibe un error Archivo no encontrado - vaya a la sección 4.0 Errores de Archivo no encontrado
    3. Recibe un mensaje de Error interno del servidor - vaya a la sección 5.0 Mensajes de error interno del servidor
    4. Recibe un mensaje que contiene rc=73 o La petición de búsqueda estaba vacía - vaya a la sección 8.0 Palabras de detención o rc=73
    5. Recibe un mensaje que contiene rc=32 o algún otro mensaje de de error de búsqueda - vaya a la sección 9.0 Otros errores de búsqueda

Si el problema no es uno de los anteriores, póngase en contacto con el servicio de soporte de IBM.  Consulte él sitio web http://www.ibm.com/software/ad/support para obtener más información.

2.0 No ocurre nada al intentar iniciar la ayuda

Nota: esta sección no se aplica a Component Broker ni a WebSphere Business Components. Con respecto a Component Broker, consulte la información relativa a resolución de problemas de ayuda del directorio doc\readme.

Si no ocurre nada con VisualAge para Java, Versión 3.5 y utiliza un icono de escritorio para abrir el IDE de VisualAge para Java, consulte la sección 2.1 Caso especial  - VisualAge para Java, Versión 3.5.

Si no ocurre nada cuando intenta abrir la ayuda, el primer paso debe ser determinar si puede abrir la ayuda desde la línea de mandatos. Para ello, primero necesitará conocer en qué directorio ha instalado el producto. En el texto que sigue, siempre que aparezca DIR_INSTAL, debe sustituirlo por el directorio real en el que está instalado el producto, por ejemplo, x:\ibmvjava o "x:\Program Files\IBM\VisualAge for Java". Utilice apóstrofos para incluir toda la vía de acceso (DIR_INSTAL más cualquier subdirectorio o nombre de archivo) cuando la vía de acceso contenga espacios. Siga estos pasos para intentar abrir la ayuda desde la línea de mandatos:

  1. Abra una ventana de mandatos.
  2. Cambie a la unidad lógica en la que está instalado el producto, y luego al directorio de dicha unidad. Por ejemplo, si el producto está instalado en "g:\Program Files\IBM\VisualAge for Java", escriba lo siguiente: 
    g:
cd "\Program Files\IBM\VisualAge for Java"
  3. Cambie al directorio situado por debajo del directorio del producto, donde se encuentra el archivo ejecutable vahelp.exe. Puede determinar la ubicación escribiendo primero: 
    dir /s /b vahelp.exe

    Si la respuesta es: 

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

    A continuación, escriba:

    cd eab\bin
  4. Emita el siguiente mandato (los apóstrofos sólo son necesarios si la vía de acceso contiene espacios):

Si la ayuda se abre satisfactoriamente desde la línea de mandatos y puede buscar la ayuda satisfactoriamente, puede que exista un problema en la forma en que está configurada la vía de acceso, que impide que la interfaz de usuario del producto se conecte a la DLL del sistema de ayuda. Consulte la sección 2.1 Caso especial  - VisualAge para Java 3.5, o, para otros productos, intente desinstalar y volver a instalar el producto, ya que dicha acción resuelve a veces problemas de ese tipo.

Si está satisfecho con la apertura de la ayuda desde la línea de mandatos como solución o arreglo temporal, puede crear un icono en el escritorio para hacerlo. Consulte la sección ç11.0 Creación de un icono para abrir la ayuda del producto.

Si la ayuda no se carga desde la línea de mandatos, o si se carga pero no desde el interior del producto, puede que no tenga configuradas las asociaciones de archivo adecuadas para el navegador dentro del registro de Windows. Consulte la sección 16.0 Establecer asociaciones de archivo HTML en el registro de Windows.

Si cambiar las asociaciones de archivo tampoco resulta de utilidad, puede intentar lo siguiente para obtener un archivo de anotaciones del sistema de ayuda:

  1. Edite el archivo de configuración de ayuda del producto (DIR_INSTAL\DIR_AYUDA\ARCHIVO_CONFIG) en un editor de texto (por ejemplo, Notepad) y añada la siguiente línea al final del archivo:
    HTMLHELP_LOG=1
  2. Guarde el archivo. Tenga cuidado de guardarlo como texto plano si utiliza un editor como WordPad.
  3. Salga y reinicie el producto IBM.
  4. Pulse F1 o utilice el menú Ayuda para intentar abrir la ayuda desde dentro del producto.

En el directorio al que señala la variable de entorno TMP, debe ver uno o varios archivos de tipo HTML*.C2T. Estos archivos contienen información de anotaciones detallada acerca de las peticiones efectuadas al sistema de ayuda. Puede enviar estos archivos al servicio de soporte de IBM para que los analicen. Las peticiones de soporte pueden estar sujetas al pago de una tasa. También puede intentar examinar estos archivos por su cuenta para ver si puede determinar la causa de la anomalía.

Si no ve ningún archivo HTML*.C2T en el directorio TMP, intente llamar de nuevo a la ayuda desde la línea de mandatos. Si los archivos HTML*.C2T sólo se crean desde la línea de mandatos, el problema existe cuando el producto llama a la ayuda. Si ninguno de los métodos de llamada a la ayuda produce archivos de anotaciones, el problema reside en el propio sistema de ayuda. En cualquier caso, póngase en contacto con el servicio de soporte de IBM.

Recuerde que debe eliminar la línea HTMLHELP_LOG=1 del archivo de configuración de ayuda del producto cuando haya terminado, ya que la anotación produciría archivos de anotaciones innecesarios cada vez que solicitara ayuda.

Si sigue sin poder abrir la ayuda con ninguno de los métodos, compruebe que el archivo de configuración de ayuda del producto siga siendo válido. Abra DIR_INSTAL\DIR_AYUDA\DIR_CONFIG en un editor y verifique que:

2.1 Caso especial - VisualAge para Java, Versión 3.5

En VisualAge para Java, Versión 3.5, si no puede abrir la ayuda desde el IDE, pero sí desde la línea de mandatos, puede que esté llamando al IDE mediante un acceso directo incorrecto.  Esto ocurre si crea o edita manualmente un acceso directo al IDE en el escritorio o dentro del menú Inicio, y llama al IDE desde dicho acceso directo. También puede ocurrir si utiliza un acceso directo creado para la Versión 3.0 o 3.02, y en este momento lo utiliza para abrir la Versión 3.5. Para determinar si este es el problema, siga estos pasos:

  1. Salga de cualquier sesión del IDE de VisualAge para Java que esté en ejecución y espere hasta diez segundos después de que desaparezca la última ventana de VisualAge para Java, para asegurarse de que el programa ha completado el procedimiento de finalización.
  2. Abra el IDE de VisualAge para Java utilizando el menú Inicio (Inicio > Programas > IBM VisualAge para Java para Windows V3.5 > IBM VisualAge para Java).
  3. Pulse F1 dentro del IDE.

Si la ayuda funciona cuando llama al IDE desde el menú Inicio, pero no desde el icono o acceso directo que generalmente utiliza, dicho icono o acceso directo está señalando probablemente a DIR_INSTAL_VAJ\ide\program\ide.exe, que abrirá satisfactoriamente el IDE pero no dará soporte a la ayuda, debido a que la variable de entorno PATH no señala a la DLL del sistema de ayuda.  Puede resolver este problema editando el campo Destino del acceso directo para que señale a DIR_INSTAL_VAJ\ide\program\ivjenv.bat. Este archivo por lotes cambia las variables de entorno Windows de forma que la ayuda funcione correctamente desde el interior del IDE.

3.0 Conexión al servidor localhost:49213

Si al abrir la ayuda se abre o aparece un navegador, pero éste no puede conectarse a localhost:49213, existen tres problemas posibles:

Compruebe cada una de las siguientes subsecciones sucesivamente para resolver los posibles problemas de configuración del navegador o del servidor web.

3.1 HTTPDL.EXE no se está ejecutando

HTTPDL.EXE es un proceso de servidor HTTP que sólo soporta el acceso local. Forma parte del componente NetQuestion. Se utiliza para servir páginas de ayuda al navegador local. Compruebe si el proceso HTTPDL.EXE aparece en la lista de tareas.

Si la tarea no está presente, puede que el sistema de ayuda no haya podido iniciarla. Intente primero llamarla desde la línea de mandatos para ver si devuelve un mensaje de error:

  1. Cambie al directorio en el que está instalado NetQuestion (consulte la sección 15.0 Búsqueda del directorio de instalación de NetQuestion)

  2. Emita el mandato:
    httpdl -r httpd.cnf

Si éste devuelve el error El enlace del socket ha fallado, probablemente un proceso HTTPDL.EXE se está ejecutando en el puerto 49213 (el puerto TCP/IP utilizado por el proceso HTTPDL.EXE). Si devuelve cualquier otro error, póngase en contacto con el servicio de soporte de IBM. Si se devuelve sin ningún error, compruebe la lista de tareas para asegurarse de que se está ejecutando en segundo plano. Las versiones de HTTPDL.EXE fechadas el 02/12/2000 o anteriores bloquean la solicitud de mandato si no detectan ningún error; las versiones posteriores continúan la ejecución sin bloquear la solicitud de mandato. Si su versión bloquea la solicitud de mandato, pulse Control+Interrumpir y emita el siguiente mandato para iniciar el proceso como proceso desconectado en lugar del anterior: 

nqdetach httpdl.exe -r httpd.cnf

Ahora, intente cargar de nuevo la página en el navegador. Si la página se visualiza correctamente, significa que el sistema de ayuda tenía problemas al iniciar el servidor HTTP (o, en Component Broker, que el servidor no está configurado para iniciarse durante el inicio de sesión). Consulte la sección 13.0 Inicio automático de los servidores NetQuestion.

Si la página sigue sin visualizarse, consulte las secciones 3.2 HTTPDL.EXE está mal configurado y 3.3 El navegador necesita alteraciones temporales de proxy.

3.2 HTTPDL.EXE está mal configurado

A veces, el archivo de configuración httpd.cnf, utilizado por HTTPDL.EXE, puede contener información de vía de acceso incorrecta. Siga estos pasos para verificar que esté configurado adecuadamente:

  1. Utilice el diálogo Inicio > Buscar (Inicio > Buscar en Windows 2000) para buscar todos los archivos denominados HTTPDL.EXE en las unidades de disco locales. Verifique que sólo existe una copia. Si existe más de una copia, redenomine las copias que no se encuentren en el directorio de instalación de NetQuestion. (La redenominación permite restaurarlas posteriormente si resultan necesarias, por ejemplo para algún otro servidor web).
  2. Edite el archivo httpd.cnf que aparece en el directorio de instalación de NetQuestion. Busque todas las líneas que contengan información de vía de acceso. habitualmente, las líneas implicadas son las siguientes: 
    Serverroot
C:\IMNNQ_NT
Exec    /cgi-bin/*  C:\IMNNQ_NT\*
Pass    /icons/*    C:\IMNNQ_NT\*
Pass    /*          C:\IMNNQ_NT\*

    Verifique que la vía de acceso indicada corresponde al directorio en el que está almacenado el archivo httpd.cnf. Si no es así, cámbiela en todas las apariciones anteriores para que refleje la vía de acceso real.

  3. Todavía en httpd.cnf, verifique que estén presentes las siguientes entradas: 
    Hostname localhost
Port 49213

    Sustituya cualquier línea Hostname o Port por los valores anteriores, si son distintos.

  4. Si ha efectuado cambios en httpd.cnf en los pasos 2 ó 3, finalice el proceso de HTTPDL.EXE e intente abrir de nuevo la ayuda.  Si esto no soluciona el problema, consulte la sección siguiente.

3.3 El navegador necesita alteraciones temporales de proxy

A veces, el navegador no puede conectarse al servidor web local HTTPDL.EXE debido a que intenta localizar el sistema denominado localhost por medio de un servidor proxy. Esto normalmente ocurre cuando el navegador está definido para configuración manual o automática de proxy. Si utiliza configuración manual de proxy, puede modificar los valores del navegador para evitar que éste intente resolver localhost por medio de un servidor de proxy. Si utiliza la configuración automática de proxy, deberá pedir al propietario del archivo de configuración automática de proxy que añada 127.0.0.1 como excepción de proxy en el servidor de proxy.

Para determinar si el navegador está definido para configuración manual de proxy, y para añadir las alteraciones temporales de proxy si es así, siga estos pasos. Estas instrucciones son para las versiones de navegador indicadas; si utiliza una versión diferente de navegador, el procedimiento puede ser distinto.

Para Netscape 4.7:

  1. En Netscape Communicator, seleccione Editar > Preferencias.
  2. Expanda la entrada Avanzadas en el panel izquierdo pulsando en el símbolo + de la izquierda.
  3. Seleccione la entrada Proxies debajo de Avanzadas.
  4. El marco de la derecha debe indicar si tiene definida la configuración automática o manual del servidor proxy, o bien una conexión directa con Internet. Si tiene definida la configuración manual del servidor proxy, continúe con los siguientes pasos; de lo contrario, deténgase.
  5. Seleccione el botón Ver que está al lado de Configuración manual de proxy.
  6. Asegúrese de que las direcciones localhost:49213 y 127.0.0.1 aparecen en la lista de excepciones de proxy. Asegúrese también que estas direcciones están separadas mediante una coma, y no mediante punto y coma. (En otras versiones de Netscape, asegúrese de que el carácter de separación es el que se identifica en el diálogo. Por ejemplo, el diálogo de Netscape 4.7 contiene el texto Utilizar comas (,) para separar las entradas.) Realice los cambios necesarios y cierre todos los diálogos hasta regresar a la ventana principal del navegador.

En Internet Explorer 5.0:

  1. Desde dentro de Internet Explorer, seleccione Herramientas > Opciones Internet.
  2. En la pestaña Conexiones, pulse Valores LAN.
  3. Si Utilizar un servidor proxy está seleccionado, continúe con los pasos siguientes; de lo contrario, deténgase.
  4. Si ve el recuadro de selección Saltar servidor proxy para direcciones locales, asegúrese de que esté seleccionado.
  5. Seleccione Avanzado
  6. Asegúrese de que las entradas localhost, localhost:49213 y 127.0.0.1 aparecen en la lista de excepciones del servidor proxy, y asegúrese de que están separadas mediante un punto y coma y no mediante una coma. Realice los cambios necesarios y cierre todos los diálogos hasta regresar a la ventana principal del navegador.

También debe actualizar el archivo %SystemRoot%\system32\drivers\etc\hosts añadiendo la siguiente línea:

127.0.0.1     localhost

si el archivo existe pero esa línea todavía no está presente. Si cambia este valor, es posible que tenga que salir y reiniciar el navegador para que este cambio surta efecto.

Si ha realizado cambios en la configuración del navegador o en el archivo "...\etc\hosts", intente volver a cargar la página de presentación de la ayuda en el navegador. Si todavía recibe errores al intentar conectarse a locahost:49213, póngase en contacto con el servicio técnico de IBM.

Si no puede acceder al servidor proxy automático cuando intenta ver la ayuda, es posible que el navegador no puede resolver localhost en la dirección local 127.0.0.1. Puede solucionar temporalmente este problema (mientras el servidor proxy no esté disponible) seleccionado la conexión directa a Internet del paso 4 (Netscape) o del paso 3 (Internet Explorer), descritos más arriba.

4.0 Errores de Archivo no encontrado

Si recibe un error de Archivo no encontrado al intentar ver la ayuda o efectuar una búsqueda, puede que falte un archivo en el directorio de instalación de NetQuestion. Lea las siguientes secciones para obtener más información.

4.1 Errores de Archivo no encontrado al intentar ver la página de presentación u otra ayuda

Si recibe un error de Archivo no encontrado al intentar ver la ayuda, puede que falte el archivo vahwebx.exe en el directorio de instalación de NetQuestion. Compruebe el directorio en un indicador de mandatos o en el Explorador de Windows para verificar si el archivo está presente. Si es así, probablemente existe un problema en la configuración del servidor web local de NetQuestion; puede que httpd.cnf señale a un directorio incorrecto. Consulte la sección anterior 3.2 HTTPDL.EXE está mal configurado. Si el archivo vahwebx.exe está ausente, puede intentar uno o varias de las siguientes acciones:

Vuelva a cargar la página del navegador. Si ahora funciona la ayuda, ha resuelto el problema. Si sigue recibiendo un error de Archivo no encontrado, póngase en contacto con el servicio de soporte de IBM. Si recibe el mensaje No existe ayuda registrada para el producto xxxxx, consulte la sección 6.0 Reconfiguración de la ayuda.

4.2 Errores de archivo no encontrado al intentar efectuar una búsqueda

Si recibe un error de Archivo no encontrado al intentar efectuar una búsqueda en la ayuda, puede que el programa de búsqueda especificado en el formulario de búsqueda no esté instalado en la ubicación adecuada. Siga estos pasos para determinar el nombre y la ubicación:

  1. En el producto IBM, seleccione Ayuda > Buscar para abrir el formulario de búsqueda en una ventana del navegador.
  2. En el navegador, visualice el fuente del formulario de búsqueda. Puede hacerlo de la forma siguiente:
  3. En el fuente del formulario, busque la serie "action=". Debe ver algo parecido a una de las siguientes líneas: 
    <form action="http://localhost:49213/cgi-bin/ivjsenus.exe"...>
<form action="http://localhost:49213/cgi-bin/va4sall.exe"...>

    El nombre del programa de búsqueda es la parte del atributo action= después de "cgi-bin", es decir, ivjsenus.exe o va4sall.exe en los ejemplos anteriores.

  4. Verifique que este archivo está ubicado en el directorio de instalación de NetQuestion. Si se encuentra allí y sigue recibiendo errores de Archivo no encontrado al efectuar búsquedas, consulte la sección anterior 3.2 HTTPDL.EXE está mal configurado. Si no se encuentra allí, es posible que pueda copiarlo del CD del producto. Busque este programa de búsqueda en el CD del producto. Si está presente, cópielo en el directorio NetQuestion. En caso contrario, póngase en contacto con el servicio de soporte de IBM para obtener una copia.

4.3 Otros errores de búsqueda que implican archivos que faltan

También puede recibir enlaces de imagen rotos en la página de resultados de búsqueda, o un mensaje Cabecera de formulario de búsqueda no encontrada o Pie de página de formulario de búsqueda no encontrado. Estos errores son el resultado de que faltan otros archivos en el directorio de instalación de NetQuestion. Es posible que pueda localizarlos en el CD del producto, o puede obtenerlos del servicio de soporte de IBM. Todos los nombres de archivo se especifican en el formulario de búsqueda. Puede ver el fuente del formulario de búsqueda para determinar los nombres. Busque los parámetros value= de los siguientes campos de entrada ocultos: 

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

Las entradas resaltadas son las correspondientes a VisualAge para Java. Las entradas equivalentes de otros productos incluyen, en lugar de ivj:

5.0 Mensajes de error interno del servidor

Un mensaje de Error interno del servidor indica generalmente que una aplicación que se ejecuta en el servidor web ha sufrido una anomalía. También puede ver un diálogo de Windows con el título program.exe - Error de aplicación y un mensaje que empieza por La instrucción de la memoria referenciada "0xnnnnnnnn" en "0xnnnnnnnn". Si ignora este diálogo seleccionando Aceptar, a continuación el navegador visualiza el mensaje Error interno del servidor.

Si este error se produce durante una operación de búsqueda, puede que existan problemas con los índices de búsqueda del producto. Intente reconfigurar la ayuda del producto, y a continuación especifique de nuevo la consulta de búsqueda. Si esto no resuelve el problema, póngase en contacto con el servicio de soporte de IBM.

Si este error se produce durante la consulta habitual de la ayuda, puede que existan problemas con los permisos de directorio en un sistema de archivos NTFS. Finalice la sesión en el sistema Windows NT o Windows 2000, iníciela de nuevo como administrador y compruebe que todos los archivos y carpetas del directorio de instalación de NetQuestion y del directorio de ayuda del producto (_DIR_INSTAL\doc o DIR_INSTAL\help, dependiendo del producto) tienen establecidos los permisos de seguridad en Todos - Control total. Para hacerlo:

  1. Inicie el Explorador de Windows y desplácese al directorio que desea comprobar o cambiar.
  2. Con el botón derecho del ratón, pulse sobre el nombre del directorio.
  3. Elija Propiedades y, a continuación, Permisos.
  4. Asegúrese de que ambos recuadros de selección (para sustituir permisos en archivos existentes y en subdirectorios) están seleccionados.
  5. Añada una entrada de usuario para Todos si no hay una presente, seleccionando Añadir y siguiendo las indicaciones.
  6. Asegúrese de que la entrada Todos tiene como mínimo el acceso Acceso especial (RX) (R), o establezca el nivel de acceso en Control total.

Si ha efectuado cambios en los permisos, cierre estos diálogos e intente volver a cargar la página. Si no ha necesitado efectuar cambios en los permisos, o si el error persiste después de haber efectuado los cambios, intente borrar el archivo vahelp.cfg del directorio de instalación de NetQuestion, y a continuación reconfigure la ayuda del producto.

Si sigue viendo mensajes de Error interno del servidor, póngase en contacto con el servicio de soporte de IBM.

6.0 Reconfiguración de la ayuda

En algunas situaciones, el sistema de ayuda puede haber configurado incorrectamente la ayuda de un producto determinado, o el usuario puede haber tenido que eliminar alguna información de configuración al intentar arreglar una instalación. Puede reconfigurar la ayuda del producto siguiendo las instrucciones que se detallan. Antes de empezar, debe saber lo siguiente:

La primera parte de este proceso implica determinar si la ayuda ya está configurada y simplemente debe renovarse. Para determinar si la ayuda del producto está configurada, escriba lo siguiente en un indicador de mandatos: 

vahcfg list /f %IMNINSTSRV% | more

Debe ver un conjunto de listados de productos y componentes para cada producto que se haya configurado para la ayuda. Si ve un producto cuyo directorio coincide con el directorio de producto, anote el nombre del producto. Por ejemplo, si la salida de vahcfg list incluye lo siguiente: 

Producto: va400 (Sistema de ayuda de IBM WebSphere Development Tools para AS/400)
Directorio grabable: C:\Program Files\IBM\WDT400\help
No hay archivos de actualización para este producto
Comp: qadtswin (WebSphere Development Tools para AS/400)
Archivo zip: C:\Program Files\IBM\WDT400\help\qadtswin.zip
Índice: va45uadt
...

El nombre del producto es va400. Si ve una entrada correspondiente al producto, puede reconfigurar la ayuda utilizando el mandato vahcfg regen. Si no ve una entrada para el producto, debe reconfigurar la ayuda utilizando el mandato vahcfg install. Ambos mandatos se describen más adelante en esta sección.

6.1 Espacio de disco libre

Antes de ejecutar los mandatos vahcfg regen o vahcfg install, también debe asegurarse de que el disco en el que se ubica el directorio de documentación tiene espacio suficiente para alojar los índices de búsqueda de la ayuda del producto. Estos índices se extraen de los archivos *.zip del directorio de documentación, y se escriben en subdirectorios del directorio de documentación mediante el programa vahcfg. Como norma general, debe tener como mínimo el espacio de disco libre equivalente a la cantidad de espacio utilizado por los archivos zip en el directorio de documentación.

6.2 Utilización del mandato vahcfg regen

Para ejecutar vahcfg regen, emita el siguiente mandato:

vahcfg regen /p nomprod /f %IMNINSTSRV%

donde nomprod coincide con el nombre de producto que ha anotado al ejecutar vahcfg list.

6.3 Utilización del mandato vahcfg install

Para ejecutar vahcfg install, emita el siguiente mandato:

vahcfg install /w dirdoc /f %IMNINSTSRV%

donde dirdoc es la vía de acceso completa al directorio que contiene los archivos de ayuda del producto. Si dicho directorio contiene espacios (por ejemplo, c:\Program Files\IBM\...), incluya toda la vía de acceso del directorio entre apóstrofos.

6.4 Después de ejecutar vahcfg install o vahcfg regen

Después de la instalación o regeneración (que pueden tardar varios minutos), intente volver a cargar la ayuda. Si el problema que intentaba corregir persiste, siga los pasos de la sección 6.5 Obtención de un archivo de anotaciones de vahcfg regen o vahcfg install, póngase en contacto con el servicio de soporte de IBM y envíeles el archivos de anotaciones.

6.5 Obtención de un archivo de anotaciones de vahcfg regen o vahcfg install

Si ha intentado regenerar o instalar la ayuda del producto mediante vahcfg regen o vahcfg install y el intento no ha resuelto los problemas de la ayuda, intente lo siguiente para producir un archivo de anotaciones que el servicio de soporte de IBM pueda utilizar para efectuar un diagnóstico más profundo del problema:

  1. En un indicador de mandatos, establezca la variable de entorno VAHCFG_LOG de forma que señale a un archivo nuevo en un directorio grabable. Por ejemplo:
    SET VAHCFG_LOG=c:\config.log
  2. Si ha intentado vahcfg install y ha tenido problemas, ejecute los dos mandatos siguientes:
    vahcfg remove /p nomprod /f %IMNINSTSRV%
    vahcfg install /w dirdoc
  3. Si ha intentado vahcfg regen y ha tenido problemas, ejecute de nuevo el mismo mandato vahcfg regen.

A continuación, puede proporcionar el archivo de anotaciones generado al servicio de soporte de IBM.

Tenga en cuenta que algunas versiones anteriores de vahcfg no producen el archivo de anotaciones. Las versiones que no dan soporte a las anotaciones mostrarán toda la salida en la pantalla; las versiones que sí las soportan mostrarán un mensaje indicando dónde se está anotando la información.

7.0 Problemas de tiempo de espera durante la búsqueda

El sistema de búsqueda de NetQuestion es extremadamente rápido al buscar coincidencias en todos los casos, excepto en las consultas de búsqueda más genéricas. Si busca coincidencias de la serie a*, el sistema de búsqueda debe buscar todos los documentos que contienen como mínimo una palabra que empiece por la letra a, y por tanto tarda más tiempo. Sin embargo, si la búsqueda es específica, puede esperar resultados de la búsqueda en unos pocos segundos como máximo. Si una búsqueda parece excesivamente larga (por ejemplo, alrededor de 1 minuto), puede que esté experimentando un problema relacionado con la utilización de Netscape Navigator 4.5 o posterior en un sistema Windows 2000. (Este problema también se produce en algunos sistemas Windows NT).

Existe un problema conocido con Netscape (versiones 4.5 a 4.74 y posiblemente otras) en algunas máquinas Windows 2000 que puede hacer muy lenta la búsqueda de la ayuda en línea. Cuando se envía un formulario desde estas versiones de Netscape, la aplicación de Netscape utiliza la mayoría de los ciclos de procesador disponibles de la máquina hasta que se recibe una respuesta del sistema remoto. (Puede comprobarlo abriendo la página del administrador de tareas de Windows durante una búsqueda de este tipo, cambiando a la pestaña Procesos y pulsando la cabecera de columna CPU. Si experimenta el problema descrito, netscape.exe aparecerá al principio de esta lista y estará utilizando el 97-99% de tiempo de la CPU).

Esta utilización de la CPU no representa generalmente un problema al realizar una búsqueda remota (por ejemplo, en un sitio web). Sin embargo, como el programa de búsqueda del producto se ejecuta en la máquina local, el hecho que Netscape ocupe tanto tiempo de CPU significa que queda muy poco tiempo de CPU para que el programa realice la búsqueda. Como resultado de ello, una acción de búsqueda que debería devolver un resultado al cabo de un segundo puede tardar varios minutos en Windows 2000.

Puede evitar este problema de rendimiento en Windows 2000 seleccionando una ventana distinta que no sea de Netscape después de someter cada búsqueda. Esto generalmente hace que Netscape deje de utilizar ciclos de CPU excesivos mientras espera una respuesta y los resultados de la búsqueda normalmente se visualizan al cabo de un segundo después de realizar este cambio de ventana. La misma técnica también puede funcionar en Windows NT, aunque de forma menos coherente.

Como alternativa, puede utilizar Microsoft Internet Explorer para ver la ayuda, dado que el problema de rendimiento no se produce en este navegador.

8.0 Palabras de detención o rc=73

Puede recibir uno de los siguientes mensajes de error al realizar una búsqueda en sistema de ayuda desde el navegador:

Esto puede producirse en dos situaciones:

El código de retorno 73 no se devuelve generalmente en caso de una petición de búsqueda realmente vacía, sino solamente en caso de constar ésta sólo de palabras de detención. Si puede reproducir de forma fiable el mensaje que indica una petición de búsqueda vacía, cuando la serie de búsqueda decididamente no lo está (y no se trata de una búsqueda compuesta sólo de palabras de detención), puede que el formulario de búsqueda esté dañado. Busque los formularios de búsqueda hgssrch.htm y hgcsrch.htm del directorio de ayuda del producto (generalmente DIR_INSTAL\doc o DIR_INSTAL\help) y suminístrelos al servicio de soporte de IBM cuando se ponga en contacto con ellos.

9.0 Otros errores de búsqueda

Puede ver otros mensajes de error diversos al intentar efectuar búsquedas. Si el error es uno de los siguientes, intente la acción recomendada antes de ponerse en contacto con el servicio de soporte de IBM.

9.1 El servidor NetQuestion especificado no está disponible. (rc=33)

Causa: El cliente de la ayuda no ha podido iniciar el servicio de búsqueda (o, en Component Broker, el servicio de búsqueda no está configurado para iniciarse automáticamente durante el inicio de sesión).  Esto puede ocurrir si está buscando en la máquina local (http://localhost:49213) o en un servidor de ayuda remoto.

Acción recomendada (ayuda local):

Consulte la sección 3.1 HTTPDL.EXE no se está ejecutando, y específicamente la sección acerca de la importación de las entradas de registro de inicio automático, para que el servicio de búsqueda se inicie automáticamente al iniciar la sesión. Si desea un método alternativo abreviado, puede abrir un indicador de mandatos y escribir: 

imnss start server

Si este mandato devuelve un mensaje que incluye la línea: 

El servicio de búsqueda se ha iniciado.

debe estar en condiciones de realizar de nuevo la búsqueda, sin que aparezca el error rc=33.

Acción recomendada (ayuda servida remotamente):

Puede que el proceso de búsqueda de NetQuestion de la máquina servidora no se esté ejecutando debido a que la máquina se ha reiniciado y en ese momento nadie ha iniciado la sesión en la misma. Consulte la sección 14.0 Inicio del servicio de búsqueda de NetQuestion durante un reinicio.

9.2 No se ha especificado destino para la búsqueda

Causa: El programa de búsqueda no ha recibido ningún nombre de índice válido en la petición de búsqueda. Puede que el formulario de búsqueda se haya dañado, o que los índices especificados ya no estén registrados, o puede existir un problema en la instalación de NetQuestion.

Acción recomendada: En primer lugar, suprima todos los archivos hg*.htm del directorio de ayuda del producto (DIR_INSTAL\doc o DIR_INSTAL\help). A continuación, intente reconfigurar la ayuda del producto. Si el problema persiste, puede que sea necesario reinstalar NetQuestion y a continuación reconfigurar de nuevo la ayuda del producto.

9.3 Cabecera de formulario de búsqueda no encontrada | Pie de página de formulario de búsqueda no encontrado

Causa: El formulario de búsqueda especificaba una cabecera o un pie de página de formulario de búsqueda (un archivo que contiene un fragmento HTML que debe situarse encima o debajo de los resultados de búsqueda) inexistentes.

Acción recomendada: Consulte la sección 4.2 Errores de Archivo no encontrado al intentar efectuar una búsqueda para obtener más información.

9.4 Consulta demasiado compleja. Vuelva a formular la petición de búsqueda. (rc=22)

 Causa: ha especificado una consulta de búsqueda que tiene demasiadas coincidencias de palabra. El motor de búsqueda no puede manejar una consulta que contenga coincidencias con más de 1024 palabras diferentes. Por ejemplo, si especifica la serie de búsqueda "a* b* c* d*" (sin los apóstrofos), está solicitando todos los documentos que contengan palabras que empiecen por cualquiera de las letras a, b, c o d. Debido a la gran cantidad de palabras que coinciden con estos criterios de búsqueda, el motor de búsqueda no puede producir una lista significativa y ordenada de coincidencias de búsqueda, y por tanto no lo intenta.

Acción recomendada:: Especifique una serie de búsqueda que produzca menos coincidencias de palabra.

9.5 La condición especificada no es válida.

Causa: ha especificado una consulta de búsqueda que no es válida desde el punto de vista lógico. Por ejemplo, una consulta de búsqueda "-java" (mostrar todos los documentos que no contengan la palabra java) no se considera válida.

Acción recomendada:: Especifique una petición de búsqueda que contenga como mínimo un término no prohibido.

9.6 El archivo de configuración de NetQuestion (NETQ.CFG) tiene un error o no ha podido encontrarse. (rc=77)

Causa: Este error puede producirse cuando el programa de búsqueda no puede leer las variables de entorno necesarias para la operación satisfactoria de la búsqueda. Si ha configurado la ayuda para que se ejecute en un servidor web que no es el servidor web HTTPDL.EXE de NetQuestion, puede que sea necesario cambiar los valores del servidor web para asegurar que determinadas variables de entorno sean visibles para el CGI de búsqueda (el programa al que se llama desde el parámetro "action=" del indicador <form> dentro del formulario de búsqueda). En algunos servidores web, las variables de entorno del sistema están ocultas por omisión. Las variables a las que el CGI de búsqueda necesita acceder son IMNINSTSRV y IMNINST. Netscape Enterprise Server es un ejemplo de un servidor web que oculta las variables de entorno por omisión.

Acción recomendada: Modifique los valores del servidor web, para exportar manualmente estas variables de entorno a aplicaciones CGI de servidor web o para que todas las variables de entorno locales sean visibles para los CGI. En Netscape Enterprise Server, puede hacerlo siguiendo estos pasos:

  1. Abra x:\directorio_servidor_netscape_enterprise\https-server_name\config\obj.conf, donde directorio_servidor_netscape_enterprise es el directorio en el que ha instalado NES, y nombre_servidor es el nombre del servidor de la ayuda, según lo especificado durante la instalación de NES.
  2. Necesitará conocer los valores de las variables de entorno de NetQuestion. En un indicador de mandatos, escriba: 
    set imn

    El sistema debe devolver los valores de las variables de IMNINST y IMNINSTSRV, como por ejemplo: 

    IMNINST=help
IMNINSTSRV=C:\IMNNQ_NT
  3. En función de los resultados anteriores, añada las siguientes líneas a obj.conf, inmediatamente debajo de las otras líneas que empiezan por una directiva "Init". Asegúrese de utilizar sólo BARRAS INCLINADAS (/) al añadir la vía de acceso de IMNINSTSRV: 
    Init fn="init-cgi" IMNINSTSRV=c:/imnnq_nt
Init fn="init-cgi" IMNINST=help
  4. Detenga Netscape Enterprise Server. Si ve el siguiente aviso:

    "AVISO: Los archivos de configuración se han editado manualmente. Utilice este botón para cargar los archivos de configuración más recientes."

    pulse Cargar archivos de configuración.

  5. Inicie Netscape Enterprise Server
  6. Intente de nuevo la búsqueda.

En otros servidores web, consulte la documentación del servidor web para obtener información acerca de cómo hacer visibles las variables de entorno para las aplicaciones CGI.

9.7 Otros errores de NETQ.CFG o rc=32

Causa: Un error rc=32 o un error que menciona el archivo NETQ.CFG se produce cuando NetQuestion no puede acceder adecuadamente a un índice de producto. Esto puede ocurrir debido a que la instalación de NetQuestion o un índice determinado se han dañado, o puede ocurrir sólo en la primera búsqueda realizada sobre un índice determinado después de un reinicio. Tenga en cuenta que, aunque el mensaje correspondiente a algunas formas de este error menciona el archivo NETQ.CFG, este archivo no existe realmente; el error hace referencia a problemas en otros archivos de configuración de índice de NetQuestion.

Acción recomendada: Determine la causa probable del problema y corríjalo como se describe a continuación:

9.8 Errores de restablecimiento de índice o rc=76

Si una búsqueda devuelve un mensaje de error rc=76, puede que sea necesario restablecer uno o varios de los índices de búsqueda. Para restablecer los índices, siga estos pasos:

  1. Visualice el fuente del formulario de búsqueda desde el navegador. Busque todas las líneas que contengan el indicador HTML <input type=hidden name=indexname value=ixname>
  2. Para cada valor ixname, escriba el siguiente mandato en un indicador de mandatos:
    nqreset ixname
  3. Intente de nuevo la búsqueda después de restablecer todos los índices implicados. Si el error de búsqueda persiste o se reproduce más tarde, póngase en contacto con el servicio de soporte de IBM.

10.0 Reinstalación de NetQuestion

En algunas situaciones, la única forma de conseguir que la ayuda funcione correctamente es desinstalar y volver a instalar NetQuestion, y a continuación reconfigurar la ayuda para los productos que utilizan el sistema de ayuda de VisualAge. Tenga en cuenta que al desinstalar NetQuestion pueden eliminarse índices de búsqueda utilizados por los productos, como por ejemplo IBM DB2, que no utilizan el sistema de ayuda de VisualAge, impidiendo con ello la búsqueda de la ayuda en dichos productos después de la reinstalación de NetQuestion. Puede que sea necesario reinstalar el producto en cuestión para restaurar sus índices de búsqueda.

En las instrucciones que siguen, emita todos los mandatos desde una indicador de mandatos. Antes de empezar, debe determinar el directorio de instalación de NetQuestion.

10.1 Ejecución de vahcfg remove para todos los productos listados

El programa de desinstalación de NetQuestion, uninstnq.exe en el directorio de NetQuestion, eliminará NetQuestion sólo si no hay ningún índice registrado. Puede eliminar primero los índices registrados por los productos que utilizan el sistema de ayuda de IBM VisualAge emitiendo el mandato vahcfg remove para cada uno de tales productos. Siga estos pasos:

  1. Ejecute el mandato vahcfg list /f %IMNINSTSRV% | more y tome nota de cada nombre de producto (según se describe en la sección 6.0 Reconfiguración de la ayuda).
  2. Para cada nombre de producto, ejecute el mandato vahcfg remove /p nomprod /f %IMNINSTSRV%

10.2 Eliminación de todos los índices restantes

Después de eliminar todos los productos de este tipo, puede comprobar si hay índices que siguen registrados para otros productos escribiendo el siguiente mandato: 

imnixlst

Si la lista resultante contiene entradas que empiezan por DB2, CXX o VAC, probablemente tiene índices registrados con productos tales como Compiladores DB2, IBM C y C++, o VisualAge C++ 4.0, que no utilizan el sistema de ayuda de VisualAge. Si continúa con la desinstalación manual de NetQuestion, perderá estos índices y puede que necesite reinstalar los productos respectivos para buscar de nuevo en la ayuda de dichos productos. Si estos índices siguen listados y está en condiciones de perder posibilidades de búsqueda para esos productos o de reinstalar dichos productos, suprima los índices restantes de la siguiente forma:

Si se listan índices cuyos nombres empiezan por IVJ3, VJ32, IWZ o VA45, es seguro suprimirlos debido a que pueden restaurarse más tarde utilizando el mandato vahcfg install.

Si no puede suprimir todos los índices restantes debido a un error de NetQuestion, puede que sea necesario suprimir manualmente NetQuestion (consulte la sección 11.4, más adelante).

10.3 Ejecución de uninstnq

Emita el mandato uninstnq y espere unos minutos, hasta que observe que el directorio de NetQuestion está casi vacío. El directorio no debe contener ningún archivo que empiece por imn* o imq*. Puede que tenga que esperar hasta diez minutos a que esta operación finalice. Si pasados diez minutos el directorio sigue conteniendo archivos imn* o imq*, puede haber índices que siguen registrados con el servicio de búsqueda (en cuyo caso debe volver a la sección 11.2), o puede que la instalación de NetQuestion esté dañada (continúe con la sección 11.4). En caso contrario, reinicie el sistema y continúe con la sección 11.5.

10.4 Eliminación manual de NetQuestion

Si no puede eliminar NetQuestion utilizando uninstnq.exe, puede hacerlo manualmente de la siguiente forma:

  1. Ejecute el programa regedit desde un indicador de mandatos o desde Inicio > Ejecutar.
  2. Expanda la entrada de registro HKEY_LOCAL_MACHINE\Software\IBM.
  3. Suprima la entrada NetQuestion y todas sus subentradas.
  4. Elimine el nombre del directorio NetQuestion de la variable de entorno PATH.
  5. Elimine la variable de entorno IMNINSTSRV.
  6. Suprima todos los archivos del directorio de NetQuestion que coincidan con estas especificaciones de caracteres comodín, especificando el siguiente mandato en un indicador de mandatos mientras ese directorio es el directorio actual:
    del http*.* 302.* 404.* 500.* im*.* nq*.*
  7. Suprima el subdirectorio "instance" desde Explorer o especificando el mandato:
    rmdir /s /q instance
  8. Reinicie el sistema.

Para cambiar o eliminar variables de entorno, siga los pasos específicos de plataforma que se indican a continuación:

10.5 Reinstalación de NetQuestion

Para reinstalar NetQuestion, necesitará el CD del producto o un archivo zip de instalación de NetQuestion del servicio de soporte de IBM. Los siguientes productos tienen una copia instalable de NetQuestion en su CD de producto:

Para otros productos, puede determinar si existe una copia instalable de NetQuestion en el CD buscando un archivo denominado ntq_sbcs.iss. El directorio que contenga este archivo debe contener un archivo setup.exe que puede lanzar la instalación de NetQuestion.

Si recibe de IBM un archivo zip de instalación, descomprímalo en un directorio temporal.

Una vez que haya obtenido una copia instalable de NetQuestion, siga estos pasos:

  1. Abra setup.exe efectuando una doble pulsación sobre él en Explorer o abriendo una indicador de mandatos, cambiando al directorio que contiene el código de instalación de NetQuestion y escribiendo setup.
  2. Elija una instalación completa.
  3. Altere temporalmente el directorio por omisión para que señale al directorio donde NetQuestion estaba instalado anteriormente. Si altera temporalmente el directorio por omisión y señala a un directorio nuevo, asegúrese de que el nombre del directorio nuevo tiene como mínimo 8 caracteres, no contiene espacios y está a nivel de raíz en una unidad. Esto reducirá la probabilidad de problemas futuros en la ayuda. 
  4. Efectúe un reinicio cuando finalice la instalación.
  5. Si los directorios antiguo y nuevo de NetQuestion son diferentes, copie la cabecera y pie de página de búsqueda, los archivos .gif, el programa de búsqueda y los archivos del sistema de ayuda (vah*.exe, vahwebx.cat) del directorio antiguo al nuevo. Consulte la sección 4.0 Errores de Archivo no encontrado para obtener información acerca de estos archivos.

10.6 Reconfiguración de la ayuda para productos instalados

Para cada producto que haya eliminado manualmente del sistema de ayuda (utilizando vahcfgremove, según lo indicado en la sección 11.1), ejecute vahcfg install según se describe en la sección 6.0 Reconfiguración de la ayuda. Ahora debe estar en condiciones de examinar la ayuda del producto y efectuar búsquedas en la misma. Si los errores persisten, compruebe si en otras secciones de este documento existen posibles soluciones o póngase en contacto con el servicio de soporte de IBM.

11.0 Creación de un icono para abrir la ayuda de producto

Si no puede abrir la ayuda desde la interfaz de usuario del producto, puede crear un icono para que se abra efectuando una doble pulsación sobre el mismo (para que al menos pueda utilizar la ayuda al trabajar en la solución del problema).

Notas

  1. En Component Broker, el menú Inicio ya contiene una entrada Biblioteca en línea de Component Broker para abrir la ayuda del producto, y la información de esta sección no es aplicable.
  2. En Websphere Development Tools para AS/400, el menú Inicio ya contiene un conjunto de entradas para abrir la ayuda de producto (Inicio - Archivo de programa - IBM Websphere Development Tools para AS/400 - Documentación), pero también puede crear su icono de escritorio mediante el método descrito más adelante.
  3. En VisualAge TPF para Windows NT, en las estaciones de trabajo que tienen la ayuda instalada localmente, el menú Inicio ya contiene una entrada para abrir la ayuda de producto. Siga estos pasos sólo si elige acceder a la ayuda remotamente o si desea añadir el icono al escritorio además de tenerlo en el menú Inicio.

Puede crear un acceso directo para abrir la ayuda de producto de la siguiente forma:

  1. En la barra de tareas, pulse el botón derecho del ratón y seleccione Minimizar todas las ventanas.
  2. En un punto vacío del escritorio, pulse el botón derecho del ratón y seleccione Nuevo - Acceso directo.
  3. En el diálogo Crear acceso directo, pulse Examinar para localizar el directorio de instalación del producto.
  4. Busque, en este subdirectorio o en uno de sus subdirectorios, el archivo vahelp.exe. En VisualAge para Java, se trata del directorio eab\bin.
  5. Efectúe una doble pulsación en el archivo vahelp.exe. En el diálogo Crear acceso directo, el área de entrada Línea de comandos debe mostrar ahora la vía de acceso completa (entre apóstrofos si la vía de acceso contiene espacios) a vahelp.exe.
  6. Edite el área de entrada Línea de comandos y añada lo siguiente (incluyendo un espacio en blanco inicial) al final de la línea: 
    instance "DIR_INSTAL\DIR_DOC\ARCHIVO_CONFIG" open index.htm

    donde DIR_INSTAL es el directorio en el que está instalado el producto, DIR_DOC es generalmente doc o help, y ARCHIVO_CONFIG es el nombre del archivo de configuración de la ayuda de producto (ivjhlp.cfg para VisualAge para Java; consulte la sección 2.0 No ocurre nada al intentar iniciar la ayuda para obtener información acerca de cómo determinar los directorios y los nombres de los archivos de configuración para otros productos). Asegúrese de que la vía de acceso completa al archivo de configuración esté entre apóstrofos si contiene espacios.

  7. Pulse Siguiente.
  8. Especifique un nombre para el acceso directo, por ejemplo "Ayuda en línea de IBM VisualAge para Java".
  9. Pulse Finalizar.
  10. Efectúe una doble pulsación en el acceso directo que ha creado en el escritorio para asegurarse de que funciona.
  11. Para cambiar el aspecto del icono de acceso directo, pulse con el botón derecho del ratón sobre el acceso directo y elija Propiedades, a continuación elija la pestaña Acceso directo, seleccione Cambiar icono y examine la lista de iconos disponibles o el sistema de archivos para encontrar un nuevo icono.

Puede añadir el icono creado al menú Inicio pulsando el botón derecho del ratón sobre el icono, eligiendo Copiar en el menú emergente, a continuación, en el Explorador de Windows, navegando hasta el directorio de instalación de Windows, bajo ...\Profiles\All Users\Start Menu, y pegándolo en ese directorio o en un subdirectorio adecuado del mismo.

12.0 Configuración del sistema de ayuda en un servidor Windows

Puede instalar y configurar el sistema de ayuda en un servidor web Windows NT o Windows 2000, de forma que otros miembros de la organización puedan ver la ayuda en línea y efectuar búsquedas en ella en una red sin necesidad de utilizar el código del sistema de ayuda y NetQuestion instalado en sus estaciones de trabajo.

Notas de producto

  1. En VisualAge COBOL y VisualAge TPF, los usuarios pueden elegir no instalar NetQuestion o el sistema de ayuda localmente. En otros productos, los usuarios pueden eliminar las copias locales siguiendo sólo los pasos de eliminación de las secciones 6.0 Reconfiguración de la ayuda y 10.0 Reinstalación de NetQuestion.
  2. En VisualAge TPF, el producto se suministra con programas de utilidad incorporados para configurar la ayuda para que la sirva el servidor. Si la instalación se realiza desde el archivo setup.exe del CD del producto, se le preguntará si otros usuarios de la red van a acceder a la ayuda remotamente. Responda Sí. Si ha bajado el paquete de ayuda desde la web, ejecute insthelp.exe.

Para realizar esta instalación de red, debe tener instalado un software de servidor, como por ejemplo Microsoft Peer Web Services (PWS) o Microsoft IIS, en el servidor. El servidor web debe tener un directorio de scripts. (En PWS e IIS, el directorio de scripts se encuentra generalmente en x:\inetpub.) Después de instalar el software de servidor, realice los siguientes pasos:

  1. Instale el producto de software IBM en el servidor.
  2. Copie los siguientes archivos del directorio de NetQuestion al directorio x:\inetpub\scripts, si están presentes en el directorio de NetQuestion: 
    vahwebx.exe
vahwebx.cat
vahelp.cfg
*foot.htm
*head.htm
*henus.htm

    Los tres primeros archivos son obligatorios; los archivos subsiguientes deben copiarse si están presentes, pero, si no están en el directorio de NetQuestion, no van a ser necesarios en el directorio x:\inetpub\scripts.

  3. Edite el archivo imnmap.dat, que se encuentra en el directorio %IMNINSTSRV%\instance\help\data\. Este archivo contiene la parte inicial de la dirección web de cada índice. Cambie todas las apariciones de la subserie http://localhost:49213/cgi-bin a la forma http://server.city.domain.organization/scripts (como por ejemplo http://cobweb.stl.ibm.com/scripts). Este cambio provoca que los enlaces generados para coincidencias de búsqueda produzcan una dirección web remota (no localhost), de forma que un usuario pueda seguirlos desde cualquier sistema.
  4. Edite los siguientes archivos, creados en el directorio de ayuda del producto: hgssrch.htm y hgcsrch.htm. Cambie http://localhost:49213/cgi-bin a la forma http://server.city.domain.organization/scripts.
  5. Copie el CGI de búsqueda especificado (por ejemplo, iwzihenes.exe, ivjsenus.exe, va4sall.exe) en los formularios de búsqueda del directorio de NetQuestion por el directorio x:\inetpub\scripts.
  6. Copie *star*.gif en un subdirectorio de iconos nuevo bajo x:\inetpub\wwwroot.
  7. En Component Broker, cambie el valor de la variable de entorno VABHELP de http://localhost:49213/cgi-bin a la forma http://server.city.domain.organization/scripts. En los productos que no son Component Broker, indique a cada usuario que edite su archivo de configuración de producto (*.cfg en su directorio de ayuda de producto) y cambie las siguientes entradas a los valores que se muestran: 
    HTML_HOSTNAME=server.city.domain.organization
CGI_BIN_DIR=scripts
START_LITE_DAEMON=0
START_NETQ_DAEMON=0

A continuación, los usuarios deben poder acceder a la ayuda basada en el servidor pulsando simplemente F1 o seleccionando una opción de menú Ayuda desde su aplicación IBM. O bien pueden acceder a la ayuda utilizando el siguiente URL:

http://SuNombreSistemaPrincipal/scripts/vahwebx.exe/help/nomprod/Extract/0/index.htm

donde nomprod es:

Si más tarde ejecuta vahcfg install o vahcfg regen en el sistema servidor, necesitará editar de nuevo el archivo de correlación del paso 3.

Una vez que los usuarios han modificado sus archivos de configuración de la ayuda de producto para que señalen al servidor, pueden ejecutar con seguridad el siguiente mandato para suprimir todos los archivos *.toc, *.htm y *.zip, así como los archivos de índice de búsqueda, del directorio de ayuda de producto: 

vahcfg remove /p nomprod /f %IMNINSTSRV%

o pueden simplemente suprimir los archivos *.toc, *.htm y *.zip manualmente. Sin embargo, este método no suprimirá los directorios de índice situados en el directorio de ayuda de producto, y por tanto deberán suprimirse manualmente.

13.0 Inicio automático de los servidores NetQuestion

Consulte la sección 14.0 Inicio del servidor de búsqueda NetQuestion durante el inicio en lugar de esta sección, si está configurando el servidor en una configuración de la ayuda en red.

Puede establecer los servidores de búsqueda y HTTP para que se inicien automáticamente durante el inicio de sesión estableciendo dos entradas de registro en el sistema. Para establecer estas entradas, siga estos pasos:

  1. Cree un archivo denominado NetQuestionAutoStart.reg utilizando un editor de texto, como por ejemplo NOTEPAD. escriba el siguiente texto (utilice copiar y pegar): 
    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. Cambie la serie %IMNINSTSRV% de su versión por el valor del directorio de instalación de NetQuestion.
  3. Guarde el archivo.
  4. Efectúe una doble pulsación en NetQuestionAutoStart.reg desde el Explorador de Windows.

Esta acción importará dos entradas en el registro, de forma que la próxima vez que inicie la sesión (o efectúe un reinicio en Windows 95 o Windows 98), los servidores deben iniciarse automáticamente.

14.0 Inicio del servicio de búsqueda de NetQuestion durante un reinicio

Si utiliza una configuración de ayuda en red en la que la ayuda se suministra desde un servidor y no desde su propia máquina, puede que tenga problemas al realizar búsquedas en la máquina remota. Si el daemon de búsqueda de NetQuestion está configurado para iniciarse automáticamente (durante la instalación del producto o después de haber seguido los pasos de la sección 13.0 Inicio automático de los servidores NetQuestion), el daemon no se inicia realmente hasta que un usuario inicia la sesión en la máquina del servidor. Esto significa que, después de un reinicio del sistema, antes de que el usuario de la máquina haya iniciado la sesión por primera vez, el daemon de búsqueda no está en funcionamiento:  Sin embargo, puede utilizar el Planificador de tareas de Windows para iniciar el daemon de búsqueda durante el reinicio. Las instrucciones de esta sección se aplican a la máquina que sirve la ayuda.

Nota: Si no utiliza una configuración de ayuda en red, no es necesario seguir los pasos indicados en esta sección.

Antes de empezar, debe determinar el directorio de instalación de NetQuestion. Puede que también desee realizar una limpieza manual del registro. El registro puede contener entradas para iniciar el daemon de búsqueda de NetQuestion durante el inicio de sesión. Si va a iniciar el daemon durante el reinicio, la entrada de registro es innecesaria. Para limpiar el registro:

  1. En el menú Inicio, seleccione Ejecutar.
  2. Escriba regedit y pulse Aceptar.
  3. Siga la estructura en árbol hasta HKEY_LOCAL_MACHINE - SOFTWARE - Microsoft - Windows - CurrentVersion - Run
  4. En el panel de la derecha de la carpeta Ejecutar (Run), seleccione y suprima la siguiente clave:
  5. También puede eliminar la entrada de inicio automático del servidor HTTP de NetQuestion HTTP si no va a acceder a la ayuda directamente en la máquina del servidor. Para hacerlo, seleccione y suprima la siguiente clave:
  6. Cierre el editor del registro.

Ahora, puede indicar a Windows que inicie los servidores durante el reinicio. En primer lugar, compruebe si el Planificador de tareas de Microsoft Windows está instalado en la máquina que actúa como servidor de la ayuda:

  1. Abra el Explorador de Windows o NT Explorer.
  2. Compruebe las subcarpetas de la carpeta Mi PC. Si, junto con las unidades locales y de red, ve una carpeta titulada Tareas planificadas, el Planificador de tareas está instalado en la máquina. Salte al paso 5.
  3. Si no tiene instalado el Planificador de tareas en la máquina, deberá instalarlo. El Planificador de tareas se suministra con Internet Explorer. Se encuentra en la categoría "mejoras adicionales de Explorer", y es un componente adicional que necesitará instalar. El método para añadir componentes a Internet Explorer depende de la versión de Internet Explorer y de la versión de Windows que esté utilizando. Consulte el documento "Cómo añadir y eliminar componentes de Internet Explorer", en http://support.microsoft.com/support/kb/articles/Q171/2/29.ASP, para obtener más detalles.
  4. Una vez que haya instalado el Planificador de tareas, efectúe un reinicio si se le solicita, y abra Mi PC.

Para configurar el servidor de búsqueda de NetQuestion para que se inicie durante el reinicio en el servidor de ayuda:

  1. En la carpeta tareas planificadas, pulse Añadir tarea planificada
  2. Se abre el asistente Añadir tarea planificada. Pulse Siguiente para continuar.
  3. Seleccione arbitrariamente un programa de la lista (lo cambiará más tarde) y pulse Siguiente.
  4. Denomine la tarea. Por ejemplo, especifique "Servidor de búsqueda de NetQuestion".
  5. Seleccione el botón de selección Cuando se inicia el sistema y pulse Siguiente.
  6. Especifique el nombre del usuario que será propietario del proceso (por ejemplo, el administrador del sistema) y entre su contraseña cuando se le solicite. Pulse Siguiente.
  7. Seleccione el recuadro de selección Abrir propiedades avanzadas para este tarea al pulsar 'Terminar'.
  8. Pulse Terminar.
  9. Se abre la página de propiedades del servidor de búsqueda de NetQuestion. En la pestaña Tareas, cambie el campo ejecutar por DIR_NQ\imnss.exe start server
    donde DIR_NQ es el directorio de instalación de NetQuestion.
  10. En el campo Empezar en , especifique el directorio de instalación de NetQuestion.
  11. Asegúrese de que el recuadro de selección Habilitado esté seleccionado.
  12. En la pestaña Valores, deseleccione Detener la tarea si se ejecuta durante xxx horas y xxx minutos.

Nota: Una vez reiniciada la máquina del servidor de ayuda, puede transcurrir un minuto o más tiempo después de que aparezca la pantalla de inicio de sesión y antes de que Windows inicie el servidor de búsqueda.

15.0 Búsqueda del directorio de instalación de NetQuestion

Puede determinar la ubicación del directorio de instalación de NetQuestion abriendo un indicador de mandatos y escribiendo: 

set IMNINSTSRV

El directorio devuelto es el directorio de instalación de NetQuestion. Si la variable no está definida, puede determinar el directorio de instalación buscando en el registro de Windows. Especifique regedit en un indicador de mandatos y expanda las entradas de registro hasta la clave HKEY_LOCAL_MACHINE\SOFTWARE\IBM\NetQuestion\CurrentVersion\Installation Directory. La entrada "Directory" de esa clave debe señalar al directorio de instalación de NetQuestion.

En Windows 95 y Windows 98, si la variable de entorno IMNINSTSRV no está definida, pero puede encontrar el directorio en el registro, puede sea necesario editar el archivo autoexec.bat. (Si encuentra esta condición en Windows Millennium Edition, consulte la sección 17.0 Consideraciones especiales para Windows Millennium Edition.) El proceso de instalación de NetQuestion debe haber modificado autoexec.bat para añadir un mandato para llamar al archivo por lotes imnenv.bat almacenado en el directorio de NetQuestion. El mandato añadido tiene el siguiente aspecto: 

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

Si falta esta línea, o si _NETQ_DIR_ señala a un directorio incorrecto, añada la línea especificando el directorio de NetQuestion correcto. También debe comprobar que el archivo por lotes imnenv.bat al que se llama dentro de autoexec.bat existe realmente y contiene entradas que señalan al directorio actual y no a cualquier otro directorio de NetQuestion. El contenido de imnenv.bat debe ser: 

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

16.0 Establecer asociaciones de archivo HTML en el registro de Windows

Si no puede abrir la ayuda desde el navegador ni desde una línea de mandatos, puede que no tenga configurada una asociación de archivo adecuada para archivos HTML. El código de cliente del sistema de ayuda utiliza entradas de registro para determinar el navegador del sistema por omisión basándose en estas asociaciones de archivo. Puede comprobar las asociaciones de archivo mediante el editor del registro:

  1. En el menú Inicio, seleccione Ejecutar
  2. Especifique regedit en el diálogo Ejecutar (Run)
  3. En el editor del registro, expanda HKEY_CLASSES_ROOT
  4. Debe ver una entrada para .htm. El valor por omisión para esta entrada debe ser "NetscapeMarkup" (si el navegador por omisión es Netscape) o "htmlfile" (si el navegador por omisión es Internet Explorer).

Si no ve una entrada de este tipo, puede añadirla de la siguiente forma:

  1. Inicie el navegador que desea registrar como navegador del sistema por omisión.
  2. Si el navegador muestra un diálogo que solicita si el usuario desea que pase a ser el navegador por omisión, responda afirmativamente. Si no es así, puede configurar el navegador para que efectúe la pregunta la próxima vez que lo inicie:

    En Netscape Communicator:

    1. Salga de todas las ventanas de Netscape.
    2. Busque el archivo de preferencias de usuario, prefs.js. Se encuentra generalmente en un directorio del directorio de instalación del producto Netscape. generalmente, la vía de acceso es Directorio_Instalación_Netscape\users\nombreusuario\prefs.js, donde nombreusuario es "default (por omisión)" o el nombre con el que inicia la sesión en Windows.
    3. Edite el archivo con un editor de texto plano y elimine la línea: 
      user_pref("browser.wfe.ignore_def_check", true);
    4. Guarde el archivo (asegúrese de guardarlo como texto plano si ha utilizado WordPad).
    5. Inicie de nuevo Netscape y registre Netscape como navegador por omisión.

    En Internet Explorer:

    1. Localice la opción de menú Opciones u Opciones de Internet. Dependiendo de la versión de Explorer que utilice, puede acceder a las opciones del navegador desde los menús Herramientas, Archivo o Ver.
    2. Seleccione la pestaña Programas del diálogo.
    3. Seleccione el recuadro de selección Comprobar si Internet Explorer es el explorador predeterminado.
    4. Salga de Internet Explorer.
    5. Inicie de nuevo Internet Explorer y registre Internet Explorer como navegador por omisión.

17.0 Consideraciones especiales para Windows Millennium Edition

Si utiliza Windows Millennium Edition, puede que los cambios que efectúe en autoexec.bat para cargar las variables de entorno de NetQuestion no entren en vigor ni siquiera después de un reinicio; los cambios pueden desaparecer después de un reinicio. Esto puede provocar que las variables de entorno de NetQuestion queden sin definir, que a su vez puede causar los siguientes tipos de anomalías:

Puede determinar si esta es la causa de los problemas de la ayuda comprobando, después del reinicio, si las variables de entorno están correctamente definidas. Si siguen sin estar definidas, puede utilizar el programa msconfig.exe, que se encuentra en el directorio del sistema Windows, para realizar los siguientes cambios de entorno:

18.0 Consideraciones especiales para Component Broker

Component Broker no utiliza la parte de cliente del sistema de ayuda de VisualAge, es decir, la parte que abre la ayuda desde una acción de F1 o de menú Ayuda en la interfaz de usuario. Esto tiene dos implicaciones importantes:

Component Broker proporciona información adicional acerca de la resolución de problemas de la ayuda en el directorio doc\readme.

19.0 Consideraciones especiales para sistemas DBCS

En sistemas en los que la ayuda instalada está parcial o totalmente escrita en Chino simplificado (locale zh_CN), Taiwanés (zh_TW), Coreano (ko_KR) o Japonés (ja_JP), es necesario realizar cambios en los mandatos vahcfg y NetQuestion de la forma siguiente:

Estos cambios son necesarios debido a que NetQuestion utiliza archivos ejecutables y servidores distintos en los sistemas de búsqueda de un solo byte y de doble byte.