Resolvendo Problemas da Ajuda nos Produtos WebSphere e VisualAge

O Sistema de Ajuda do VisualAge permite a exibição de informações de ajuda online para vários produtos de software da IBM. Ao pressionar F1 ou selecionar um item do menu Ajuda na interface do usuário de um desses produtos, um navegador deve ser aberto e a ajuda para o produto deve ser exibida. Se estiver tendo problemas ao iniciar ou utilizar a ajuda online de seu produto, este documento poderá ajudar a resolvê-los.

O Sistema de Ajuda do VisualAge consiste em três componentes principais:

Na maioria dos casos, os três componentes são executados na máquina em que o produto está instalado.

1.0 De onde iniciar

Para começar a resolver seu problema, siga estas três etapas:

  1. Determine se este documento pode ajudá-lo, lendo 1.1 Produtos que utilizam o Sistema de Ajuda do VisualAge
  2. Leia o resumo 1.2 Considerações especiais e todas as seções relacionadas que se aplicarem a seu produto ou ambiente

  3. Inicie a análise real do problema com a seção 1.3 Quais são os sintomas?

1.1 Produtos que utilizam o Sistema de Ajuda do VisualAge

Os seguintes produtos IBM utilizam o Sistema de Ajuda do VisualAge em fevereiro de 2001:

Se você estiver utilizando um produto de software IBM com release posterior a novembro de 2000 e que não está na lista acima, poderá determinar se esse produto utiliza o Sistema de Ajuda do VisualAge digitando o seguinte em um prompt de comandos:

vahcfg list /f %IMNINSTSRV% | more

e procurando o nome do produto nas linhas iniciadas com Product:. Se o produto aparecer na lista, ele utiliza o Sistema de Ajuda do VisualAge. Caso contrário, ou se você receber uma mensagem indicando que o comando não foi reconhecido, entre em contato com o suporte IBM para determinar se o produto IBM utiliza o Sistema de Ajuda do VisualAge.

1.2 Considerações especiais

Você deverá ler as seguintes seções se o produto, ambiente ou problema descrito corresponder à sua situação:

1.3 Quais são os sintomas?

No menu Ajuda do produto, escolha a Home Page Ajuda (ou o item de menu correspondente do produto). Se o menu Ajuda não estiver disponível, tente pressionar a tecla F1 em um dos painéis da interface do usuário do produto. O que acontece?

  1. Nada - vá para a seção 2.0 Nada acontece ao tentar iniciar a ajuda
  2. Um navegador é inicializado ou é trazido para o primeiro plano, mas:
    1. Não pode conectar-se ao localhost:49213 - vá para 3.0 Conectando ao servidor localhost:49213
    2. Não pode conectar-se a um host remoto e você está utilizando ajuda remota - verifique se o servidor Web foi iniciado no host remoto e se está configurado adequadamente
    3. Você recebe um erro Arquivo Não Encontrado - vá para 4.0 Erros de Arquivo Não Encontrado
    4. Você recebe outras mensagens indicando falta de arquivos durante uma pesquisa, ou imagens interrompidas na página de resultados da pesquisa - vá para 4.3 Outros erros de pesquisa envolvendo falta de arquivos
    5. Você recebe uma mensagem Erro interno do servidor ou um diálogo com a mensagem Erro no Aplicativo - vá para 5.0 Mensagens de erro interno do servidor
  3. Você recebe uma mensagem O produto xxxxx não é reconhecido pelo sistema de ajuda - vá para 6.0 Reconfigurando a ajuda
  4. Você recebe uma mensagem para utilizar um navegador que possa manipular quadros - será necessário fazer upgrade do navegador padrão para o Netscape 4.7 ou posterior, ou o Internet Explorer 5 ou posterior.
  5. A ajuda é exibida corretamente.

Se a ajuda for exibida corretamente, outros dois pontos importantes são:

  1. Você deseja acessar a ajuda em uma máquina remota. Consulte 12.0 Configurando o sistema de ajuda em um servidor Windows.
  2. Pesquisar a ajuda não funciona. Tente digitar uma consulta de pesquisa no campo de entrada de pesquisa. O que acontece?
    1. Nada - o navegador executa mas não apresenta nenhuma resposta, ou não apresenta nada durante um longo tempo - vá para 7.0 Problemas de tempo limite durante a pesquisa
    2. Você recebe um erro Arquivo Não Encontrado - vá para 4.0 Erros de Arquivo Não Encontrado
    3. Você recebe uma mensagem Erro interno do servidor - vá para 5.0 Mensagens de erro interno do servidor
    4. Você recebe uma mensagem contendo rc=73 ou O pedido de pesquisa estava vazio - vá para 8.0 Stopwords ou rc=73
    5. Você recebe uma mensagem contendo rc=32 ou alguma outra mensagem de erro de pesquisa - vá para 9.0 Outros erros de pesquisa

Se o seu problema não for um dos mencionados acima, entre em contato com o suporte IBM.  Consulte o endereço http://www.ibm.com/software/ad/support para obter outras informações.

2.0 Nada acontece ao tentar iniciar a ajuda

Nota: esta seção não se aplica ao Component Broker ou ao WebSphere Business Components. Para o Component Broker, consulte as informações sobre resolução de problemas de ajuda no diretório doc\readme.

Se nada acontecer com o VisualAge for Java, Versão 3.5, e você utilizar um ícone do desktop para lançar o IDE do VisualAge for Java, consulte 2.1 Caso especial  - VisualAge for Java, Versão 3.5.

Se nada acontecer quando você tentar lançar a ajuda, a primeira etapa deverá ser determinar se é possível lançar ajuda a partir da linha de comandos. Para isso, será necessário, primeiro, saber em qual diretório o produto foi instalado. No texto a seguir, onde você vir INSTALL_DIR, o diretório real em que o produto foi instalado deverá ser substituído, por exemplo x:\ibmvjava ou "x:\Arquivos de Programas\IBM\VisualAge for Java". Coloque o caminho inteiro entre aspas (INSTALL_DIR e outros subdiretórios ou nomes de arquivos) quando ele contiver espaços. Siga estas etapas para tentar lançar a ajuda a partir da linha de comandos:

  1. Abra uma janela de prompt de comandos.
  2. Vá para a unidade lógica em que o produto foi instalado, depois para o diretório dessa unidade. Por exemplo, se o produto estiver instalado em "g:\Arquivos de Programas\IBM\VisualAge for Java", digite o seguinte:
    g:
    cd "\Arquivos de Programas\IBM\VisualAge for Java"
  3. Vá para o diretório abaixo do diretório do produto no qual o executável vahelp.exe está localizado. É possível determinar a localização digitando primeiro:
    dir /s /b vahelp.exe

    Se isso retornar:

    g:\Arquivos de Programas\IBM\VisualAge for Java\eab\bin\vahelp.exe

    Digite então:

    cd eab\bin
  4. Emita o seguinte comando (as aspas serão necessárias somente se o caminho contiver espaços):

Se o lançamento da ajuda for bem-sucedido a partir da linha de comandos e você puder pesquisá-la com êxito, poderá haver um problema com a maneira com que seu caminho foi configurado, impedindo que a interface com o usuário do produto se conecte à DLL do sistema de ajuda. Consulte 2.1 Caso especial  - VisualAge for Java 3.5, ou, para outros produtos, tente remover e instalar o produto novamente, pois isso, às vezes, resolve esses problemas.

Se estiver satisfeito com o lançamento da ajuda através da linha de comandos como uma alternativa ou correção temporária, poderá criar um ícone em seu desktop para isso. Consulte 11.0 Criando um ícone para lançar a ajuda do produto.

Se a ajuda não for carregada a partir da linha de comandos, ou, se for carregada, mas não a partir do produto, é possível que você não tenha as associações de arquivos apropriadas configuradas para o navegador no registro do Windows. Consulte 16.0 Definindo as associações de arquivos HTML no registro do Windows.

Se alterar as associações de arquivos também não ajudar, tente o seguinte para obter um arquivo de log do sistema de ajuda:

  1. Edite o arquivo de configuração de ajuda do produto (INSTALL_DIR\HELP_DIR\CONFIG_FILE) em um editor de texto (por exemplo, Notepad) e inclua a seguinte linha no final do arquivo:
    HTMLHELP_LOG=1
  2. Salve o arquivo. Esteja atento para salvá-lo como texto corrido no caso de utilizar um editor como o WordPad.
  3. Saia e reinicie o produto IBM.
  4. Pressione F1 ou utilize o menu Ajuda para tentar lançar a ajuda a partir do produto.

No diretório apontado pela variável de ambiente TMP, você deverá ver um ou mais arquivos do tipo HTML*.C2T. Esses arquivos contêm informações de log detalhadas sobre pedidos feitos para o sistema de ajuda. Eles podem ser enviados para o suporte IBM para análise. É possível que seja cobrada uma taxa para o suporte a pedidos. Também é possível que você mesmo tente examinar esses arquivos para ver se pode determinar o que está causando a falha.

Caso não veja nenhum arquivo HTML*.C2T no diretório TEMP, tente chamar ajuda a partir da linha de comandos novamente. Se os arquivos HTML*.C2T forem criados somente a partir da linha de comandos, o problema está com o produto que chama a ajuda. Se nenhum dos métodos de chamada de ajuda produzir arquivos de log, o próprio sistema de ajuda está com problema. Entre em contato com o suporte IBM em qualquer um dos casos.

Lembre-se de remover a linha HTMLHELP_LOG=1 do arquivo de configuração de ajuda do produto quando terminar, pois o registro produzirá arquivos de log desnecessários sempre que você solicitar ajuda.

Se ainda não conseguir lançar a ajuda com nenhum dos métodos, verifique se o arquivo de configuração de ajuda do produto ainda é válido. Abra INSTALL_DIR\HELP_DIR\CONFIG_FILE em um editor e assegure que:

2.1 Caso especial - VisualAge for Java, Versão 3.5

No VisualAge for Java, Versão 3.5, se não for possível lançar a ajuda a partir do IDE, mas for possível a partir da linha de comandos, o IDE pode estar sendo chamado com o atalho errado.  Isso acontece quando você cria ou edita manualmente um atalho para o IDE em seu desktop ou no menu Iniciar e chama o IDE a partir dele. Também poderá acontecer se você estiver utilizando um atalho criado para a Versão 3.0 ou 3.02, e agora o está utilizando para lançar a Versão 3.5. Siga estas etapas para determinar se é este o problema:

  1. Saia de qualquer sessão IDE em execução do VisualAge for Java e aguarde até dez segundos depois que a última janela do VisualAge for Java desaparecer, para certificar-se de que o programa concluiu seu procedimento de encerramento.
  2. Lance o IDE do VisualAge for Java utilizando o menu Iniciar (Iniciar > Programas > IBM VisualAge for Java para Windows V3.5 > IBM VisualAge for Java).
  3. Pressione F1 no IDE.

Se a ajuda funcionar quando você chamar o IDE a partir do menu Iniciar, mas não a partir do ícone ou do atalho geralmente utilizado, esse ícone ou atalho está apontando provavelmente para VAJ_INSTALL_DIR\ide\program\ide.exe, que lançará com êxito o IDE, mas não suportará a ajuda porque a variável de ambiente PATH não aponta para a DLL do sistema de ajuda.  Esse problema pode ser resolvido editando o campo Destino do atalho para apontar para VAJ_INSTALL_DIR\ide\program\ivjenv.bat. Esse arquivo batch altera as variáveis de ambiente do Windows para que a ajuda funcione adequadamente a partir do IDE.

3.0 Conectando ao servidor localhost:49213

Se o lançamento da ajuda fizer com um navegador seja aberto ou venha para o primeiro plano, mas o navegador não puder conectar-se ao localhost:49213, há três problemas possíveis:

Verifique cada uma das subseções a seguir, para resolver os possíveis problemas com o servidor Web ou com a configuração incorreta do navegador.

3.1 HTTPDL.EXE não está executando

HTTPDL.EXE é um processo de servidor HTTP que suporta apenas acesso local. Ele faz parte do componente NetQuestion. É utilizado para atender páginas de ajuda no navegador local. Verifique se o processo HTTPDL.EXE aparece em sua lista de tarefas.

Se a tarefa não estiver presente, o sistema de ajuda poderá não ter conseguido iniciá-la. Primeiro, tente chamá-la a partir da linha de comandos para ver se ela retorna uma mensagem de erro:

  1. Vá para o diretório em que o NetQuestion está instalado (consulte 15.0 Localizando o Diretório de Instalação do NetQuestion)

  2. Emita o comando:
    httpdl -r httpd.cnf

Se ele retornar o erro A vinculação ao soquete falhou, então um processo HTTPDL.EXE já está provavelmente sendo executado na porta 49213 (a porta TCP/IP utilizada pelo processo HTTPDL.EXE). Se algum outro erro for retornado, entre em contato com o suporte IBM. Se ele retornar sem erros, verifique a lista de tarefas para assegurar que está sendo executado no background. Versões de HTTPDL.EXE datadas de 02/12/2000 ou anterior travarão o prompt de comandos caso não detectem um erro; versões posteriores continuarão a ser executadas sem travar o prompt de comandos. Se a sua versão travar o prompt de comandos, pressione Ctrl+Break e emita o seguinte comando para iniciar o processo como processo desacoplado no lugar:

nqdetach httpdl.exe -r httpd.cnf

Agora, tente recarregar a página no navegador. Se ela for exibida corretamente, o sistema de ajuda teve problemas ao iniciar o servidor HTTP (ou, para o Component Broker, o servidor não está configurado para iniciar na hora do início de sessão). Consulte 13.0 Iniciando os servidores NetQuestion automaticamente.

Se a página ainda não for exibida, consulte 3.2 HTTPDL.EXE está configurado incorretamente e 3.3 O navegador precisa de substituições de proxies.

3.2 HTTPDL.EXE está configurado incorretamente

Em alguns casos, o arquivo de configuração httpd.cnf, utilizado pelo HTTPDL.EXE, pode conter informações de caminho incorretas. Siga estas etapas para verificar se está configurado adequadamente:

  1. Utilize o diálogo Iniciar > Localizar (Iniciar > Pesquisar no Windows 2000) para localizar todos os arquivos denominados HTTPDL.EXE nas unidades de disco rígido locais. Assegure que haja apenas uma cópia. Se houver mais de uma, renomeie todas as que não estiverem no diretório de instalação do NetQuestion. (A renomeação permitirá que sejam restauradas mais tarde no caso de serem requeridas, por exemplo, por algum outro servidor.)
  2. Edite o arquivo httpd.cnf que aparece no diretório de instalação do NetQuestion. Procure todas as linhas que contêm informações sobre o caminho. A seguir, estão as linhas geralmente implicadas:
    Serverroot    C:\IMNNQ_NT
    Exec    /cgi-bin/*  C:\IMNNQ_NT\*
    Pass    /icons/*    C:\IMNNQ_NT\*
    Pass    /*          C:\IMNNQ_NT\*

    Assegure que o caminho indicado corresponda ao diretório no qual o arquivo httpd.cnf está armazenado. Se não corresponder, altere-o em todas as ocorrências acima para que reflita o caminho real.

  3. Ainda no httpd.cnf, assegure que as seguintes entradas estejam presentes:
    Hostname localhost
    Port 49213

    Substitua todas as linhas Hostname ou Port existentes pelas linhas acima, se diferirem.

  4. Se você tiver feito alterações no httpd.cnf nas etapas 2 ou 3, termine o processo HTTPDL.EXE e tente lançar a ajuda novamente.  Se isso não resolver o problema, consulte a próxima seção.

3.3 O navegador precisa de substituições de proxies

Às vezes, seu navegador não pode conectar-se ao servidor Web local HTTPDL.EXE porque ele tenta localizar a máquina denominada localhost através de um servidor proxy. Isso acontece, geralmente, quando a configuração do navegador está definida como proxy manual ou automático. Se você utilizar a configuração proxy manual, poderá modificar as definições do navegador para impedir que ele tente resolver o localhost através de um servidor proxy. Se utilizar a configuração de proxy automático, será necessário pedir ao proprietário do arquivo de configuração de proxy automático para incluir 127.0.0.1 como uma exceção de proxy no servidor proxy.

Para determinar se a configuração do navegador está definida como proxy manual e para incluir substituições de proxies se estiver, siga as etapas listadas. Estas instruções servem para as versões de navegador indicadas; se estiver utilizando uma versão de navegador diferente, as etapas poderão ser diferentes:

No Netscape 4.7:

  1. A partir do Netscape Communicator, selecione Editar > Preferências.
  2. Expanda a entrada Avançada no painel esquerdo clicando no símbolo + à sua esquerda.
  3. Selecione a entrada Proxies abaixo de Avançada.
  4. O quadro do lado direito deve indicar se você está configurado para proxy manual ou automático, ou conexão direta com a Internet. Se estiver configurado para proxy manual, continue com este conjunto de etapas; caso contrário, pare.
  5. Selecione o botão Exibir ao lado de Configuração de proxy manual.
  6. Assegure que os endereços localhost:49213 e 127.0.0.1f apareçam na lista de exceções proxy. Assegure também que estejam separados por uma vírgula, e não por pontos-e-vírgulas. (Em outras versões do Netscape, assegure que o caractere de separação seja aquele identificado no diálogo. Por exemplo, o diálogo do Netscape 4.7 contém o texto Utilize vírgulas (,) para separar as entradas.) Faça as alterações necessárias e feche os diálogos até voltar para a janela principal do navegador.

No Internet Explorer 5.0:

  1. A partir do Internet Explorer, selecione Ferramentas > Opções da Internet.
  2. Na guia Conexões, clique em Definições da rede local.
  3. Se Usar um servidor proxy estiver selecionado, continue com este conjunto de etapas, caso contrário, pare.
  4. Se vir uma caixa de opção Ignorar servidor proxy para endereços locais, assegure que esteja marcada.
  5. Selecione Avançada
  6. Assegure que as entradas localhost, localhost:49213 e 127.0.0.1 apareçam na lista de exceções proxy e que estejam separadas por ponto-e-vírgula e não por uma vírgula. Faça as alterações necessárias e feche os diálogos até voltar para a janela principal do navegador.

Também será necessário atualizar o arquivo %SystemRoot%\system32\drivers\etc\hosts incluindo a linha:

127.0.0.1     localhost

se o arquivo existir, mas essa linha ainda não estiver presente. Se você alterar este valor, poderá ser necessário sair e reiniciar o navegador para efetivar a alteração.

Se tiver feito alterações na configuração do navegador ou no arquivo ...\etc\hosts, tente recarregar a home page de ajuda no navegador. Se ainda receber erros ao tentar conectar-se com o locahost:49213, entre em contato com o suporte IBM.

Se o seu servidor proxy automático não estiver acessível quando você tentar exibir a ajuda, é possível que o navegador não consiga resolver o localhost para o endereço local 127.0.0.1. Esse problema poderá ser resolvido temporariamente (enquanto o servidor proxy estiver indisponível) alterando para conexão direta com a Internet na etapa 4 (Netscape) ou etapa 3 (Internet Explorer) acima.

4.0 Erros de Arquivo Não Encontrado

Se você receber um erro Arquivo Não Encontrado ao tentar exibir a ajuda ou tentar pesquisar, pode ser que esteja faltando um arquivo no diretório de instalação do NetQuestion. Leia as seções a seguir para encontrar mais informações.

4.1 Erros de Arquivo Não Encontrado ao tentar exibir a home page ou outra ajuda

Se você receber um erro Arquivo Não Encontrado ao tentar exibir a ajuda, provavelmente, o arquivo vahwebx.exe não está no diretório de instalação do NetQuestion. Verifique no diretório em um prompt de comandos ou no Windows Explorer para ver se o arquivo está presente. Se estiver, provavelmente há um problema com a configuração do servidor Web local do NetQuestion; httpd.cnf pode apontar para o diretório errado. Consulte 3.2 HTTPDL.EXE está configurado incorretamente acima. Se o arquivo vahwebx.exe estiver ausente, tente uma ou mais das seguintes ações:

Recarregue a página do navegador. Se agora a ajuda funcionar, você resolveu o problema. Se continuar a receber um erro Arquivo Não Encontrado, entre em contato com o suporte IBM. Se receber a mensagem Não há ajuda registrada para o produto xxxxx, consulte 6.0 Reconfigurando a ajuda.

4.2 Erros de Arquivo Não Encontrado ao tentar pesquisar

Se você receber um erro Arquivo Não Encontrado ao tentar pesquisar a ajuda, o programa de pesquisa especificado no formulário de pesquisa pode não estar instalado na localização apropriada. Siga estas etapas para determinar o nome e a localização:

  1. No produto IBM, selecione Ajuda > Pesquisar para abrir o formulário de pesquisa em uma janela do navegador.
  2. No navegador, exiba a fonte do formulário de pesquisa. Isso pode ser feito como a seguir:
  3. Na fonte do formulário, procure a string "action=". Você deverá ver algo parecido com uma das seguintes linhas:
    <form action="http://localhost:49213/cgi-bin/ivjsenus.exe"...>
    <form action="http://localhost:49213/cgi-bin/va4sall.exe"...>

    O nome do programa de pesquisa é a parte do atributo action= depois de "cgi-bin", ou seja, ivjsenus.exe ou va4sall.exe nos exemplos acima.

  4. Assegure que este arquivo esteja localizado no Diretório de instalação do NetQuestion. Se estiver lá e você continuar a receber erros de Arquivo Não Encontrado durante a pesquisa, consulte 3.2 HTTPDL.EXE está configurado incorretamente acima. Se estiver faltando, você poderá copiá-lo do CD do produto. Procure este programa de pesquisa no CD do produto. Se estiver presente, copie-o para o diretório NetQuestion. Caso contrário, entre em contato com o suporte IBM para obter uma cópia.

4.3 Outros erros de pesquisa envolvendo falta de arquivos

Você também pode receber imagens interrompidas na página de resultados da pesquisa, ou uma mensagem Cabeçalho do formulário de pesquisa não encontrado ou Rodapé do formulário de pesquisa não encontrado. Esses erros resultam da falta de outros arquivos no diretório de instalação do NetQuestion. Eles podem ser localizados no CD do produto, ou obtidos junto ao suporte IBM. Os nomes dos arquivos estão especificados dentro do formulário de pesquisa. É possível exibir a origem do formulário de pesquisa para determinar os nomes. Procure os parâmetros value= dos seguintes 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">

As entradas destacadas são as do VisualAge for Java. Entradas equivalentes de outros produtos incluem, no lugar de ivj:

5.0 Mensagens de erro interno do servidor

Uma mensagem Erro interno do servidor indica, geralmente, que um aplicativo em execução no servidor Web ficou fora do ar. Também é possível ver um diálogo do Windows com o título program.exe - Erro no Aplicativo e uma mensagem começando com A instrução em "0xnnnnnnnn" fez referência à memória em "0xnnnnnnnn". Se você desfizer esse diálogo selecionando OK, o navegador exibirá então a mensagem Erro interno do servidor.

Se esse erro ocorrer durante uma operação de pesquisa, poderá haver problemas com os índices de pesquisa do produto. Tente reconfigurar a ajuda de seu produto e digite a consulta de pesquisa novamente. Se isso não resolver o problema, entre em contato com o suporte IBM.

Se esse erro ocorrer durante a navegação normal da ajuda, poderá haver problemas com as permissões de diretório em um sistema de arquivos NTFS. Encerre a sessão do sistema Windows NT ou Windows 2000, inicie sessão novamente como administrador e assegure que todos os arquivos e pastas do diretório de instalação do NetQuestion e do diretório da ajuda do produto (_INSTALL_DIR\doc ou INSTALL_DIR\help, dependendo do produto) tenham suas permissões de segurança definidas como Todos - Controle Total. Para isso:

  1. Inicie o Windows Explorer e navegue para o diretório que deseja verificar ou alterar.
  2. Clique com o botão direito do mouse no nome do diretório.
  3. Escolha Propriedades e depois, Permissões.
  4. Assegure que ambas as caixas de opções (para substituir permissões em arquivos existentes e em subdiretórios) estejam marcadas.
  5. Inclua uma entrada de usuário para Todos se não houver uma presente, selecionando Incluir e seguindo as instruções.
  6. Assegure que a entrada Todos tenha, pelo menos, o acesso Acesso Especial (RX) (R), ou defina o nível de acesso como Controle Total.

Se tiver feito alterações nas permissões, feche esses diálogos e tente recarregar a página. Se as alterações não tiverem sido necessárias, ou se o erro persistir depois de tê-las feito, tente apagar o arquivo vahelp.cfg do diretório de instalação do NetQuestion e reconfigurar a ajuda de seu produto.

Se continuar a ver mensagens de Erro interno do servidor, entre em contato com o suporte IBM.

6.0 Reconfigurando a ajuda

Em algumas situações, o sistema de ajuda pode ter configurado incorretamente a ajuda de um determinado produto ou pode ter sido necessário remover algumas informações de configuração ao tentar corrigir uma instalação. É possível configurar novamente a ajuda do seu produto seguindo as instruções abaixo. Antes de começar, você precisa saber:

A primeira parte deste processo envolve determinar se a ajuda já está configurada e se precisa ser apenas atualizada. Para determinar se a ajuda do produto está configurada, digite o seguinte em um prompt de comandos:

vahcfg list /f %IMNINSTSRV% | more

Você deverá ver um conjunto de listagens de produtos e componentes de cada produto que foi configurado para obter ajuda. Se você vir um produto cujo diretório corresponda ao diretório do produto, anote o nome do produto. Por exemplo, se a saída de vahcfg list incluir o seguinte:

Produto: va400 (Sistema de Ajuda do IBM WebSphere Development Tools for AS/400)
Diretório Gravável: C:\Arquivos de Programas\IBM\WDT400\help
Não há arquivos de atualização para esse produto
Comp: qadtswin (WebSphere Development Tools para AS/400)
Arquivo zip: C:\Arquivos de Programas\IBM\WDT400\help\qadtswin.zip
Índice: va45uadt
...

O nome do produto é va400. Se você vir uma entrada para seu produto, será possível configurar a ajuda novamente utilizando o comando vahcfg regen. Se não vir uma entrada para ele, será necessário configurar a ajuda novamente utilizando o comando vahcfg install. Ambos são descritos posteriormente nesta seção.

6.1 Espaço livre em disco

Antes de executar vahcfg regen ou vahcfg install, você também deve assegurar que o disco no qual o diretório de documentação está localizado tenha espaço livre suficiente para acomodar os índices de pesquisa da ajuda do produto. Esses índices são extraídos dos arquivos *.zip no diretório de documentação e gravados em subdiretórios do diretório de documentação pelo programa vahcfg. Como regra geral, você deve ter, pelo menos, a mesma quantidade de espaço livre no disco que a quantidade de espaço utilizada pelos arquivos zip no diretório de documentação.

6.2 Utilizando vahcfg regen

Para executar vahcfg regen, emita o seguinte comando:

vahcfg regen /p prodname /f %IMNINSTSRV%

em que prodname corresponde ao nome do produto anotado ao executar vahcfg list.

6.3 Utilizando vahcfg install

Para executar vahcfg install, emita o seguinte comando:

vahcfg install /w docdir /f %IMNINSTSRV%

em que docdir é o caminho completo para o diretório que contém os arquivos de ajuda do produto. Se esse diretório contiver espaços internos (por exemplo, c:\Arquivos de Programas\IBM\..., coloque o caminho inteiro dele entre aspas.

6.4 Depois de executar vahcfg install ou vahcfg regen

Depois da instalação ou regeneração (que pode levar vários minutos), tente recarregar a ajuda. Se o problema que você estava tentando corrigir persistir, siga as etapas de 6.5 Obtendo um arquivo de log de vahcfg regen ou vahcfg install, entre em contato com o suporte IBM e encaminhe a eles o arquivo de log.

6.5 Obtendo um arquivo de log de vahcfg regen ou vahcfg install

Se você tentou regenerar ou instalar a ajuda de seu produto utilizando vahcfg regen ou vahcfg install e a tentativa não resolveu os problemas da ajuda, tente o seguinte para produzir um arquivo de log que o suporte IBM possa utilizar para diagnóstico adicional do problema:

  1. Em um prompt de comandos, defina a variável de ambiente VAHCFG_LOG para apontar para um novo arquivo em um diretório gravável. Por exemplo:
    SET VAHCFG_LOG=c:\config.log
  2. Se você tentou vahcfg install e teve problemas, execute os dois seguintes comandos:
    vahcfg remove /p prodname /f %IMNINSTSRV%
    vahcfg install /w docdir
  3. Se você tentou vahcfg regen e teve problemas, execute o mesmo comando vahcfg regen novamente.

Em seguida, você pode fornecer o arquivo de log gerado para o suporte IBM.

Observe que algumas versões anteriores de vahcfg não produzem um arquivo de log. Versões que não suportam log terão sua saída impressa na tela; versões que suportam log imprimirão uma mensagem indicando onde as informações estão sendo registradas.

7.0 Problemas de tempo limite durante a pesquisa

O sistema de pesquisa do NetQuestion é extremamente rápido na localização de correspondências, exceto para as consultas de pesquisa mais genéricas. Se você procurar correspondências para a string a*, o sistema de pesquisa terá que localizar todos os documentos que contenham pelo menos uma palavra que comece com a letra a, portanto, isso sempre leva muito tempo. Porém, se a pesquisa for específica, você pode esperar resultados da pesquisa em poucos segundos, no máximo. Se uma pesquisa parecer levar muito tempo (por exemplo, além de 1 minuto), é possível que esteja havendo um problema relacionado à utilização do Netscape Navigator 4.5 ou posterior em um sistema Windows 2000 . (Esse problema também ocorre em alguns sistemas Windows NT.)

Existe um problema conhecido com o Netscape (versões 4.5 a 4.74 e em outras, possivelmente) em algumas máquinas do Windows 2000, que pode tornar extremamente lenta a pesquisa da ajuda online. Ao submeter um formulário dessas versões do Netscape, o aplicativo Netscape utiliza a maioria dos ciclos de processador disponíveis de sua máquina até que uma resposta seja recebida do sistema remoto. (Isso pode ser verificado abrindo a página do Gerenciador de tarefas do Windows durante essa pesquisa, mudando para a guia Processos e clicando no cabeçalho da coluna CPU. Se você estiver tendo o problema descrito aqui, o netscape.exe aparecerá no início dessa lista e estará utilizando 97-99% de tempo da CPU.)

Essa utilização de CPU não é normalmente um problema ao efetuar uma pesquisa remota (por exemplo, em um site na Web). Entretanto, como o programa de pesquisa do produto está sendo executado em sua própria máquina local, o fato de que o Netscape ocupa muito tempo de CPU significa que sobra muito pouco tempo de CPU para o programa de pesquisa executar sua pesquisa. Como resultado, uma ação de pesquisa que deveria retornar um resultado em um segundo pode levar vários minutos no Windows 2000.

Esse problema de desempenho pode ser evitado no Windows 2000 selecionando-se uma janela diferente, não-Netscape, depois de cada vez que uma pesquisa for submetida. Normalmente, isso faz com que o Netscape pare de utilizar ciclos excessivos da CPU enquanto aguarda uma resposta e os resultados da pesquisa são, geralmente, exibidos em um segundo depois de realizar essa troca de janela. A mesma técnica também pode funcionar no Windows NT, embora com menor constância.

Alternativamente, você pode utilizar o Microsoft Internet Explorer para exibir a ajuda, uma vez que o problema de desempenho não ocorre com esse navegador.

8.0 Stopwords ou rc=73

Uma das seguintes mensagens de erro poderá ser recebida ao executar uma pesquisa do sistema de ajuda a partir de seu navegador:

Isso pode ocorrer em duas situações:

O código de retorno 73, geralmente, não é retornado em um pedido de pesquisa realmente vazio, apenas em um composto somente de stopwords. Se você puder reproduzir com segurança a mensagem que indica um pedido de pesquisa vazio quando a string de pesquisa estiver claramente não vazia (e não for uma pesquisa somente com stopwords), seu formulário de pesquisa poderá estar danificado. Localize os formulários de pesquisa hgssrch.htm e hgcsrch.htm no diretório de ajuda do produto (geralmente INSTALL_DIR\doc ou INSTALL_DIR\help) e forneça-os ao representante de suporte quando entrar em contato com o suporte IBM.

9.0 Outros erros de pesquisa

Você poderá ver várias outras mensagens de erro ao tentar pesquisar. Se o erro for um dos relacionados a seguir, tente a ação recomendada antes de entrar em contato com o suporte IBM.

9.1 O servidor NetQuestion especificado não está disponível. (rc=33)

Causa: O cliente de ajuda não conseguiu iniciar o serviço de pesquisa (ou, no Component Broker, o serviço de pesquisa não está configurado para iniciar automaticamente na hora do início de sessão).  Isso poderá ocorrer se você estiver pesquisando na máquina local (http://localhost:49213) ou em um servidor de ajuda remoto.

Ação recomendada (ajuda local):

Consulte 3.1 HTTPDL.EXE não está executando e, especificamente, a seção sobre importação de entradas de registro autostart, para que o serviço de pesquisa seja iniciado automaticamente no início da sessão. Para obter uma solução rápida, abra um prompt de comandos e digite:

imnss start server

Se esse comando retornar com uma mensagem que inclua a linha:

O serviço de pesquisa foi iniciado.

você conseguirá executar a pesquisa novamente, sem esse erro rc=33.

Ação recomendada (ajuda remota):

O processo de pesquisa do NetQuestion da máquina do servidor pode não estar sendo executado porque a máquina foi reinicializada e ninguém está atualmente com sessão iniciada nela. Consulte 14.0 Iniciando o serviço de pesquisa do NetQuestion na hora da inicialização.

9.2 Sem destino para pesquisa especificada

Causa: O programa de pesquisa não recebeu nenhum nome de índice válido no pedido de pesquisa. O formulário de pesquisa pode ter sido danificado, ou os índices especificados podem não estar mais registrados, ou pode haver um problema com a instalação do NetQuestion.

Ação recomendada: Primeiro, exclua todos os arquivos hg*.htm do diretório de ajuda do produto (INSTALL_DIR\doc ou INSTALL_DIR\help). Em seguida, tente reconfigurar a ajuda do produto. Se o problema persistir, poderá ser necessário reinstalar o NetQuestion e configurar a ajuda do produto novamente.

9.3 Cabeçalho do formulário de pesquisa não encontrado | Rodapé do formulário de pesquisa não encontrado

Causa: O formulário de pesquisa especificou um cabeçalho ou um rodapé não existente (um arquivo contendo um fragmento de HTML a ser colocado acima ou abaixo dos resultados da pesquisa).

Ação recomendada: Consulte 4.2 Erros de Arquivo Não Encontrado ao tentar pesquisar para obter outras informações.

9.4 Consulta muito complexa. Formule o pedido de pesquisa novamente. (rc=22)

 Causa: Você digitou uma consulta de pesquisa que tem muitas palavras correspondentes. O mecanismo de pesquisa não consegue manipular uma consulta que contém correspondências para mais de 1024 palavras diferentes. Por exemplo, se você digitar a string de pesquisa "a* b* c* d*" (sem as aspas), está solicitando todos os documentos que contenham palavras que comecem com uma das letras a, b, c ou d. Como muitas palavras correspondem a esse critério de pesquisa, o mecanismo de pesquisa não pode produzir uma lista ordenada significativa de número de ocorrências de pesquisa, portanto, ele não tenta.

Ação recomendada: Digite um pedido de pesquisa que produza um número de ocorrências menor.

9.5 A condição especificada é inválida

Causa: Você digitou uma consulta de pesquisa que não é logicamente válida. Por exemplo, uma consulta de pesquisa "-java" (mostrar todos os documentos que não contenham a palavra java) não é considerada válida.

Ação recomendada: Digite um pedido de pesquisa que contenha pelo menos um termo permitido.

9.6 O arquivo de configuração do NetQuestion (NETQ.CFG) está errado ou não pôde ser encontrado. (rc=77)

Causa: Esse erro pode ocorrer quando o programa de pesquisa não consegue ler as variáveis de ambiente requeridas para operação bem-sucedida da pesquisa. Se você tiver configurado a ajuda para ser executada em um servidor Web que não o HTTPDL.EXE do NetQuestion, poderá ser necessário alterar as definições do servidor Web para assegurar que determinadas variáveis de ambiente fiquem visíveis para o CGI da pesquisa (o programa chamado a partir do parâmetro "action=" da tag <form> no formulário de pesquisa). Em alguns servidores Web, as variáveis de ambiente do sistema ficam ocultas por padrão. As variáveis que o CGI da pesquisa precisa acessar são IMNINSTSRV e IMNINST. O Netscape Enterprise Server é um exemplo de um servidor Web que oculta variáveis de ambiente por padrão.

Ação recomendada: Modifique as definições do servidor Web para exportar essas variáveis de ambiente para os aplicativos CGI do servidor Web manualmente, ou para tornar todas as variáveis de ambiente locais visíveis para os CGIs. No Netscape Enterprise Server isso pode ser feito seguindo estas etapas:

  1. Abra x:\netscape_enterprise_server_directory\https-server_name\config\obj.conf, em que netscape_enterprise_server_directory é o diretório em que você instalou o NES e server_name é o nome do servidor de ajuda, especificado durante a instalação do NES.
  2. Será necessário que você saiba os valores das variáveis de ambiente do NetQuestion. Em um prompt de comandos, digite:
    set imn

    O sistema deve retornar definições para as variáveis IMNINST e IMNINSTSRV, tais como:

    IMNINST=help
    IMNINSTSRV=C:\IMNNQ_NT
  3. Com base nos resultados acima, inclua as seguintes linhas no obj.conf, logo abaixo das outras linhas que começam com uma diretriz "Init". Certifique-se de utilizar somente BARRAS NORMAIS (/) ao incluir o caminho IMNINSTSRV:
    Init fn="init-cgi" IMNINSTSRV=c:/imnnq_nt
    Init fn="init-cgi" IMNINST=help
  4. Pare o Netscape Enterprise Server. Se você vir o seguinte aviso:

    "AVISO: Os arquivos de configuração foram editados manualmente. Utilize este botão para carregar os arquivos de configuração mais recentes."

    Clique em Carregar Arquivos de Configuração.

  5. Inicie o Netscape Enterprise Server
  6. Tente a pesquisa novamente.

Para outros servidores Web, consulte a documentação do servidor Web para obter informações sobre como tornar as variáveis de ambiente visíveis aos aplicativos CGI.

9.7 Outros erros NETQ.CFG ou rc=32

Causa: Um erro rc=32 ou um erro que menciona o arquivo NETQ.CFG ocorre quando o NetQuestion não pode acessar adequadamente um índice de produto. Isso pode acontecer porque a instalação do NetQuestion ou um determinado índice foi danificado, ou pode acontecer somente na primeira pesquisa executada em um determinado índice após uma reinicialização. Observe que, embora a mensagem de alguns formulários desse erro mencione o arquivo NETQ.CFG, este arquivo não existe realmente; o erro refere-se a problemas com outros arquivos de configuração de índice do NetQuestion.

Ação recomendada: Determine a causa provável do problema e corrija conforme descrito abaixo:

9.8 Erros de redefinição do índice ou rc=76

Se uma pesquisa retornar com uma mensagem de erro rc=76, um ou mais dos índices de pesquisa podem precisar ser redefinidos. Siga esta etapas para redefinir os índices:

  1. Exiba a fonte do formulário de pesquisa a partir do navegador. Procure todas as linhas que contêm a tag HTML <input type=hidden name=indexname value=ixname>
  2. Para cada valor ixname, digite o seguinte comando em um prompt de comandos:
    nqreset ixname
  3. Tente a pesquisa novamente depois de redefinir todos os índices envolvidos. Se o erro de pesquisa persistir ou tornar a ocorrer mais tarde, entre em contato com o suporte IBM.

10.0 Reinstalando o NetQuestion

Em algumas situações, a única maneira de fazer com que a ajuda funcione adequadamente é remover a instalação do NetQuestion e instalá-lo novamente, depois reconfigurar a ajuda de produtos que utilizam o Sistema de Ajuda do VisualAge. Observe que a remoção da instalação do NetQuestion pode remover índices de pesquisa utilizados por produtos como o IBM DB2, que não utiliza o Sistema de Ajuda do VisualAge podendo, portanto, impedir a pesquisa da ajuda desses produtos depois que o NetQuestion é instalado novamente. Poderá ser necessário instalar novamente o produto em questão para restaurar seus índices de pesquisa.

Nas instruções a seguir, emita todos os comandos a partir de um prompt de comandos. Antes de começar, é necessário determinar o diretório de instalação do NetQuestion.

10.1 Executar vahcfg remove para todos os produtos listados

O programa de remoção da instalação do NetQuestion, uninstnq.exe, no diretório NetQuestion, removerá somente o NetQuestion se nenhum índice estiver registrado. Você pode, primeiro, remover todos os índices registrados por produtos que utilizam o Sistema de Ajuda do IBM VisualAge emitindo o comando vahcfg remove para cada produto citado. Siga estas etapas:

  1. Execute o comando vahcfg list /f %IMNINSTSRV% | more e anote o nome de cada produto (conforme descrito em 6.0 Reconfigurando a ajuda).
  2. Para cada nome de produto, execute o comando vahcfg remove /p prodname /f %IMNINSTSRV%

10.2 Remover todos os índices restantes

Depois de remover todos os produtos, você pode verificar se algum índice ainda está registrado para outros produtos digitando o seguinte comando:

imnixlst

Se a lista resultante contiver entradas começando com DB2, CXX ou VAC, provavelmente, ainda há índices registrados com produtos como o DB2, Compiladores C e C++ da IBM, ou VisualAge C++ 4.0, que não utilizam o Sistema de Ajuda do VisualAge. Se você prosseguir com a remoção manual da instalação do NetQuestion, esses índices serão perdidos e o produto respectivo poderá precisar ser reinstalado para pesquisar a ajuda desses produtos novamente. Se esses índices ainda estiverem listados e você estiver preparado para perder as capacidades de pesquisa desses produtos ou para reinstalar todos eles, continue a excluir os índices restantes como a seguir:

Se os índices cujos nomes começam com IVJ3, VJ32, IWZ ou VA45 estiverem listados, será seguro excluí-los porque poderão, mais tarde, ser restaurados com vahcfg install.

Se não conseguir excluir todos os índices restantes por causa de um erro do NetQuestion, poderá ser necessário removê-lo manualmente (consulte a seção 11.4 abaixo).

10.3 Executar uninstnq

Emita o comando uninstnq e aguarde alguns minutos, até perceber que o diretório NetQuestion está quase vazio. O diretório não deve conter nenhum arquivo que comece com imn* ou imq*. Pode ser necessário aguardar até dez minutos para a conclusão. Se, depois de dez minutos, o diretório ainda contiver arquivos imn* ou imq*, é possível que ainda haja índices registrados com o serviço de pesquisa (nesse caso, retorne para a seção 11.2), ou a instalação do NetQuestion pode estar danificada, (prossiga com a seção 11.4). Caso contrário, reinicialize e prossiga com a seção 11.5.

10.4 Remover manualmente o NetQuestion

Se não conseguir remover o NetQuestion utilizando uninstnq.exe, poderá removê-lo manualmente como a seguir:

  1. Execute o programa regedit a partir de um prompt de comandos ou de Iniciar > Executar.
  2. Expanda a entrada de registro HKEY_LOCAL_MACHINE\Software\IBM.
  3. Exclua a entrada NetQuestion e todas suas subentradas.
  4. Remova o nome do diretório NetQuestion da variável de ambiente PATH.
  5. Remova a variável de ambiente IMNINSTSRV.
  6. Exclua todos os arquivos do diretório NetQuestion que correspondam a essas especificações de caracteres curinga, digitando o seguinte comando enquanto esse for o diretório atual em um prompt de comandos:
    del http*.* 302.* 404.* 500.* im*.* nq*.*
  7. Exclua o subdiretório "instance" do Explorer, ou digitando o comando:
    rmdir /s /q instance
  8. Reinicialize.

Para alterar ou remover as variáveis de ambiente, siga as etapas específicas da plataforma abaixo:

10.5 Reinstalar o NetQuestion

Para instalar o NetQuestion novamente, você precisará do CD do produto ou de um arquivo zip de instalação do NetQuestion do suporte IBM. Os seguintes produtos possuem uma cópia instalável do NetQuestion no CD do produto:

Para outros produtos, é possível saber se há uma cópia instalável do NetQuestion no CD procurando um arquivo denominado ntq_sbcs.iss. O diretório que contém esse arquivo deve conter um arquivo setup.exe que possa lançar a instalação do NetQuestion.

Se você receber um arquivo zip de instalação da IBM, descompacte-o com o comando unzip em um diretório temporário.

Depois de obter uma cópia instalável do NetQuestion, siga estas etapas:

  1. Lance o setup.exe dando um clique duplo nele no Explorer ou abrindo um prompt de comandos, indo para o diretório que contém o código de instalação do NetQuestion e digitando setup.
  2. Escolha uma instalação completa.
  3. Substitua o diretório padrão para apontar para o diretório no qual o NetQuestion foi instalado anteriormente. Se você substituir o diretório padrão e apontar para um novo diretório, assegure que o nome do novo diretório tenha, no máximo, 8 caracteres, não contenha espaços e esteja no nível raiz de uma unidade. Isso reduzirá a probabilidade de futuros problemas na ajuda. 
  4. Reinicialize quando a instalação for concluída.
  5. Se os diretórios novo e antigo do NetQuestion forem diferentes, copie o cabeçalho, o rodapé, os arquivos .gif, o programa de pesquisa e os arquivos do sistema de ajuda (vah*.exe, vahwebx.cat) do formulário de pesquisa do diretório antigo para o novo. Consulte 4.0 Erros de Arquivo Não Encontrado para obter informações sobre esses arquivos.

10.6 Reconfigurar a ajuda de produtos instalados

Para cada produto removido manualmente do sistema de ajuda (utilizando vahcfg remove, conforme orientado na seção 11.1), execute vahcfg install, conforme descrito em 6.0 Reconfigurando a ajuda. Agora, você deve conseguir procurar e pesquisar na ajuda do produto. Se os erros persistirem, verifique outras seções deste documento para obter as possíveis soluções ou entre em contato com o suporte IBM.

11.0 Criando um ícone para lançar a ajuda do produto

Se você não puder lançar a ajuda a partir da interface do usuário do produto, crie um ícone para lançá-la dando um clique duplo nele (para que você possa, pelo menos, utilizar a ajuda enquanto trabalha na resolução de problemas).

Observação

  1. No Component Broker, o menu Iniciar já contém uma entrada para a Biblioteca online do Component Broker para lançar a ajuda do produto, e as informações nesta seção não são aplicáveis.
  2. No Websphere Development Tools para AS/400, o menu Iniciar já contém um conjunto de entradas para lançar a ajuda do produto (Iniciar - Arquivos de Programas - IBM Websphere Development Tools para AS/400 - Documentação) mas você também pode criar seu próprio ícone no desktop utilizando o método descrito abaixo.
  3. No VisualAge TPF para Windows NT, em estações de trabalho que possuem a ajuda instalada localmente, o menu Iniciar já contém uma entrada para lançar a ajuda do produto. Siga estas etapas somente se tiver escolhido acessar a ajuda remotamente, ou se desejar incluir o ícone em seu desktop, além de tê-lo no menu Iniciar.

É possível criar um atalho para lançar a ajuda do produto como a seguir:

  1. Na barra de tarefas, clique com o botão direito do mouse e selecione Minimizar Todas as Janelas.
  2. Em uma área vazia no desktop, clique com o botão direito do mouse e selecione Novo - Atalho.
  3. No diálogo Criar Atalho, clique em Procurar para localizar o diretório de instalação do produto.
  4. Procure nesse diretório ou em um de seus subdiretórios o arquivo vahelp.exe. No VisualAge for Java, está no diretório eab\bin.
  5. Dê um clique duplo no arquivo vahelp.exe. No diálogo Criar Atalho, a área de entrada da Linha de Comandos deve agora mostrar o caminho completo (entre aspas se o caminho contiver espaços) para vahelp.exe.
  6. Edite a área de entrada da Linha de Comandos e inclua o seguinte (incluindo um espaço inicial) depois do final da linha:
    instance "INSTALL_DIR\DOC_DIR\CONFIG_FILE" open index.htm

    em que INSTALL_DIR é o diretório em que o produto está instalado, DOC_DIR é, geralmente, doc ou help, e CONFIG_FILE é o nome do arquivo de configuração de ajuda do produto (ivjhlp.cfg no VisualAge for Java; consulte 2.0 Nada acontece ao tentar iniciar a ajuda para obter informações sobre como determinar diretórios e nomes dos arquivos de configuração de outros produtos). Assegure que o caminho completo para o arquivo de configuração esteja entre aspas no caso de conter espaços.

  7. Clique em Próximo.
  8. Digite um nome para o atalho, por exemplo, "Ajuda Online do IBM VisualAge for Java".
  9. Clique em Finalizar.
  10. Dê um clique duplo no atalho criado no desktop para assegurar que funciona.
  11. Para alterar a aparência do ícone de atalho, clique com o botão direito do mouse no atalho, escolha Propriedades e feche a guia Atalho, selecione Alterar Ícone e procure um novo ícone na lista de ícones disponíveis ou no sistema de arquivos.

O ícone criado pode ser incluído no menu Iniciar dando um clique com o botão direito do mouse no ícone, escolhendo Copiar no menu pop-up e, depois, no Windows Explorer, passando pelo diretório de instalação do Windows, em ...\Perfis\Todos os Usuários\Menu Iniciar, e colando-o nesse diretório ou em um de seus subdiretórios apropriados.

12.0 Configurando o sistema de ajuda em um servidor Windows

É possível instalar e configurar o sistema de ajuda em um servidor Web do Windows NT ou Windows 2000, para que outros membros de sua organização possam exibir e pesquisar a ajuda online em uma rede sem ter que utilizar o NetQuestion e o código do sistema de ajuda instalado em suas estações de trabalho.

Notas sobre o produto

  1. No VisualAge COBOL e VisualAge TPF, os usuários podem escolher não instalar o NetQuestion ou o sistema de ajuda localmente. Em outros produtos, os usuários podem remover as cópias locais seguindo apenas as etapas de remoção nas seções 6.0 Reconfigurando a Ajuda e 10.0 Reinstalando o NetQuestion.
  2. No VisualAge TPF, o produto vem com utilitários integrados para configurar a ajuda para entrega do servidor. Se a instalação for feita a partir de setup.exe no CD do produto, será perguntado se a ajuda será acessada remotamente por outros usuários na rede. Responda Sim. Se você tiver feito download do pacote de ajuda da Web, execute insthelp.exe.

Para fazer a instalação dessa rede, é necessário ter o software do servidor Web, como o PWS (Peer Web Services) da Microsoft, ou o IIS da Microsoft, instalado no servidor. O servidor Web deve ter um diretório scripts. (No PWS e IIS, o diretório scripts está localizado geralmente em x:\inetpub.) Depois de instalar o software do servidor, conclua as seguintes etapas:

  1. Instale o produto de software da IBM no servidor.
  2. Copie os seguintes arquivos do diretório NetQuestion para o diretório x:\inetpub\scripts, se estiverem presentes:
    vahwebx.exe
    vahwebx.cat
    vahelp.cfg
    *foot.htm
    *head.htm
    *henus.htm

    Os três primeiros arquivos são necessários; os arquivos subseqüentes devem ser copiados se estiverem presentes, mas se não estiverem no diretório NetQuestion, não há necessidade de sua presença no diretório x:\inetpub\scripts.

  3. Edite o arquivo imnmap.dat, que está no diretório %IMNINSTSRV%\instance\help\data\. Este arquivo contém a parte inicial do endereço da Web de cada índice. Altere todas as ocorrências da substring http://localhost:49213/cgi-bin para a forma http://server.city.domain.organization/scripts (tal como http://cobweb.stl.ibm.com/scripts). Essa alteração faz com que os links gerados para o número de ocorrências de pesquisas produzam um endereço remoto da Web (não localhost), para que um usuário possa segui-los de qualquer computador.
  4. Edite os arquivos a seguir, que foram criados no diretório de ajuda de seu produto: hgssrch.htm e hgcsrch.htm. Altere http://localhost:49213/cgi-bin para a forma http://server.city.domain.organization/scripts.
  5. Copie o CGI de pesquisa especificado (por exemplo, iwzihenes.exe, ivjsenus.exe, va4sall.exe) nos formulários de pesquisa a partir do diretório NetQuestion para o diretório x:\inetpub\scripts.
  6. Copie *star*.gif para um novo subdiretório icons em x:\inetpub\wwwroot.
  7. No Component Broker, altere a definição da variável de ambiente VABHELP de http://localhost:49213/cgi-bin para a forma http://server.city.domain.organization/scripts. Em outros produtos, deixe que cada usuário edite seu arquivo de configuração do produto (*.cfg no diretório de ajuda do produto) e altere as seguintes entradas para os valores mostrados:

HTML_HOSTNAME=server.city.domain.organization
CGI_BIN_DIR=scripts
START_LITE_DAEMON=0
START_NETQ_DAEMON=0

Os usuários devem, então, conseguir acessar a ajuda baseada no servidor, simplesmente pressionando a tecla F1 ou selecionando um item de menu Ajuda de seu aplicativo IBM. Ou podem acessar a ajuda utilizando a seguinte URL:

http://YourHostname/scripts/vahwebx.exe/help/prodname/Extract/0/index.htm

em que prodname é:

Se, mais tarde, você executar vahcfg install ou vahcfg regen no sistema servidor, será necessário editar o arquivo de mapeamento na etapa 3 acima novamente.

Como os usuários modificaram os arquivos de configuração de ajuda do produto para apontar para o servidor, eles poderão executar com segurança o seguinte comando para excluir todos os arquivos *.toc, *.htm e *.zip, além dos arquivos de índice da pesquisa, do diretório de ajuda do produto:

vahcfg remove /p prodname /f %IMNINSTSRV%

ou poderão simplesmente excluir os arquivos *.toc, *.htm e *.zip manualmente. Entretanto, este método não excluirá os diretórios de índice abaixo do diretório de ajuda do produto, portanto, eles também precisarão ser excluídos manualmente.

13.0 Iniciando os servidores NetQuestion automaticamente

Consulte 14.0 Iniciando o serviço de pesquisa do NetQuestion na hora da inicialização em vez desta seção, se estiver configurando o servidor em uma configuração de ajuda em rede.

Você pode definir os servidores HTTP e de pesquisa para serem iniciados automaticamente no início de sessão definindo duas entradas de registro em seu sistema. Para definir essas entradas, siga estas etapas:

  1. Crie um arquivo denominado NetQuestionAutoStart.reg utilizando um editor de texto como o NOTEPAD. Digite o seguinte texto (utilize copiar e colar):
    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. Altere a string %IMNINSTSRV% em sua versão para o valor do diretório de instalação do NetQuestion.
  3. Salve o arquivo.
  4. Dê um clique duplo em NetQuestionAutoStart.reg no Windows Explorer.

Isso importará duas entradas para seu registro para que, na próxima vez em que você iniciar sessão (ou reinicializar no Windows 95, Windows 98 ou Windows ME) os servidores sejam iniciados automaticamente.

14.0 Iniciando o serviço de pesquisa do NetQuestion na hora da inicialização

Se você estiver utilizando uma configuração de ajuda em rede no qual a ajuda é enviada a partir de um servidor e não de sua própria máquina, poderá haver problemas na execução de pesquisas na máquina remota. Quando o daemon de pesquisa do NetQuestion é configurado para iniciar automaticamente (durante a instalação do produto, ou depois de você seguir as etapas de 13.0 Iniciando os servidores NetQuestion automaticamente) o daemon não é realmente iniciado até que um usuário inicie sessão na máquina do servidor. Isso significa que, após uma reinicialização do sistema, antes que o usuário da máquina inicie sessão primeiro, o daemon de pesquisa não está em execução.  É possível, entretanto, utilizar o Programador de Tarefas do Windows para iniciá-lo na hora da inicialização. As instruções desta seção aplicam-se à máquina que está servindo a ajuda.

Nota: Se você não estiver utilizando uma configuração de ajuda da rede, não há necessidade de seguir as etapas desta seção.

Antes de começar, é necessário determinar o diretório de instalação do NetQuestion. Também é possível que você queira realizar alguma limpeza manual no registro. Seu registro pode conter entradas para iniciar o daemon de pesquisa do NetQuestionat na hora da inicialização. Se você for iniciar o daemon na hora da inicialização, a entrada do registro é desnecessária. Para limpar o registro:

  1. No menu Iniciar, selecione Executar.
  2. Digite regedit e clique em OK.
  3. Siga a estrutura em árvore para HKEY_LOCAL_MACHINE - SOFTWARE - Microsoft - Windows - CurrentVersion - Run
  4. No painel do lado direito da pasta Executar, selecione e exclua a seguinte chave:
  5. Também será possível remover a entrada autostart do servidor HTTP do NetQuestion se você não for acessar a ajuda diretamente na máquina do servidor. Para fazer isso, selecione e exclua a seguinte chave:
  6. Feche o editor de registro.

Agora, você pode informar ao Windows para iniciar os servidores na hora da inicialização. Primeiro, verifique se o Programador de Tarefas do Microsoft Windows está instalado na máquina que atua como um servidor de ajuda:

  1. Abra o Windows Explorer ou o NT Explorer.
  2. Verifique as subpastas da pasta Meu Computador. Se, junto com as unidades local e de rede, você vir uma pasta com o título Tarefas Programadas, o Programador de Tarefas está instalado em sua máquina. Salte para a etapa 5.
  3. Se o Programador de Tarefas não estiver instalado em sua máquina, será necessário instalá-lo. O Programador de Tarefas é fornecido com o Internet Explorer. Ele é encontrado na categoria "Aperfeiçoamentos Adicionais do Explorer", e é um componente adicional que precisará ser instalado. O método para incluir componentes no Internet Explorer depende da sua versão do Internet Explorer e de que versão do Windows está sendo utilizada. Consulte o documento "How to Add and Remove Internet Explorer Components" (Como Incluir e Remover os Componentes do Internet Explorer), no endereço http://support.microsoft.com/support/kb/articles/Q171/2/29.ASP, para obter mais detalhes.
  4. Depois de ter instalado o Programador de Tarefas, reinicialize se for solicitado, e abra Meu Computador.

Para configurar o Servidor de Pesquisa NetQuestion para iniciar na hora da inicialização no servidor de ajuda:

  1. Na pasta Tarefas Programadas, clique em Incluir Tarefa Programada
  2. O assistente para Incluir Tarefa Programada é aberto. Clique em Próximo para continuar.
  3. Selecione um programa arbitrário na lista (mais tarde, isso será alterado) e clique em Próximo.
  4. Nomeie a tarefa. Por exemplo, digite "Servidor de Pesquisa NetQuestion".
  5. Selecione o botão de opção Quando meu computador for iniciado e clique em Próximo.
  6. Digite o nome do usuário que possuirá o processo (por exemplo, o administrador do servidor) e digite sua senha conforme solicitado. Clique em Próximo.
  7. Selecione a caixa de opção Abrir propriedades avançadas desta tarefa ao clicar em 'Finalizar'.
  8. Clique em Finalizar.
  9. A página Propriedades do Servidor de Pesquisa NetQuestion é aberta. Na guia Tarefa, altere o campo executar para NQ_DIR\imnss.exe start server
    em que NQ_DIR é o diretório de instalação do NetQuestion.
  10. No campo Iniciar em, digite o diretório de instalação do NetQuestion.
  11. Assegure que a caixa de opção Ativado esteja selecionada.
  12. Na guia Definições, desmarque Parar a tarefa se ela for executada durante xxx horas e xxx minutos.

Nota: Depois que a máquina do servidor de ajuda for reinicializada, poderá levar um minuto ou mais depois que a tela de início de sessão aparecer para que o Windows inicie o servidor de pesquisa.

15.0 Localizando o Diretório de Instalação do NetQuestion

É possível determinar a localização do diretório de instalação do NetQuestion abrindo um prompt de comandos e digitando:

set IMNINSTSRV

O diretório retornado é o diretório de instalação do NetQuestion. Se a variável não estiver definida, você poderá determinar o diretório de instalação consultando o registro do Windows. Digite regedit em um prompt de comandos e expanda as entradas de registro para a chave HKEY_LOCAL_MACHINE\SOFTWARE\IBM\NetQuestion\CurrentVersion\Installation Directory. A entrada "Diretório" dessa chave deve apontar para o diretório de instalação do NetQuestion.

No Windows 95, Windows 98 e Windows ME, se a variável de ambiente IMNINSTSRV não estiver definida, mas você puder localizar o diretório no registro, poderá ser necessário editar o arquivo autoexec.bat. (Se encontrar essa condição no Windows Millennium Edition, consulte 17.0 Considerações especiais sobre o Windows Millennium Edition.) O processo de instalação do NetQuestion deve ter modificado o autoexec.bat para incluir um comando para chamar o arquivo batch imnenv.bat armazenado no diretório NetQuestion. O comando incluído parece com o seguinte:

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

Se esta linha estiver faltando, ou se _NETQ_DIR_ apontar para o diretório errado, inclua a linha com o diretório NetQuestion correto. Também será necessário verificar se o arquivo batch imnenv.bat sendo chamado no autoexec.bat realmente existe e se contém entradas que apontam para o diretório atual em vez de para algum outro diretório do NetQuestion. O conteúdo de imnenv.bat deve ser:

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

16.0 Definindo as associações de arquivos HTML no registro do Windows

Caso não consiga lançar ajuda a partir do navegador ou de uma linha de comandos, é possível não haja uma associação apropriada de arquivos configurada para os arquivos HTML. O código cliente do Sistema de Ajuda utiliza entradas do registro para determinar o navegador default do sistema com base nessas associações de arquivos. Você pode verificar suas associações de arquivos utilizando o editor de registros:

  1. No menu Iniciar, selecione Executar
  2. Digite regedit no diálogo Executar
  3. No editor de registro, expanda HKEY_CLASSES_ROOT
  4. Você deve ver uma entrada para .htm. O valor padrão dessa entrada deve ser "NetscapeMarkup" (se Netscape for o navegador default) ou "htmlfile" (se Internet Explorer for o navegador default).

Se você não vir essa entrada, poderá incluí-la como a seguir:

  1. Inicie o navegador que deseja registrar como o navegador default do sistema.
  2. Se o navegador exibir um diálogo perguntando se você deseja torná-lo default, responda sim. Caso contrário, poderá configurá-lo para que pergunte isso na próxima vez em que for iniciado:

    No Netscape Communicator:

    1. Saia de todas as janelas do Netscape.
    2. Localize o arquivo de preferências do usuário, prefs.js. Geralmente, ele está em um diretório abaixo do diretório de instalação do produto Netscape. O caminho comum é Netscape_Installation_Directory\users\username\prefs.js em que username é "default" ou o nome com o qual você inicia sessão no Windows.
    3. Edite o arquivo com um editor de texto plano e remova a linha:
      user_pref("browser.wfe.ignore_def_check", true);
    4. Salve o arquivo (certifique-se de salvá-lo como texto corrido se tiver utilizado o WordPad).
    5. Inicie o Netscape novamente e registre o Netscape como o navegador default.

    No Internet Explorer:

    1. Localize o item de menu Opções ou Opções da Internet. Dependendo da versão do Explorer que estiver sendo utilizada, é possível acessar as opções do navegador a partir do menu Ferramentas, Arquivo ou Exibir.
    2. Selecione a guia Programas do diálogo.
    3. Selecione a caixa de opção Internet Explorer deve verificar se é o navegador padrão.
    4. Saia do Internet Explorer.
    5. Inicie o Internet Explorer novamente e registre-o como o navegador default.

17.0 Considerações especiais sobre o Windows Millennium Edition

Se você estiver utilizando o Windows Millennium Edition, as alterações feitas no autoexec.bat para carregar as variáveis de ambiente do NetQuestion poderão não ser efetivadas mesmo após uma reinicialização; as alterações podem desaparecer depois da reinicialização. Isso faz com que as variáveis de ambiente do NetQuestion permaneçam indefinidas, que, por sua vez, podem causar os seguintes tipos de falhas:

Você pode determinar se esta é a causa de problemas com a ajuda, verificando, após a reinicialização, se as variáveis de ambiente estão definidas corretamente. Se ainda não estiverem, utilize o programa msconfig.exe localizado no diretório de sistema do Windows, para fazer as seguintes alterações no ambiente:

18.0 Considerações especiais sobre o Component Broker

O Component Broker não utiliza a parte de cliente do Sistema de Ajuda do VisualAge, a parte que lança ajuda a partir da ação de F1 ou do menu Ajuda na interface com o usuário. Isso implica em duas questões importantes:

O Component Broker fornece informações adicionais sobre a resolução de problemas da ajuda no diretório doc\readme.

19.0 Considerações especiais sobre sistemas DBCS

Em sistemas nos quais a ajuda instalada é parcialmente ou totalmente gravada em chinês simplificado (locale zh_CN), taiwanês (zh_TW), coreano (ko_KR) ou japonês (ja_JP), será necessário fazer alterações nos comandos vahcfg e NetQuestion, como a seguir:

Essas alterações são necessárias porque o NetQuestion utiliza arquivos executáveis e servidores diferentes para seus sistemas de pesquisa de byte único e byte duplo.