Solucionando problemas da ajuda em produtos WebSphere e VisualAge

O Sistema de Ajuda do VisualAge permite a exibição de informações da ajuda online para vários produtos de software IBM. Ao pressionar F1 ou selecionar um item do menu Ajuda a partir da interface do usuário de um desses produtos, uma navegador deve abrir e a ajuda do produto deverá ser exibida. Se estiver tendo problemas para iniciar ou utilizar a ajuda online de seu produto, este documento pode ajudá-lo a solucioná-los.

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

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

1.0 Onde iniciar

Para iniciar a solução de 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, em seguida, leia as seções listadas que se aplicam a seu produto ou ambiente

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

1.1 Produtos que utilizam o Sistema de Ajuda do VisualAge

Os seguinte produtos IBM utilizam o Sistema de Ajuda do VisualAge desde de fevereiro de 2001:

Se estiver utilizando um produto de software IBM lançado após novembro de 2000 e ele não se encontra na lista acima, você pode 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 de seu produto nas linhas iniciadas por Produto:. Se seu produto se encontrar na lista, ele utiliza o Sistema de Ajuda do VisualAge. Se ele não aparecer na lista ou se você obter uma mensagem indicando que o comando não foi reconhecido, entre em contato com o suporte IBM para determinar se seu produto IBM utiliza o Sistema de Ajuda do VisualAge.

1.2 Considerações especiais

Leia as seções a seguir se o produto, ambiente ou problema descrito corresponder a sua situação:

1.3 Quais são os sintomas?

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

  1. Nada - vá para a seção 2.0 Nada acontece quando você tenta iniciar a ajuda
  2. Um navegador é iniciado ou é trazido para o primeiro plano, mas:
    1. Ele não consegue conectar ao localhost:49213 - vá para 3.0 Conexão com o servidor localhost:49213
    2. Ele não consegue conectar a um host remoto e você está utilizando a ajuda remotamente - verifique se o servidor Web do host remoto foi iniciado e está configurado corretamente
    3. Você obtém um erro Arquivo Não Encontrado - vá para 4.0 Erros de Arquivo Não Encontrado
    4. Você obtém outras mensagens indicando arquivos que estão faltando durante uma pesquisa ou imagens interrompidas em sua página de resultados da pesquisa - vá para 4.3 Outros erros de pesquisa envolvendo arquivos que estão faltando
    5. Você obtém uma mensagem Erro interno do servidor ou um diálogo de mensagem Erro do Aplicativo - vá para 5.0 Mensagens de erro interno do servidor
  3. Você obtém uma mensagem O produto xxxxx é desconhecido para o sistema de ajuda - vá para 6.0 Reconfiguração da ajuda
  4. Você obtém uma mensagem para utilizar um navegador que possa lidar com quadros - atualize seu navegador padrão para o Netscape 4.7 ou superior ou para o Internet Explorer 5 ou superior.
  5. A Ajuda é exibida corretamente.

Se a ajuda exibir corretamente, dois outros problemas potenciais são:

  1. Você deseja acessar a ajuda em uma máquina remota. Consulte 12.0 Configuração do sistema de ajuda em um servidor Windows.
  2. Pesquisar a ajuda não funciona. Tente digitar uma consulta de pesquisa no campo de entrada da pesquisa. O que acontece?
    1. Nada - o navegador gira e nenhuma resposta retorna ou demora muito tempo - vá para 7.0 Problemas de tempo limite ao pesquisar
    2. Você obtém um erro Arquivo Não Encontrado - vá para 4.0 Erros de Arquivo Não Encontrado
    3. Você obtém uma mensagem Erro interno do servidor - vá para 5.0 Mensagens de erro interno do servidor
    4. Você obtém uma mensagem contendo rc=73 ou O pedido da pesquisa estava vazio - vá para 8.0 Palavras de interrupção ou rc=73
    5. Você obtém uma mensagem contendo rc=32 ou alguma outra mensagem de erro de pesquisa - vá para 9.0 Outros erros de pesquisa

Se seu problema não for nenhum desses, entre em contato com o suporte da IBM.  Consulte http://www.ibm.com/software/ad/support Para obter mais informações.

2.0 Nada acontece quando você tenta iniciar a ajuda

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

Se nada ocorrer com o VisualAge for Java, Versão 3.5 você utilizar um ícone da área de trabalho para iniciar o VisualAge for Java IDE, consulte 2.1 Caso especial  - VisualAge for Java, Versão 3.5.

Se nada acontecer quando você tentar iniciar a ajuda, seu primeiro passo deve ser determinar se pode iniciar a ajuda a partir de uma linha de comandos. Para fazer isso, você precisará primeiro saber em qual diretório você instalou seu produto. No texto que segue, onde você vir INSTALL_DIR, você deverá substituir pelo diretório no qual seu produto foi instalado, por exemplo x:\ibmvjava ou "x:\Program Files\IBM\VisualAge para Java". Utilize aspas envolta do caminho completo (INSTALL_DIR mais qualquer subdiretório ou nome de arquivo) quando o caminho contiver espaços. Siga estas etapas para tentar iniciar a ajuda a partir da linha de comandos:

  1. Abra uma janela do prompt de comandos.
  2. Vá apara a unidade lógica na qual o produto está instalado, em seguida, vá para o diretório na unidade. Por exemplo, se seu produto for instalado em "g:\Program Files\IBM\VisualAge for Java", digite o seguinte: 
    g:
cd "\Program Files\IBM\VisualAge for Java"
  3. Vá para o diretório abaixo do diretório do produto, onde o executável vahelp.exe está localizado. Você pode determinara localização, digitando primeiro: 
    dir /s /b vahelp.exe

    Se isto retornar: 

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

    Digite, então:

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

Se a ajuda iniciar com êxito a partir da linha de comandos e você puder pesquisar a ajuda com êxito, pode haver um problema na configuração de seu caminho que impede que a interface de usuário de seu produto conecte com a DLL do sistema de ajuda. Consulte 2.1 Caso especial  - VisualAge for Java 3.5 ou, para outros produtos, tente desinstalar e reinstalar seu produto, já que às vezes soluciona esses problemas.

Se você estiver satisfeito em iniciar a ajuda a partir da linha de comandos como um desvio ou correção temporária, você poderá criar um ícone em sua área de trabalho para fazer isso. Consulte 11.0 Criação de um ícone para iniciar a ajuda do produto.

Se a ajuda não carregar a partir da linha de comandos ou se carrega a partir da linha de comandos, mas não a partir do produto, você pode não ter as associações de arquivos apropriadas configuradas para seu navegador no registro do Windows. Consulte 16.0 Definição de associações de arquivos HTML no registro do Windows.

Se altera associações de arquivos também não ajuda, você pode tentar o seguinte para obter um arquivo de log do sistema de ajuda:

  1. Edite o arquivo de configuração da ajuda do produto (INSTALL_DIR\HELP_DIR\CONFIG_FILE) em um editor de texto (por exemplo, Bloco de Notas) e inclua a seguinte linha no final do arquivo:
    HTMLHELP_LOG=1
  2. Salve o arquivo. Cuidado para salvar como texto simples se estiver utilizando um editor como o WordPad.
  3. saia e reinicie seu produto IBM.
  4. Pressione F1 ou utilize o menu Ajuda para tentar iniciar 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 nos pedidos feitos para o sistema de ajuda. Você pode enviar esses arquivos para o suporte da IBM para que eles sejam analisados. Uma taxa poderá ser cobrada para os pedidos ao suporte. Você também pode tentar examinar esses arquivos para ver ser você consegue determinar o que está causando a falha.

se você não vir nenhum arquivo HTML*.C2T no diretório TEMP, tente chamar a 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á em seu produto invocar a ajuda. Se nenhum dos métodos de invocar a ajuda produzir arquivos de log, o sistema de ajuda em si tem um problema. Em qualquer um desses casos você pode entrar em contato com o suporte da IBM.

Lembre-se de remover a linha HTMLHELP_LOG=1 de seu arquivo de configuração da ajuda do produto quando tiver terminado, já que o log irá produzir arquivos de log desnecessários toda vez que você solicitar ajuda.

Se você ainda não puder iniciar a ajuda por qualquer um dos métodos, verifique se o arquivo de configuração da ajuda do produto ainda é válido. Abra INSTALL_DIR\HELP_DIR\CONFIG_FILE em um editor e verifique se:

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

Para o VisualAge for Java, Versão 3.5, se não for possível iniciar a ajuda a partir do IDE, mas você puder a partir da linha de comandos, você poderá estar invocando o IDE através do atalho errado.  Isso ocorre se você criar ou editar manualmente um atalho para o IDE em sua área de trabalho ou no menu Iniciar e invocar o IDE a partir de um atalho. Pode ocorrer também se você estiver utilizando um atalho criado para a Versão 3.0 ou 3.02 e agora está utilizando-o para iniciar a Versão 3.5. Siga estas etapas para determinar se esse é o problema:

  1. Saia de todas as sessões IDE do VisualAge for Java e aguarde até dez segundos após a última janela do VisualAge for Java desaparecer, para certificar-se de que o programa concluiu seu procedimento de encerramento.
  2. Inicie o IDE do VisualAge for Java utilizando o menu Iniciar (Iniciar > Programas > IBM VisualAge for Java for Windows V3.5 > IBM VisualAge for Java).
  3. Pressione F1 no IDE.

Se a ajuda funcionar ao invocar o IDE a partir do menu Iniciar, mas não a partir do ícone ou atalho que geralmente utiliza, esse ícone ou atalho está provavelmente apontando para VAJ_INSTALL_DIR\ide\program\ide.exe, que inicializará o IDE com êxito, mas não suportará a ajuda, porque a variável de ambiente PATH ão aponta para a DLL do sistema de ajuda.  Você pode solucionar esse problema, 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 de forma que a ajuda funcionará corretamente a partir do IDE.

3.0 Conexão ao servidor localhost:49213

Se iniciar a ajuda fizer com que um navegador seja aberto ou venha para o primeiro plano, mas o navegador não puder conectar ao localhost:49213, há três possíveis problemas:

verifique cada uma das subseções a seguir para solucionar qualquer problema possível com a má configuração do servidor ou navegador da Web.

3.1 HTTPDL.EXE não está sendo executado

HTTPDL.EXE é um processo do servidor HTTP que suporta somente acesso local. Ele faz parte do componente NetQuestion. Ele é utilizado para apresentar páginas da ajuda para seu 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 pode não ter conseguido iniciá-lo. Primeiro, tente chamá-lo a partir da linha de comandos para ver se retorna uma mensagem de erro:

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

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

Se retornar o erro Ligação do 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 retornar qualquer outro erro, entre em contato com o suporte IBM. Se retornar sem nenhum erro, verifique a lista de tarefas para certificar-se de que esteja sendo executado em segundo plano. Versões do HTTPDL.EXE datadas 12/02/2000 ou anterior travam o prompt de comandos se não detectarem um erro; as versões mais recentes continuam a ser executadas sem travar o prompt de comandos. se sua versão travar o prompt de comandos, pressione Ctrl+Break e emita o seguinte comando para iniciar o processo como um processo desacoplado: 

nqdetach httpdl.exe -r httpd.cnf

Agora tente recarregar a página em seu navegador. se a página for exibida corretamente, o sistema de ajuda teve problemas para 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 Inicialização dos servidores NetQuestion automaticamente.

Se a página ainda não se aplicar, consulte 3.2 HTTPDL.EXE está mal configurado e 3.3 Navegador precisa de substituições de proxy.

3.2 HTTPDL.EXE está mal configurado

Na ocasião em que o arquivo de configuração httpd.cnf, utilizado pelo HTTPDL.EXE, pode conter informações de caminho incorretas. Siga estas etapas para verificar se ele está configurado corretamente:

  1. Utilize o diálogo Iniciar > Localizar (Iniciar > Pesquisa no Windows 2000) para localizar todos os arquivos denominados HTTPDL.EXE em suas unidades locais de disco rígido. Verifique se há somente uma cópia. Se houver mais de uma cópia, renomeie as cópias que não estão no diretório de instalação do NetQuestion. (Renomeá-las permite restaurá-las mais tarde se elas forem necessárias, por exemplo, por algum outro servidor Web.
  2. Edite o arquivo httpd.cnf que aparece no diretório de instalação do NetQuestion. Procure todas as linhas que contenham informações de caminho. O seguinte são geralmente a linhas implicadas: 
    Serverroot    C:\IMNNQ_NT
Exec    /cgi-bin/*  C:\IMNNQ_NT\*
Pass    /icons/*    C:\IMNNQ_NT\*
Pass    /*          C:\IMNNQ_NT\*

    Verifique se o caminho indicado corresponde ao diretório no qual o arquivo httpd.cnf está armazenado. Se não, altere-o em todas as ocorrências acima para refletir o caminho real.

  3. Ainda no httpd.cnf, verifique se as entradas a seguir estão presentes: 
    Hostname localhost
Port 49213

    Substitua qualquer linha de Hostname ou Port pela linha acima se forem diferentes.

  4. Se você fez qualquer alteração no httpd.cnf nas etapas 2 ou 3, termine o processo HTTPDL.EXE e tente iniciar a ajuda novamente.  Se isso não solucionar seu problema, consulte a próxima seção.

3.3 Navegador precisa de substituições de proxy

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

Para determinar se seu navegador está configurado para configuração manual de proxy e para incluir substituições de proxy se estiver, siga estas etapas. Estas instruções são para as versões indicadas do navegador; se estiver utilizando uma versão diferente do navegador, as etapas podem diferir:

Para Netscape 4.7:

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

Para o Internet Explorer 5.0:

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

Você deve atualizar também 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 esse valor, você poderá precisar sair e reiniciar seu navegador para que a alteração tenha efeito.

Se você tiver feito alterações na configuração do navegador ou no arquivo ...\etc\hosts, tente recarregar a home page da ajuda em seu navegador. Se mesmo assim você obtiver erros tentando conectar ao locahost:49213, entre em contato com o suporte da IBM.

Se seu servidor proxy automático não estiver acessível quando você tentar exibir a ajuda, seu navegador pode não ser capaz de resolver o localhost para o endereço local 127.0.0.1. Você pode solucionar temporariamente esse problema (enquanto o servidor proxy não está disponível), alterando para conexão direta com a Internet na etapa 4 (Netscape) ou etapa 3 (Internet Explorer) acima.

4.0 Erros Arquivo Não Encontrado

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

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

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

Recarregue a página do navegador. Se a ajuda agora funciona, você solucionou o problema. Se você continuar a obter um erro Arquivo Não Encontrado, entre em contato com o suporte da IBM. se obtiver a mensagem Não há ajuda registrada para o produto xxxxx, consulte 6.0 Reconfiguração da ajuda.

4.2 Erros Arquivo Não Encontrado ao tentar pesquisar

Se você obtiver um erro Arquivo Não Encontrado ao tentar pesquisar a ajuda, o programa de pesquisa especificado em seu formulário de pesquisa pode não ter sido instalado no local apropriado. Sigas estas etapas para determinar o nome e a localização:

  1. Em seu produto IBM, selecione Ajuda > Pesquisar para abrir o formulário de pesquisa em uma janela do navegador.
  2. No navegador, exiba a origem do formulário de pesquisa. Você pode fazer isso da seguinte forma:
  3. No código fonte do formulário, procure a cadeia "action=". Você deve ver algo como uma das linhas a seguir: 
    <form action="http://localhost:49213/cgi-bin/ivjsenus.exe"...>
<form action="http://localhost:49213/cgi-bin/va4sall.exe"...>

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

  4. Certifique-se de que esse arquivo esteja localizado no diretório de instalação do NetQuestion. Se estiver lá e você continuar a obter os erros Arquivo Não Encontrado ao pesquisar, consulte 3.2 HTTPDL.EXE está mal configurado acima. Se ele estiver faltando, você poderá copiá-lo do CD do produto. Procure esse programa de pesquisa no CD do produto. Se ele estiver presente, copie-o para o diretório NetQuestion. Caso contrário, entre em contado com o suporte da IBM para obter uma cópia.

4.3 Outros erros de pesquisa envolvendo arquivos que estão faltando

Você também pode obter imagens interrompidas em sua página de resultados de pesquisa ou uma mensagem Cabeçalho do formulário de pesquisa não encontrado ou Rodapé do m formulário de pesquisa não encontrado. Esses erros resultam de outros arquivos que estão faltando no diretório de instalação do NetQuestion. Você pode ser capaz de localizá-los no CD do produto ou você poderá obtê-los do suporte da IBM. Os nomes dos arquivos estão todos especificados no mesmo formulário de pesquisa. Você pode exibir o código fonte de seu 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 para o VisualAge for Java. Entradas equivalentes de outros produtos incluem, no lugar de ivj:

5.0 Mensagens de erro interno do servidor

Uma mensagem de Erro interno do servidor geralmente indica que um aplicativo sendo executado no servidor Web travou. Você também poderá ver um diálogo do Windows com o título program.exe - Erro do Aplicativo e uma mensagem começada por A instrução em "0xnnnnnnnn" fez referência à memória em "0xnnnnnnnn". Se você dispensar esse diálogo selecionando OK, o navegador irá exibir a mensagem Erro interno do servidor.

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

Se esse erro ocorrer durante navegação normal da ajuda, pode haver problemas com permissões de diretórios em um sistema de arquivos NTFS. Encerre sessão em seu sistema Windows NT ou Windows 2000, reinicie sessão como um administrador e verifique se 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) têm suas permissões de segurança definidas para Todos - Controle Completo. Para fazer isso:

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

Se tiver feito alterações em permissões, feche esses diálogos e tente recarregar a página. Se não tiver sido necessário fazer as alterações para as permissões ou se o erro persistir após as alterações, tente apagar o arquivo vahelp.cfg do diretório de instalação do NetQuestion, em seguida, reconfigure a ajuda de seu produto.

Se você continuar a ver as mensagens Erro interno do servidor, entre em contato com o suporte da IBM.

6.0 Reconfiguração da ajuda

Em algumas situações o sistema de ajuda pode ter mal configurado a ajuda de um produto específico ou você pode ter tido de remover algumas informações de configuração enquanto tentava corrigir uma instalação. Você pode reconfigurar a ajuda de seu produto, seguindo as instruções abaixo. Antes de iniciar, você precisa saber:

A primeira parte desse processo envolve determinar se a ajuda já está configurada e precisa apenas ser atualizada. Para determinar se a ajuda de seu 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 para cada produto que foi configurado para a ajuda. Se você vir um produto, cujo diretório corresponde ao diretório de seu produto, observe 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:\Program Files\IBM\WDT400\help
Nenhum arquivo de atualização para esse produto
Comp: qadtswin (WebSphere Development Tools for AS/400)
Arquivo Zip: C:\Program Files\IBM\WDT400\help\qadtswin.zip
Índice: va45uadt
...

O nome do produto é va400. Se você vir uma entrada para seu produto, você poderá reconfigurar a ajuda utilizando o comando vahcfg regen. Se você não vir uma entrada para seu produto, será necessário reconfigurar a ajuda utilizando o comando vahcfg install. Ambos descritos mais tarde nesta seção.

6.1 Espaço livre em disco

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

6.2 Utilização do 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 Utilização do 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, contendo os arquivos de ajuda do produto. Se o diretório contiver espaços (por exemplo, c:\Program Files\IBM\...), coloque todo o caminho do diretório entre aspas.

6.4 Após a execução de vahcfg install ou vahcfg regen

Após a instalação ou a regeneração (que pode levar vários minutos), tente recarregar a ajuda. Se o problema que estava tentando corrigir persistir, sigas as etapas em 6.5 Obtenção de um arquivo de log de vahcfg regen ou vahcfg install, entre em contato com o suporte da IBM e encaminhe o arquivo de log para o suporte da IBM.

6.5 Obtenção de 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 solucionou seus problemas da ajuda, tente o seguinte para produzir um arquivo de log que o suporte da IBM poderá utilizar para diagnosticar o problema melhor:

  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. Exemplo:
    SET VAHCFG_LOG=c:\config.log
  2. Se você tentou vahcfg install e teve problemas, execute os dois comandos a seguir:
    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.

Você poderá então fornecer o arquivo de log gerado ao suporte IBM.

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

7.0 Problemas de tempo limite ao pesquisar

O sistema de pesquisa do NetQuestion é extremamente rápido para encontrar correspondências para tudo, exceto para consultas de pesquisa muito genéricas. Se procurar correspondências para an cadeia a*, o sistema de pesquisa precisará encontrar todos os documentos que contêm pelo menos uma palavra iniciada com a letra a, portanto, isso sempre leva mais tempo. Mas se sua pesquisa for específica, você poderá esperar resultados de pesquisa dentro de poucos segundos no mais tardar. Se uma pesquisa parecer levar tempo excessivo (por exemplo, mais de 1 minuto), você poderá estar tendo um problema relacionado à utilização do Netscape Navigator 4.5 ou superior em um sistema Windows 2000 . (Esse problema também ocorre em alguns sistemas Windows NT.)

Há um problema conhecido com o Netscape (versões 4.5 to 4.74 e possivelmente outras) em algumas máquinas com o Windows 2000, que pode tornara a pesquisa do help online extremamente lenta. Ao enviar um formulário dessas versões do Netscape, o aplicativo Netscape utiliza a maioria dos ciclos do processador disponíveis de sua máquina até uma resposta ser recebida do sistema remoto. (Você pode verificar isso abrindo a página go Gerenciador de Tarefas do Windows durante uma dessas pesquisas, alternando para a guia Processos e clicando no cabeçalho da coluna CPU. Se estiver tendo o problema descrito aqui, o netscape.exe aparecerá no topo da lista e estará utilizando 97-99% do tempo da CPU.)

Essa utilização da CPU não é um problema normalmente quando estiver fazendo uma pesquisa remota (por exemplo, em um site da Web). No entanto, como o programa de pesquisa do produto está sendo executado em sua máquina local, o fato do Netscape utilizar tanto tempo da CPU significa que resta muito pouco tempo da CPU para que o programa de pesquisa execute sua pesquisa. Como resultado, uma ação de pesquisa que deve retornar um resultado dentro de um segundo pode levar vários minutos no Windows 2000.

Você pode evitar esse problema de desempenho no Windows 2000, selecionando uma janela diferente, não do Netscape após cada vez que você enviar uma pesquisa. Isso geralmente faz com que o Netscape pare de utilizar ciclos excessivos da CPU enquanto aguarda por uma resposta e os resultados de pesquisa são geralmente exibidos dentro de um segundo após essa alternação de janela. A mesma técnica também pode funcionar no Windows NT, apesar que de forma menos consistente.

Como alternativa, você pode utilizar o Microsoft Internet Explorer para exibir a ajuda, já que o problema de desempenho não ocorre com esse navegador.

8.0 Palavras de interrupção ou rc=73

Você poderá receber uma das mensagens de erro a seguir 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 para um pedido de pesquisa realmente vazio, somente quando consistir somente de palavras de interrupção. Se você puder reproduzir com confiabilidade a mensagem indicando um pedido de pesquisa vazio quando a cadeia de pesquisa não estava vazia (e não era uma pesquisa somente de palavras de interrupção), seu formulário de pesquisa pode estar danificado. Localize os formulários de pesquisa hgssrch.htm e hgcsrch.htm no diretório da ajuda do produto (geralmente INSTALL_DIR\doc ou INSTALL_DIR\help) e forneça-os ao seu representante de suporte ao entrar em contato com o suporte da IBM.

9.0 Outros erros de pesquisa

Você pode ver qualquer uma de várias outras mensagens de erro ao tentar pesquisar. Se seu erro for um dos seguintes, 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 da ajuda não pôde iniciar o serviço de pesquisa (ou, para o Component Broker, o serviço de pesquisa não está configurado para iniciar automaticamente na hora do início de sessão).  Isso pode ocorrer se você estiver pesquisando na máquina local (http://localhost:49213) ou em um servidor remoto da ajuda.

Ação recomendada (ajuda local):

Consulte 3.1 HTTPDL.EXE não está sendo executado e especificamente a seção sobre importação das entradas de registro de início automático, para que o serviço de pesquisa inicie automaticamente quando você iniciar sessão. Para um desvio rápido, você pode abrir um prompt de comandos e digitar: 

imnss start server

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

O serviço de pesquisa foi iniciado.

então, você deve poder executar a pesquisa novamente, sem esse erro rc=33.

Ação recomendada (ajuda apresentada remotamente):

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

9.2 Nenhum destino especificado para a pesquisa

Causa: O programa de pesquisa não recebeu nenhum nome de índice válido no pedido da pesquisa. O formulário de pesquisa pode estar danificado ou os outros í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 da ajuda do produto (INSTALL_DIR\doc ou INSTALL_DIR\help). Em seguida, tente reconfigurar a ajuda para seu produto. Se o problema persistir, você poderá precisar reinstalar NetQuestion e, em seguida, reconfigurar a ajuda para seu produto novamente.

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

Causa: O formulário de pesquisa especificou um cabeçalho ou rodapé de formulário de pesquisa inexistente (um arquivo contento um fragmento de HTML a ser colocado sobre ou abaixo dos resultados de pesquisa).

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

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

 Causa: Você digitou uma consulta de pesquisa que tem muitas correspondências de palavras. O mecanismo de pesquisa não pode lidar com uma consulta que contenha correspondências de mais de 1024 palavras diferentes. Por exemplo, se você digitar a cadeia "a* b* c* d*" (sem as aspas), você está pedindo qualquer documento que contenha palavras iniciadas por qualquer uma dessas 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 significativa e ordenada do número de ocorrências, portanto, nem tenta.

Ação recomendada: Digite um pedido de pesquisa que irá produzir um número de ocorrências de palavras 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" (mostra todos os documentos que não contém a palavra java) não é considerada válida.

Ação recomendada: Digite um pedido de pesquisa que tenha pelo menos um termo não proibido.

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

Causa: Esse erro pode ocorrer quando o programa de pesquisa não pode ler as variáveis de ambiente requeridas para operação de pesquisa bem-sucedida. Se tiver configurado a ajuda para executar em um servidor Web diferente do servidor Web HTTPDL. EXE do NetQuestion, pode ser necessário alterar as definições do servidor Web para garantir que certas variáveis de ambiente são visíveis para o CGI de pesquisa (o programa que é chamado a partir do parâmetro "action=" da guia <formulário> do formulário de pesquisa). Em alguns servidores Web, as variáveis de ambiente do sistema são ocultadas por padrão. As variáveis que o CGI de pesquisa precisa acessar são IMNINSTSRV e IMNINST. O Netscape Enterprise Server é um exemplo de um servidor Web que oculta as 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 CGIs. No Netscape Enterprise Server, você pode fazer isso seguindo as etapas a seguir:

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

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

    IMNINST=help
IMNINSTSRV=C:\IMNNQ_NT
  3. Com base nos resultados acima, inclua as seguintes linhas em obj.conf, logo abaixo das outras linhas iniciadas por uma diretriz "Init". Certifique-se de que você utilizará somente BARRAS INCLINADAS PARA A FRENTE (/) 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 aviso a seguir:

    "AVISO: Os arquivos de configuração foram editados manualmente. Utilize esse 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 para aplicativos CGI.

9.7 Outros erros NETQ.CFG ou rc=32

Causa: Um erro rc=32 ou um erro que mencione o arquivo NETQ.CFG ocorre quando o NetQuestion não pode acessar um índice de produto corretamente. Isso pode ocorrer porque a instalação do NetQuestion ou de um índice específico foi danificada ou pode ocorrer somente na primeira pesquisa que você executar em um índice específico após uma reinicialização. Observe que apesar da mensagem para alguns formulários desse erro mencionar o arquivo NETQ.CFG, esse arquivo na verdade n]ao existe; o erro refere-se a problemas com outros arquivos de configuração do índice do NetQuestion.

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

9.8 Redefinição do índice ou erros rc=76

Se uma pesquisa retornar uma mensagem de erro rc=76, um ou mais de seu índices de pesquisa podem precisar de ser redefinidos. Siga estas etapas para redefinir seus índices:

  1. Exiba o código fonte do formulário de pesquisa em seu 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 comando:
    nqreset ixname
  3. Tente a pesquisa novamente após redefinir todos os índices envolvidos. Se o erro de pesquisa persistir ou ocorrer novamente mais tarde entre em com o suporta da IBM.

10.0 Reinstalação do NetQuestion

Em algumas situações a única maneira de fazer com que sua ajuda funcione corretamente é desinstalar e reinstalar o NetQuestion, em seguida, reconfigure a ajuda para produtos que utilizam o Sistema de Ajuda do VisualAge. Observe que desinstalar o NetQuestion pode remover os índices de pesquisa utilizados por produtos, como o IBM DB2, que não utilizam o Sistema de Ajuda do VisualAge e podem, então, impedir a pesquisa da ajuda para os produtos após a reinstalação do NetQuestion. Pode ser necessário reinstalar o produto em questão para restaurar seu índices de pesquisa.

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

10.1 Execute vahcfg remove para todos os produtos listados

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

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

10.2 Remova todos os índices restantes

Após remover todos esses produtos, você pode verificar se os índices ainda estão registrados para outros produtos, digitando o seguinte comando:

imnixlst

Se a lista resultante contiver entradas começadas por DB2, CXX ou VAC, você provavelmente tem índices com produtos como o DB2, IBM C e C++ Compilers, ou VisualAge C++ 4.0, que não utilizam o Sistema de Ajuda do VisualAge. Se você prosseguir com uma desinstalação manual do NetQuestion, você perderá esses índices e poderá ter de reinstalar os produtos respectivos para pesquisar a ajuda por esses produtos novamente. Se esses índices ainda forem listados e você estiver preparado para perder as capacidade de pesquisa desses produtos ou reinstalar esses produtos, prossiga para excluir os índices restantes da seguinte forma:

Se os índices cujos nomes começam por IVJ3, VJ32, IWZ ou VA45 estiverem listados, é seguro excluí-los, pois eles podem ser restaurados mais tarde, utilizando vahcfg install.

Se você não puder excluir todos os demais índices, devido a um erro do NetQuestion, pode ser necessário remover manualmente o NetQuestion (consulte a seção 11.4 abaixo).

10.3 Execução de uninstnq

Emita o comando uninstnq e aguarde alguns minutos, até notar que o diretório NetQuestion está quase vazio. o diretório não deve conter nenhum arquivo começado por imn* ou imq*. Pode ser necessário aguardar até dez minutos para isso concluir. Se após dez minutos o diretório ainda tiver arquivos imn* ou imq*, pode haver índices ainda registrados no serviço de pesquisa (nesse caso, retorne para a seção 11.2), ou a instalação do NetQuestion pode estar danificada (prossiga para a seção 11.4). Caso contrário, reinicialize e prossiga para a seção 11.5.

10.4 Remoção manual do NetQuestion

Se você não conseguir remover o NetQuestion utilizando uninstnq.exe, você pode removê-lo manualmente da seguinte forma:

  1. Execute o programa regedit a partir de um prompt de comandos ou de Iniciar > Executar.
  2. Expanda a entra de registro HKEY_LOCAL_MACHINE\Software\IBM.
  3. exclua a entrada NetQuestion e todas as sua sub-entradas.
  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 do NetQuestion que correspondam as estas especificações de curingas, digitando o seguinte comando enquanto o diretório é o diretório atual no prompt de comandos:
    del http*.* 302.* 404.* 500.* im*.* nq*.*
  7. Exclua o subdiretório "instance" do Explorer ou digitando o seguinte comando:
    rmdir /s /q instance
  8. Reinicialize.

Para alterar ou remover as variáveis de ambiente, siga as etapas abaixo específicas ic das plataformas:

10.5 Reinstalação do NetQuestion

Para reinstalar o NetQuestion, será necessário o CD do produto ou um arquivo zip de instalação do NetQuestion do suporte da IBM. Os produtos a seguir têm uma cópia instalável do NetQuestion no CD do produto:

Para outros produtos, você pode determinar 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 pode iniciar a instalação do NetQuestion.

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

Quando tiver obtido uma cópia instalável do NetQuestion, siga estas etapas:

  1. Inicie o setup.exe, clicando duas vezes 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 em que o NetQuestion foi instalado anteriormente. Se você substituir o diretório padrão e apontar para um novo diretório, certifique-se de que o nome do novo diretório tenha no máximo 8 caracteres, não tenha espaços e esteja no nível da raiz de uma unidade. Isso reduzirá a probabilidade de problemas futuros com a ajuda. 
  4. Reinicialize após a conclusão da instalação.
  5. Se os diretórios antigo e novo do NetQuestion forem diferentes, copie o cabeçalho do formulário de pesquisa, o rodapé, os arquivos .gif, o programa de pesquisa e os arquivos do sistema de ajuda (vah*.exe, vahwebx.cat) do diretório antigo para o novo diretório. Consulte 4.0 Erros Arquivo Não Encontrado para obter informações sobre esses arquivos.

10.6 Reconfiguração da ajuda para produtos instalados

Para cada produto removido manualmente do sistema de ajuda (utilizando vahcfg remove, conforme descrito na seção 11.1), execute vahcfg install conforme descrito em 6.0 Reconfiguração da ajuda. Agora deve ser possível navegar e pesquisar a ajuda de seu produto. Se os erros persistirem, verifique outras seções desse documento para possíveis soluções ou entre em contato com o suporte da IBM.

11.0 Criação de um ícone para iniciar a ajuda do produto

Se você não puder iniciar a ajuda a partir da interface de usuário de seu produto, você poderá criar um ícone para iniciá-la, clicando-se duas vezes em um ícone (para que você possa pelo menos utilizar a ajuda enquanto trabalha na solução de seu problema).

Observações

  1. Para o Component Broker, o menu Iniciar já contém uma entrada para a Biblioteca online do Component Broker para iniciar a ajuda do produto e as informações dessa seção não se aplicam.
  2. Para o Websphere Development Tools for AS/400, o menu Iniciar já contém um conjunto de entradas para iniciar a ajuda do produto (Iniciar - Arquivos de Programas - IBM Websphere Development Tools for AS/400 - Documentação), mas você pode também pode criar seu próprio ícone na área de trabalho, utilizando o método descrito abaixo.
  3. Para o VisualAge TPF for Windows NT, nas estações de trabalho que têm a ajuda instalada localmente, o menu Iniciar já contém uma entrada para iniciar a ajuda do produto. Siga estas etapas somente se você optar por acessar a ajuda remotamente ou se quiser incluir o ícone em sua área de trabalho, além de tê-lo no menu Iniciar.

Você pode criar um atalho para iniciar a ajuda do produto da seguinte forma:

  1. Na barra de tarefas, clique com o botão direito do mouse e selecione Minimizar Todas as Janelas.
  2. Em um lugar vazio da área de trabalho, clique com o botão direito do mouse e selecione Novo - Atalho.
  3. Na caixa de 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 pelo arquivo vahelp.exe. No VisualAge for Java, ele está no diretório eab\bin.
  5. Dê um clique duplo no arquivo vahelp.exe. No diálogo Criar Atalho, a área de entrada Linha de Comandos deverá mostrar agora o caminho completo (entre aspas se houver espaços no caminho) para vahelp.exe.
  6. Edite a área de entrada Linha de Comandos e inclua o seguinte (incluindo um espaço em branco na frente) após o 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 da ajuda do produto (ivjhlp.cfg para VisualAge for Java; consulte 2.0 Nada acontece quando você tenta iniciar a ajuda para obter informações sobre como determinar os diretórios e os nomes dos arquivos de configuração para outros produtos). Certifique-se de que o caminho completo para o arquivo de configuração esteja entre aspas se ele tiver espaços.

  7. Clique em Avançar.
  8. Digite o nome de um atalho, por exemplo "Ajuda Online do IBM VisualAge for Java".
  9. Clique em Concluir.
  10. Dê um clique duplo no atalho criado ná área de trabalho para certificar-se de que ele funciona.
  11. Para alterar a aparência do ícone do atalho, clique com o botão direito no atalho e escolha Propriedades, em seguida, escolha a guia Atalho, selecione Alterar Ícone e procure na lista de ícones disponíveis ou em seu sistema de arquivos um novo ícone.

Você pode incluir o ícone criado no menu Iniciar, clicando com o botão direito no ícone, escolhendo Copiar no menu sobreposto, em seguida, no Windows Explorer navegue pelo diretório de instalação do Windows em ...\Profiles\All Users\Start Menu e cole-o nesse diretório ou em um subdiretório apropriado do mesmo.

12.0 Configurando o sistema de ajuda em um servidor Windows

Você pode instalar e configurar o sistema de ajuda em um servidor Web Windows NT ou Windows 2000 para que outros membros de sua organização possam exibir e pesquisar a ajuda online por meio de 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 os produtos

  1. Para o VisualAge COBOL e o VisualAge TPF, os usuários podem optar por não instalar o NetQuestion ou o sistema de ajuda localmente. Para outros produtos, os usuários podem remover as cópias locais seguindo somente as etapas de remoção nas seções 6.0 Reconfigurando a Ajuda e 10.0 Reinstalando o NetQuestion.
  2. Para o VisualAge TPF, o produto é fornecido com utilitários incorporados para configurar a ajuda para a entrega do servidor. Se estiver instalando a partir do setup.exe no CD do produto, será perguntado se a ajuda será acessada remotamente por outros usuários na rede. Responda Sim. Se você fez o download do pacote da ajuda a partir da Web, execute insthelp.exe.

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

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

    Os três primeiros arquivos são necessários; os arquivos seguintes devem ser copiados se existirem, mas se não estiverem presentes no diretório NetQuestion, não serão necessários 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 para cada índice. Altere todas as ocorrências da subcadeia http://localhost:49213/cgi-bin para o formato http://server.city.domain.organization/scripts (como por exemplo http://cobweb.stl.ibm.com/scripts). Esta alteração faz os links gerados para número de ocorrências da pesquisa produzirem um endereço da Web remoto (não localhost) para que um usuário possa segui-los a partir de qualquer computador.
  4. Edite os seguintes arquivos, que foram criados no diretório de ajuda para o seu produto: hgssrch.htm and hgcsrch.htm. Altere http://localhost:49213/cgi-bin para o formato http://server.city.domain.organization/scripts.
  5. Copie o CGI de pesquisa especificado (ex. iwzihenes.exe, ivjsenus.exe, va4sall.exe) nos formulários de pesquisa do diretório NetQuestion para o diretório x:\inetpub\scripts.
  6. Copie *star*.gif para um subdiretório de novos ícones, em x:\inetpub\wwwroot.
  7. Para o Component Broker, altere a definição da variável de ambiente VABHELP de http://localhost:49213/cgi-bin para o formato http://server.city.domain.organization/scripts. Para produtos diferentes do Component Broker, 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 poder acessar a ajuda baseada em servidor apenas pressionando F1 ou selecionando um item de menu Ajuda, no 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 depois você executar vahcfg install ou vahcfg regen no sistema do servidor, é necessário editar novamente o arquivo de mapeamento na etapa 3 acima.

Depois que os usuários modificarem seus arquivos de configuração de ajuda do produto para apontarem para o servidor, eles podem executar se forma segura o seguinte comando para excluir todos os arquivos *.toc, *.htm e *.zip, bem como os arquivos de índice de pesquisa, a partir de seu diretório de ajuda do produto: 

vahcfg remove /p prodname /f %IMNINSTSRV%

ou podem simplesmente excluir os arquivos *.toc, *.htm e *.zip manualmente. Porém esse método não excluirá os diretórios de índices abaixo do diretório de ajuda do produto, portanto, também será necessário excluí-los manualmente.

13.0 Iniciando os servidores NetQuestion automaticamente

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

Você pode definir os servidores HTTP e de pesquisa para iniciarem automaticamente no momento do início de sessão, definindo duas entradas de registro no sistema. Para definir estas entradas, siga estas etapas:

  1. Crie um arquivo chamado NetQuestionAutoStart.reg utilizando um editor de texto com o BLOCO DE NOTAS. 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 cadeia %IMNINSTSRV% em sua versão para o valor do diretório de instalação NetQuestion.
  3. Salve o arquivo.
  4. Dê um clique duplo em NetQuestionAutoStart.reg no Windows Explorer.

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

14.0 Iniciando o serviço de pesquisa do NetQuestion no momento da inicialização

Se estiver utilizando uma configuração de ajuda em rede em que a ajuda é fornecida a partir de um servidor e não de sua própria máquina, poderão ocorrer problemas ao executar pesquisas na máquina remota. Quando o daemon de pesquisa do NetQuestion for configurado para iniciar automaticamente (durante a instalação do produto ou após você ter seguido as etapas em 13.0 Iniciando os servidores NetQuestion automaticamente), o daemon realmente não será iniciado até que um usuário inicie sessão na máquina servidor. Isto significa que, após uma reinicialização do sistema, antes que o usuário da máquina inicie sessão pela primeira vez, o daemon de pesquisa não estará em execução.  No entanto, você pode utilizar o Agendador de Tarefas do Windows para iniciar o daemon de pesquisa no momento da inicialização. As instruções nessa seção se aplicam à máquina que está fornecendo a ajuda.

Nota: Se não estiver utilizando uma configuração de ajuda da rede, não será necessário seguir as etapas nessa seção.

Antes de iniciar, determine o diretório de instalação do NetQuestion. Talvez você também queira fazer uma limpeza manual do registro. Seu registro pode conter entradas para iniciar o daemon de pesquisa do NetQuestion no momento do início de sessão. Se o daemon for iniciado no momento da inicialização, a entrada do registro será 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 - Executar
  4. No painel direito da pasta Executar, selecione e exclua a seguinte chave:
  5. Você também pode remover a entrada autostart do servidor HTTP do NetQuestion se não for acessar a ajuda diretamente na máquina servidor. Para isso, selecione e exclua a seguinte chave:
  6. Feche o editor de registro.

Agora você pode programar o Windows para iniciar os servidores no momento da inicialização. Primeiro, verifique se o Agendador 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, juntamente com as unidades locais e de rede, aparecer uma pasta chamada Tarefas Agendadas, isto indica que o Agendador de Tarefas está instalado em sua máquina. Vá para a etapa 5.
  3. Se você não tiver o Agendador de Tarefas instalado em sua máquina, será necessário instalá-lo. O Agendador de Tarefas é fornecido com o Internet Explorer. Ele é encontrado na categoria "Additional Explorer Enhancements" e é um componente adicional que precisa ser instalado. O método para incluir componentes no Internet Explorer depende de sua versão do Internet Explorer e de qual versão do Windows está sendo utilizada. Consulte o documento "How to Add and Remove Internet Explorer Components", em http://support.microsoft.com/support/kb/articles/Q171/2/29.ASP, para obter mais detalhes.
  4. Depois de instalar o Agendador de Tarefas, reinicialize o sistema se for solicitado e abra a pasta Meu computador.

Para configurar o Servidor de Pesquisa do NetQuestion para ser iniciado no momento da inicialização no servidor de ajuda:

  1. Na pasta Tarefas Agendadas, clique em Adicionar Tarefa Agendada
  2. É aberto o assistente para Adicionar Tarefa Agendada. Clique em Avançar para continuar.
  3. Selecione um programa arbitrário da lista (você o alterará posteriormente) e clique em Avançar.
  4. Nomeia a tarefa. Por exemplo, digite "Servidor de Pesquisa do NetQuestion".
  5. Selecione o botão de opção Quando meu computador iniciar e clique em Avançar.
  6. Digite o nome de usuário do usuário que será proprietário do processo (por exemplo, o administrador do servidor) e digite sua senha conforme solicitado. Clique em Avançar.
  7. Selecione a caixa de opções Abrir propriedades avançadas para esta tarefa quando eu clicar em 'Concluir'.
  8. Clique em Concluir.
  9. É aberta a página Propriedades do Servidor de Pesquisa do NetQuestion. Na guia Tarefa, altere o campo run 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. Certifique-se de que a caixa de opções Ativado esteja selecionada.
  12. Na guia Configurações, desmarque Parar a tarefa se ela for executada por xxx horas e xxx minutos.

Nota: Após a reinicialização da máquina servidor de ajuda, pode demorar um minuto ou mais depois de aparecer a tela de início de sessão antes que o Windows inicie o servidor de pesquisa.

15.0 Localizando o diretório de instalação do NetQuestion

Você pode determinar a localização do diretório de instalação do NetQuestion abrindo um prompt de comando 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ê pode determinar o diretório de instalação examinando o registro do Windows. Digite regedit em um prompt de comandos e expanda as entradas do registro para a chave HKEY_LOCAL_MACHINE\SOFTWARE\IBM\NetQuestion\CurrentVersion\Installation Directory. A entrada "Directory" dessa chave deve apontar para o diretório de instalação do NetQuestion.

No Windows 95 e Windows 98, se a variável de ambiente IMNINSTSRV não estiver definida mas você localizar o diretório a partir do registro, poderá ser necessário editar o arquivo autoexec.bat. (Se você encontrar essa condição no Windows Millennium Edition, consulte 17.0 Considerações especiais para 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 tem o seguinte aspecto: 

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

Se esta linha estiver faltando ou _NETQ_DIR_ apontar para o diretório, inclua a linha com o diretório NetQuestion correto. Você também deve verificar se o arquivo batch imnenv.bat que está sendo chamado no autoexec.bat realmente existe e contém entradas que apontam para o diretório atual e não para algum outro diretório 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 associações de arquivos HTML no registro do Windows

Se não puder lançar a ajuda a partir do navegador ou de uma linha de comandos, talvez você não tenha uma associação de arquivo apropriada configurada para arquivos HTML. O código do cliente do Sistema de Ajuda utiliza entradas do registro para determinar o navegador padrão do sistema, com base nestas associações de arquivos. Você pode verificar as associações de arquivos utilizando o editor de registro:

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

Se não aparecer uma entrada como essa, você poderá incluir a entrada, da seguinte forma:

  1. Inicie o navegador que deseja registrar como o navegador padrão do sistema.
  2. Se o navegador exibir um diálogo perguntando se você deseja que ele se torne o navegador padrão, responda sim. Caso contrário, você pode configurar seu navegador para fazer essa pergunta na próxima vez em que ele for iniciado:

    Para o Netscape Communicator:

    1. Feche as janelas do Netscape.
    2. Localize o arquivo de preferências, prefs.js. Geralmente, ele é 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 simples e remova a linha: 
      user_pref("browser.wfe.ignore_def_check", true);
    4. Salve o arquivo (certifique-se de salvar como texto simples se você utilizou o WordPad).
    5. Inicie novamente o Netscape e registre-o como o navegador padrão.

    Para o Internet Explorer:

    1. Localize o item de menu Opções ou Opções da Internet. Dependendo da versão do Explorer que está sendo utilizada, você pode acessar as opções do navegador no menu Ferramentas, Arquivo ou Exibir.
    2. Selecione a guia Programas do diálogo.
    3. Selecione a caixa de opções O Internet Explorer deve verificar se ele é o navegador padrão.
    4. Feche o Internet Explorer.
    5. Inicie novamente o Internet Explorer e registre-o como o navegador padrão.

17.0 Considerações especiais para o Windows Millennium Edition

Se estiver utilizando o Windows Millennium Edition, as alterações feitas no autoexec.bat para carregar as variáveis de ambiente do NetQuestion podem não ser efetivas mesmo após uma reinicialização; as alterações podem desaparecer após uma reinicialização. Isto pode fazer as variáveis de ambiente do NetQuestion permanecerem indefinidas que, por sua vez, podem gerar os seguintes tipos de falhas:

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

18.0 Considerações especiais para o Component Broker

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

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

19.0 Considerações especiais para sistemas DBCS

Em sistemas em que a ajuda instalada foi parcial ou totalmente escrita em chinês simplificado (locale zh_CN), taiwanês (zh_TW), coreano (ko_KR) ou japonês (ja_JP), é necessário fazer alterações nos comando vahcfg e NetQuestion, da seguinte forma:

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