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.
Para começar a resolver seu problema, siga estas três etapas:
Leia o resumo 1.2 Considerações especiais e todas as seções relacionadas que se aplicarem a seu produto ou ambiente
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.
Você deverá ler as seguintes seções se o produto, ambiente ou problema descrito corresponder à sua situação:
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?
Se a ajuda for exibida corretamente, outros dois pontos importantes são:
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.
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:
g: cd "\Arquivos de Programas\IBM\VisualAge for Java"
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
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:
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:
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:
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.
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.
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:
Vá para o diretório em que o NetQuestion está instalado (consulte 15.0 Localizando o Diretório de Instalação do NetQuestion)
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.
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:
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.
Hostname localhost Port 49213
Substitua todas as linhas Hostname ou Port existentes pelas linhas acima, se diferirem.
À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:
No Internet Explorer 5.0:
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.
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.
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.
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:
<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.
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:
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:
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.
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.
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.
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.
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.
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.
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:
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.
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.
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.
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.
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 serverSe 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.
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.
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.
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.
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.
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:
set imn
O sistema deve retornar definições para as variáveis IMNINST e IMNINSTSRV, tais como:
IMNINST=help IMNINSTSRV=C:\IMNNQ_NT
Init fn="init-cgi" IMNINSTSRV=c:/imnnq_nt Init fn="init-cgi" IMNINST=help
"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.
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.
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:
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:
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.
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:
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).
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.
Se não conseguir remover o NetQuestion utilizando uninstnq.exe, poderá removê-lo manualmente como a seguir:
Para alterar ou remover as variáveis de ambiente, siga as etapas específicas da plataforma abaixo:
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:
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.
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
É possível criar um atalho para lançar a ajuda do produto como a seguir:
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.
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.
É 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
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:
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.
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.
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:
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"
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.
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:
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:
Para configurar o Servidor de Pesquisa NetQuestion para iniciar na hora da inicialização no servidor de ajuda:
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.
É 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%
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:
Se você não vir essa entrada, poderá incluí-la como a seguir:
No Netscape Communicator:
user_pref("browser.wfe.ignore_def_check", true);
No Internet Explorer:
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:
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.
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:
vahcfg regen /p vj32 /f %IMNINSTSRV% /l ja_JP
A não inclusão do locale pode fazer com que os índices de pesquisa e o sistema de pesquisa do NetQuestion sejam danificados.
Comando SBCS | Comando DBCS |
imnixlst | imqixlst |
imnixdel | imqixdel |
imnss start server | imqss -start dbcshelp |
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.