VisualAge Help System consente di visualizzare la guida in linea per una serie di prodotti software IBM. Quando si preme F1 o si seleziona una voce dal menu ? dall'interfaccia utente di uno di questi prodotti, è necessario aprire un browser e visualizzare l'aiuto relativo al prodotto. Se si incontrano problemi all'avvio o se si utilizza l'aiuto in linea per un prodotto, questo documento può essere di supporto.
VisualAge Help System consiste di tre componenti principali:
In molti casi, tutti e tre i componenti vengono eseguiti sul sistema su cui è installato il prodotto.
Per cominciare a risolvere il problema, seguire queste tre istruzioni:
Leggere il sommario 1.2 Considerazioni particolari, quindi leggere tutte le sezioni in esso elencate che si applicano al proprio prodotto o ambiente.
I seguenti prodotti IBM utilizzano il VisualAge Help System del Febbraio 2001:
Se si sta utilizzando un prodotto software IBM rilasciato dopo Novembre 2000, non incluso nell'elenco precedente, è possibile stabilire se quel prodotto utilizza il VisualAge Help System inserendo quanto segue in una prompt dei comandi:
vahcfg list /f %IMNINSTSRV% | more
e ricercando il nome del prodotto sulle righe che cominciano per Product:. se il prodotto viene inserito nell'elenco, esso utilizza il VisualAge Help System. Se non appare nell'elenco o se si riceve un messaggio indicante che il comando non è riconosciuto, è possibile contattare il supporto IBM per stabilire se il prodotto IBM utilizza il VisualAge Help System.
E' necessario leggere le seguenti sezioni se il prodotto, l'ambiente o il problema descritto corrispondono alla propria situazione:
Dal menu ? del prodotto, selezionare la Home page Aiuto (o la voce di menu corrispondente al prodotto). Se non è disponibile nessun menu Aiuto, premere F1 da uno dei pannelli dell'interfaccia utente del prodotto. Cosa accade?
Se l'aiuto viene visualizzato correttamente, gli altri due problemi potenziali sono:
Se il problema non è tra quelli descritti in precedenza, contattare il supporto IBM. Per ulteriori informazioni, consultare http://www.ibm.com/software/ad/support.
Nota: questa sezione non si applica a Component Broker oppure a WebSphere Business Component. Per Component Broker consultare le informazioni sull'aiuto per la risoluzione dei problemi nella directory doc\readme.
Se non accade nulla con VisualAge per Java, Versione 3.5 e si utilizza un'icona del desktop per avviare VisualAge per Java IDE, consultare 2.1 Caso particolare - VisualAge per Java, Versione 3.5.
Se non accade nulla quando si tenta di avviare l'aiuto, la prima istruzione da seguire è quella di determinare se è possibile avviare l'aiuto dalla riga comandi. Per questa operazione, sarà necessario conoscere prima la directory in cui è stato installato il prodotto. Nel testo che segue, ovunque si veda INSTALL_DIR, è necessario sostituire la directory effettiva in cui è stato installato il prodotto, ad esempio x:\ibmvjava or "x:\Program Files\IBM\VisualAge per Java". Utilizzare gli apici appropriati per l'intero percorso (INSTALL_DIR più tutte le directory secondarie o il nome file) quando il percorso contiene spazi. Seguire queste istruzioni per tentare di avviare l'aiuto dalla riga comandi:
g: cd "\Program Files\IBM\VisualAge for Java"
dir /s /b vahelp.exe
Se restituisce:
g:\Program Files\IBM\VisualAge for Java\eab\bin\vahelp.exe
Si immetterà:
cd eab\bin
Se l'aiuto viene avviato con esito positivo dalla riga comandi e la ricerca riesce, potrebbero esserci problemi nella configurazione del percorso che impedisce all'interfaccia utente del prodotto di collegarsi alla DLL del sistema di aiuto. Consultare2.1 Caso speciale - VisualAge per Java 3.5 o, per altri prodotti, tentare di disinstallare e di reinstallare il prodotto, poiché ciò talvolta risolve dei problemi.
Se l'avvio dell'aiuto dalla riga comandi come workaround o PTF è sufficiente, è possibile creare un'icona sul desktop. Consultare 11.0 Creazione di una icona per avviare l'aiuto di un prodotto.
Se l'aiuto non viene caricato dalla riga comandi o se viene caricato dalla riga comandi ma non dal prodotto stesso, è possibile che non si disponga delle associazioni file appropriate configurate per il browser nel registro Windows. Consultare 16.0 Impostazione delle associazioni di file HTML nel registro Windows.
Se anche la modifica delle associazioni dei file non funziona, è possibile tentare di richiamare un file di log dal sistema di aiuto nel modo seguente:
Nella directory indicata dalla variabile d'ambiente TMP, visualizzare uno o più file di tipo HTML*.C2T. Questi file contengono informazioni di registrazione dettagliate relative alle richieste effettuate al sistema di aiuto. E' possibile inviare questi file al supporto IBM in modo che vengano analizzati. E' possibile che sia necessario pagare una tassa per le richieste di assistenza. E' possibile anche esaminare da sé questi file per cercare la causa dell'errore.
Se nella propria directory TEMP non sono presenti file HTML*.C2T, richiamare nuovamente l'aiuto dalla riga comandi. Se i file HTML*.C2T vengono creati solo dalla riga comandi, il problema è relativo al prodotto che richiama l'aiuto. Se nessun metodo di richiamo dell'aiuto produce file di log, il sistema di aiuto presenta dei problemi. In entrambi i casi è possibile contattare il supporto IBM.
Al termine, ricordare di rimuovere la riga HTMLHELP_LOG=1 dal file di configurazione aiuto del prodotto, poiché la registrazione produrrà file di log non necessari ad ogni richiesta di aiuto.
Se ancora non si è in grado di avviare l'aiuto, verificare che il file di configurazione di aiuto del prodotto sia ancora valido. Aprire INSTALL_DIR\HELP_DIR\CONFIG_FILE in un editor e verificare che:
Per VisualAge per Java, Versione 3.5, se è impossibile avviare l'aiuto dall'IDE, ma è possibile farlo dalla riga comandi, è possibile l'IDE sia stato richiamato utilizzando una shortcut errata. Ciò accade se si crea o si modifica manualmente una shortcut per l'IDE sul desktop o nel menu Avvio/Start e si richiama l'IDE da tale shortcut. Ciò potrebbe accadere anche se si utilizza una shortcut creata per la Versione 3.0 o 3.02 e se la si utilizza per avviare la Versione 3.5. Seguire queste istruzioni per verificare se il problema è proprio questo:
Se l'aiuto funziona quando si richiama l'IDE dal menu Avvio/Start, ma non dall'icona o dalla shortcut generalmente utilizzata, tale icona o shortcut indica probabilmente VAJ_INSTALL_DIR\ide\program\ide.exe, che avvierà l'ID e con esito positivo, ma non supporterà l'aiuto perché la variabile d'ambiente PATH non indica la DLL del sistema di aiuto. E' possibile risolvere questo campo Destinazione della shortcut per indicare VAJ_INSTALL_DIR\ide\program\ivjenv.bat. Questo file batch modifica le variabili d'ambiente Windows in modo che l'aiuto funzioni adeguatamente dall'IDE.
Se l'avvio dell'aiuto causa l'apertura di un browser o viene visualizzato in primo piano, ma il browser non è in grado di collegarsi all'host locale:49213, vi sono tre possibili problemi:
Controllare ognuna delle sezioni secondarie seguenti per risolvere qualunque problema con il server web o con una errata configurazione del browser.
HTTPDL.EXE è un processo del server HTTP che supporta solo l'accesso locale. Appartiene al componente NetQuestion. Viene utilizzato per fornire pagine di aiuto sul browser locale. Verificare se il processo HTTPDL.EXE appare nell'elenco delle attività.
Se l'attività non è presente, il sistema di aiuto potrebbe non essere in grado di avviarla. Prima tentare di richiamarla dalla riga comandi per ricevere eventualmente un messaggio di errore:
Passare alla directory in cui è installato NetQuestion (consultare 15.0 Ricerca directory di installazione NetQuestion)
Se questo restituisce l'errore Collegamento al socket non riuscito, è probabile che un processo HTTPDL.EXE sia già in esecuzione sulla porta 49213 (porta TCP/IP utilizzata dal processo HTTPDL.EXE). Se viene restituito un qualunque altro errore, contattare il supporto IBM. Se viene restituito senza errori, consultare l'elenco delle attività eseguite in background. Le versioni di HTTPDL.EXE con data 02/12/2000 o le versioni precedenti bloccano la richiesta comandi se non rilevano errori; le versioni successive continuano l'esecuzione senza bloccare la richiesta comandi. Se la versione blocca la richiesta comandi, premere Ctrl+Break ed immettere il seguente comando per avviare il processo come processo distaccato:
nqdetach httpdl.exe -r httpd.cnf
tentare di ricaricare la pagina nel browser. Se la pagina viene visualizzata correttamente, il sistema di aiuto rileva problemi nell'avvio del server HTTP (oppure, per Component Broker, il server non viene configurato per l'avvio al momento del logon). Consultare 13.0 Avvio automatico dei server NetQuestion.
Se la pagina non viene ancora visualizzata, consultare 3.2 HTTPDL.EXE non è configurato adeguatamente e 3.3 Il browser richiede la sostituzione del proxy.
Talvolta il file di configurazione httpd.cnf, utilizzato da HTTPDL.EXE, potrebbe contenere informazioni sul percorso scorrette. Seguire queste istruzioni per verificare che sia configurato adeguatamente:
Server root C:\IMNNQ_NT Exec /cgi-bin/* C:\IMNNQ_NT\* Pass /icons/* C:\IMNNQ_NT\* Pass /* C:\IMNNQ_NT\*
Verificare che il percorso indicato corrisponda alla directory in cui è archiviato il file httpd.cnf. In caso contrario, inserire il percorso effettivo in tutte le ricorrenze.
Nome host Host locale Porta 49213
Sostituire tutte le righe Nome host o Porta con quelle riportate sopra se sono diverse.
Talvolta il browser non è in grado di collegarsi al server web locale HTTPDL.EXE poiché tenta di individuare il sistema denominato host locale attraverso un server proxy. Questo accade generalmente quando il browser è impostato per configurare il proxy manualmente o automaticamente. Se si utilizza la configurazione manuale del proxy, è possibile modificare le impostazioni del browser per impedire che il browser tenti di risolvere i problemi dell'host locale da un server proxy. Se si utilizza una configurazione automatica del proxy, sarà necessario chiedere al proprietario del file di configurazione automatica del proxy di aggiungere 127.0.0.1 come eccezione proxy sul server proxy.
Per stabilire se il browser è configurato per la configurazione manuale del proxy e per aggiungere sostituzioni del proxy, seguire queste istruzioni. Queste istruzioni sono relative solo alle versioni del browser indicate; se si sta utilizzando una versione del browser differente, le istruzioni potrebbero essere diverse:
Per Netscape 4.7:
Per Internet Explorer 5.0:
E' necessario inoltre aggiornare il file %SystemRoot%\system32\drivers\etc\hosts aggiungendo la riga:
127.0.0.1 host locale
se il file esiste ma la riga non ancora. Se si modifica questo valore, potrebbe essere necessario uscire e riavviare il browser per rendere attive le modifiche.
Se si apportano modifiche alla configurazione del browser o al file ...\etc\hosts, tentare di ricaricare la home page di aiuto nel browser. Se si ricevono ancora errori nel tentativo di collegamento a un host locale:49213, contattare il supporto IBM.
Se il server proxy automatico non è accessibile quando si tenta di visualizzare l'aiuto, il browser potrebbe non essere in grado di risolvere l'host locale sull'indirizzo locale 127.0.0.1. E' possibile risolvere temporaneamente il problema (quando il server proxy non è disponibile) passando al collegamento diretto a Internet nell'istruzione 4 (Netscape) o 3 (Internet Explorer).
Se si riceve un errore File non trovato quando si tenta di visualizzare l'aiuto o si tenta la ricerca, potrebbe mancare un file dalla directory di installazione NetQuestion. Leggere le sezioni seguenti per altre notizie.
Se si riceve un errore File non trovato quando si tenta di visualizzare l'aiuto, il file vahwebx.exe probabilmente non si trova nella directory di installazione NetQuestion. Controllare la directory in una prompt del comando o Windows Explorer per verificare la presenza del file. Se il file è presente, probabilmente esiste un problema con la configurazione del server web locale NetQuestion; httpd.cnf potrebbe indicare la directory errata. Consultare 3.2 HTTPDL.EXE configurato erroneamente. Se il file vahwebx.exe manca, è possibile tentare una o più delle operazioni seguenti:
Ricaricare la pagina del browser. Se ora l'aiuto funziona, il problema è stato risolto. Se si continua a ricevere l'errore File non trovato, contattare il supporto IBM. Se si riceve il messaggio di errore Non esiste un aiuto registrato per il prodotto xxxxx, consultare 6.0 Riconfigurazione aiuto.
Se si riceve un errore File non trovato quando si tenta di ricercare l'aiuto, il programma di ricerca specificato nel modulo di ricerca non può essere installato nell'ubicazione propria. Seguire queste istruzioni per stabilire il nome e l'ubicazione:
<form action="http://localhost:49213/cgi-bin/ivjsenus.exe"...> <form action="http://localhost:49213/cgi-bin/va4sall.exe"...>
Il nome del programma di ricerca è la parte dell'attributo action= dopo"cgi-bin", cioè ivjsenus.exe o va4sall.exe negli esempi precedenti.
E' inoltre possibile ricevere immagini interrotte nella pagina dei risultati della ricerca o un messaggio Intestazione modulo impossibile o Ricerca note a piè di pagina impossibile. Questi errori sono causati da altri file mancanti dalla directory di installazione NetQuestion. E' possibile individuarli sul CD del prodotto oppure è possibile richiederli al supporto IBM. I nomi file vengono specificati tutti nel modulo di ricerca. E' possibile visualizzare l'origine del modulo di ricerca per stabilire i nomi. Cercare i parametri value= dei seguenti campi di immissione nascosti:
<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">
Le voci evidenziate sono quelle per VisualAge per Java. Le voci equivalenti per altri prodotti includono, invece di ivj:
Un Errore server interno indica generalmente che un'applicazione in esecuzione sul server è stata disattivata. E' possibile inoltre visualizzare una finestra di dialogo Windows con il titolo program.exe - Errore applicazione e un messaggio che comincia con l'Istruzione su memoria "0xnnnnnnnn" su "0xnnnnnnnn". Se si chiude questa finestra di dialogo selezionandoOK, il browser visualizza il messaggio Errore interno del server.
Se questo errore si verifica durante una operazione di ricerca, potrebbero verificarsi problemi con gli indici di ricerca del prodotto. Tentare la nuova configurazione dell'aiuto per il prodotto, quindi immettere nuovamente la query di ricerca. Se ciò non risolve il problema, contattare il supporto IBM.
Se l'errore si verifica durante la normale ricerca dell'aiuto, potrebbero esserci dei problemi di autorizzazione delle directory su un file system NTFS. Scollegare il sistema Windows NT o Windows 2000, collegarsi come amministratore e verificare che tutti i file e le cartelle nella directory di installazione NetQuestion e la directory di aiuto del prodotto (_INSTALL_DIR\doc o INSTALL_DIR\help, a seconda del prodotto) abbiano le proprie autorizzazioni di sicurezza impostate su Tutti - Controllo totale. Per effettuare tale operazione:
Se si apportano delle modifiche alle autorizzazioni, chiudere queste finestre di dialogo e tentare di ricaricare la pagina. Se non è necessario apportare delle modifiche alle autorizzazioni o se l'errore persiste dopo tali modifiche, tentare di cancellare il file vahelp.cfg dalla directory d'installazione NetQuestion, quindi configurare nuovamente l'aiuto relativo al prodotto.
Se si continuano a visualizzare i messaggi Errore server interno, contattare l'assistenza IBM.
In alcuni casi il sistema di aiuto potrebbe non avere ben configurati gli aiuti su un particolare prodotto oppure potrebbe essere necessario rimuovere alcune informazioni di configurazione nel tentativo di correggere una installazione. E' possibile configurare nuovamente l'aiuto per il prodotto seguendo le istruzioni riportate di seguito. Prima di incominciare, è necessario conoscere:
La prima parte di questo processo è utile per determinare se è già stato configurato l'aiuto e, dunque, necessita soltanto di essere ripristinato. Per stabilire se il proprio prodotto è già stato configurato, immettere quanto segue in una prompt del comando:
vahcfg list /f %IMNINSTSRV% | more
E' necessario consultare una serie di elenchi di prodotti e componenti per ogni prodotto configurato per l'aiuto. Se si trova un prodotto la cui directory corrisponde a quella del prodotto, annotare il nome del prodotto. Ad esempio, se l'output dall'elenco vahcfg include quanto segue:
Prodotto: va400 (IBM WebSphere Development Tools per AS/400 Help System) Directory scrivibile: C:\Program Files\IBM\WDT400\help Non aggiornare i file per questo prodotto Comp: qadtswin (WebSphere Development Tools per AS/400) File zip: C:\Program Files\IBM\WDT400\help\qadtswin.zip Indice: va45uadt ...
Il nome del prodotto è va400. Se viene visualizzata una voce per il proprio prodotto, è possibile configurare nuovamente l'aiuto utilizzando il comando vahcfg regen. Se, invece, non viene visualizzata alcuna voce, è necessario configurare nuovamente l'aiuto utilizzando il comando vahcfg install. Entrambi i comandi vengono descritti successivamente in questa sezione.
Prima di eseguire il comando vahcfg regen o vahcfg install, è necessario verificare anche che il disco su cui è stata ubicata la directory di documentazione disponga di spazio su disco sufficiente per conformare gli indici di ricerca relativi all'aiuto del prodotto. Questi indici vengono estratti dai file *.zip nella directory di documentazione e vengono scritti sulle directory secondarie della directory di documentazione tramite il programma vahcfg. Come regola generale, è necessario disporre almeno di tanto spazio su disco quanto ne viene utilizzato dai file zip nella directory di documentazione.
Per eseguire il comando vahcfg regen, immettere quanto segue:
vahcfg regen /p prodname /f %IMNINSTSRV%
dove prodname corrisponde al nome del prodotto indicato durante l'esecuzione del comando vahcfg list.
Per eseguire vahcfg install, immettere il seguente comando:
vahcfg install /w docdir /f %IMNINSTSRV%
dove docdir è il percorso completo alla directory contenente i file di aiuto del prodotto. Se quella directory contiene degli spazi (ad es., c:\Program Files\IBM\..., racchiudere l'intero percorso della directory tra parentesi.
Dopo l'installazione o la nuova creazione (che potrebbe durare parecchi minuti), tentare di caricare nuovamente l'aiuto. Se il problema che si sta cercando di correggere persiste, seguire le istruzioni in 6.5 Richiamo del file di log da vahcfg regen o vahcfg install, contattare il supporto IBM e inoltrare il file di log al supporto IBM.
Si è tentato di creare nuovamente o di installare l'aiuto del prodotto utilizzando il comando vahcfg regen o vahcfg install e se tale tentativo non ha risolto i problemi, tentare quanto segue per creare un file di log che può essere utilizzato dal supporto IBM per un'ulteriore diagnosi del problema:
E' possibile inoltre fornire il file di log creato al supporto IBM.
Notare che alcune precedenti versioni del comando vahcfg non producono un file di log. Le versioni che non supportano la registrazione non visualizzeranno tutti gli output sullo schermo; le versioni che invece supportano tale registrazione visualizzeranno un messaggio che indica dove sono state registrate le informazioni.
Il sistema di ricerca NetQuestion è estremamente veloce nel ricercare le corrispondenze di quasi tutte le query di ricerca generiche. Se si ricercano delle corripondenze alla stringa a*, è necessario che il sistema di ricerca trovi tutti i documenti contenenti almeno una parola che cominci con la lettera A, in questo modo però si perde un pò di tempo. Ma se la ricerca è specifica, è possibile prevedere che i risultati della ricerca verranno visualizzati in pochi secondi. Nel caso in cui la ricerca duri toppo (ad esempio, più di 1 minuto), è possibile che vi sia un problema relativo all'utilizzo di Netscape Navigator 4.5 o versione successiva su un sistema Windows 2000 . (Questo problema si verifica anche su alcuni sistemi Windows NT.)
Un problema noto con Netscape (versioni comprese tra 4.5 e 4.74 e altre) su alcuni sistemi Windows 2000 rende molto lenta la ricerca della guida in linea. Quando si inoltra un modulo da queste versioni di Netscape, l'applicazione Netscape utilizza la maggior parte dei cicli del processore disponibili sul sistema fino a che non si riceve una risposta dal sistema remoto. (E' possibile verificare ciò aprendo la pagina Task manager di Windows durante una ricerca, passando al separatore Processi e facendo clic sull'intestazione di colonna CPU. Se si incontra tale problema, verrà visualizzato netscape.exe nella parte superiore di questo elenco e verrà utilizzato il 97-99% del tempo della CPU.)
Generalmente l'utilizzo di questa CPU non è un problema quando si effettua una ricerca remota (ad esempio su un sito web). Tuttavia, poiché il programma di ricerca di un prodotto è in esecuzione sul proprio sistema locale, il fatto che Netscape utilizzi una grande quantità di CPU indica che è rimasto a disposizione un tempo della CPU molto scarso perché il programma di ricerca esegua la ricerca. Ne risulta che un'azione di ricerca che deve restituire un risultato entro un secondo può impiegare diversi minuti su Windows 2000.
E' possibile evitare questo problema di prestazioni su Windows 2000 selezionando una finestra non Netscape differente dopo ogni inoltro di ricerca. Ciò causa, generalmente, l'arresto di Netscape che utilizza cicli di CPU eccessivi durante l'attesa di una risposta e i risultati della ricerca vengono visualizzati generalmente entro un secondo dopo lo switch della finestra. La stessa tecnica può funzionare anche su Windows NT sebbene meno constantemente.
In alternativa, è possibile utilizzare Microsoft Internet Explorer per visualizzare l'aiuto, poiché il problema delle prestazioni non si verifica con questo browser.
E' possibile ricevere uno dei seguenti messaggi di errore durante l'esecuzione di una ricerca del sistema di aiuto dal proprio browser:
Ciò avviene in due situazioni:
Il codice di errore 73, generalmente non viene restituito dopo una richiesta di ricerca vuota, solo su stringhe composte solo da stopword. Se è possibile riprodurre in modo affidabile il messaggio che indica una richiesta di ricerca vuota quando la stringa di ricerca è chiaramente non vuota (e non è una ricerca di sole stopword), il modello della ricerca potrebbe essere danneggiato. Ubicare i moduli di ricerca hgssrch.htm e hgcsrch.htm dalla directory di aiuto del prodotto (generalmenteINSTALL_DIR\doc o INSTALL_DIR\help) e fornirli al responsabile del supporto nel momento in cui si contatta il supporto IBM.
E' possibile visualizzare qualsiasi numero di altri messaggi di errore nel momento in cui si tenta di effettuare la ricerca. Se l'errore è uno dei seguenti, tentare l'azione consigliata prima di contattare il supporto IBM.
Causa: il client di aiuto non poteva avviare il servizio di ricerca (o, per il Component Broker, il servizio di ricerca non è stato impostato per avviarsi automaticamente durante il logon). E' possibile che si verifichi ciò se si sta effettuando la ricerca sul sistema locale (http://localhost:49213) o su un server di aiuto remoto.
Azione consigliata (aiuto locale):
Consultare 3.1 HTTPDL.EXE non in esecuzione e specificamente la sezione sull'importazione delle voci di registro di avvio automatico, in questo modo il servizio di ricerca si avvia automaticamente nel momento in cui si effettua il log on. Per un workaround più rapido, è possibile aprire una ricerca comandi e immettere:
imnss start serverSe questo comando restituisce un messaggio che include la riga:
Il servizio di ricerca è stato avviato.E' possibile eseguire nuovamente la ricerca, senza ricevere il messaggio di errore rc=33.
Azione consigliata (aiuto fornito in remoto):
Il processo di ricerca NetQuestion della macchina server potrebbe non essere attivo per il riavvio del sistema e perché nessuno è ancora collegato al sistema. Consultare 14.0 Avvio del servizio di ricerca NetQuestion al momento dell'avvio.
Causa: il programma di ricerca non ha ricevuto alcun nome indice valido nella richiesta di ricerca. Il modulo di ricerca potrebbe essere corrotto o gli indici specificati potrebbero non essere più registrati oppure si potrebbe rilevare un problema con l'installazione NetQuestion.
Azione raccomandata: per prima cosa, cancellare tutti i file hg*.htm dalla directory di aiuto del prodotto (INSTALL_DIR\doc o INSTALL_DIR\help). In seguito tentare di riconfigurare l'aiuto per il prodotto. Se il problema persiste, è necessario installare nuovamente NetQuestion e configurare nuovamente l'aiuto per il prodotto.
Causa: il modulo della ricerca specifica una intestazione o una nota a piè pagina di ricerca inesistente (un file contenente un frammento HTML da inserire sopra o sotto i risultati della ricerca).
Azione consigliata: consultare 4.2 Errori File non trovato durante la ricerca per ulteriori informazioni.
Causa: è stata immessa una query di ricerca che ha troppe parole corrispondenti. Il motore di ricerca non può gestire una query che contiene delle corrispondenze con più di 1024 parole differenti. Ad esempio, se si immette la stringa di ricerca "a* b* c* d*" (senza le virgolette), si stanno ricercando i documenti che contengono parole che cominciano con una delle lettere a, b, c o d. Poiché vi sono troppe parole che corrispondono a questi criteri di ricerca, il motore di ricerca non può produrre un elenco ordinato e significativo di hit di ricerca, di conseguenza non effettua il tentativo.
Azione consigliata: immettere una richiesta di ricerca che produca un numero minore di corrispondenze di parole.
Causa: è stata immessa una query di ricerca non valida. Ad esempio una query di ricerca di "-java" (visualizza tutti i documenti che non contengono la parola java) non è considerata valida.
Azione consigliata: immettere una richiesta di ricerca che contiene almeno un termine consentito.
Causa: è possibile che si verifichi questo errore quando il programma non riesce a leggere le variabili d'ambiente necessarie per una riuscita operazione di ricerca. Se l'aiuto è stato configurato per essere eseguito su un server web diverso dal server web NetQuestion HTTPDL.EXE, potrebbe essere necessario modificare le impostazioni del server web per verificare che alcune variabili d'ambiente siano visibili al CGI di ricerca (il programma richiamato dal parametro "action=" della tag <form> all'interno del modulo di ricerca). Su alcuni server web, le variabili d'ambiente del sistema vengono nascoste per default. Le variabili a cui devono avere accesso i CGI di ricerca sono IMNINSTSRV e IMNINST. Netscape Enterprise Server è un esempio di server web che nasconde le variabili d'ambiente per default.
Azione consigliata: modificare le proprie impostazioni del server web, per esportare manualmente queste variabili sulle applicazioni CGI del server web o per rendere visibili tutte le variabili d'ambiente locali sui CGI. Su Netscape Enterprise Server è possibile effettuare questa operazione seguendo le istruzioni riportate di seguito:
set imn
Il sistema deve riportare le impostazioni per le variabili IMNINST e IMNINSTSRV, come ad esempio:
IMNINST=help IMNINSTSRV=C:\IMNNQ_NT
Init fn="init-cgi" IMNINSTSRV=c:/imnnq_nt Init fn="init-cgi" IMNINST=help
"AVVERTENZA: i file di configurazione sono stati modificati manualmente. Utilizzare questo pulsante per caricare gli ultimi file di configurazione."
fare clic su Carica file di configurazione.
Per alti server web, consultare la documentazione relativa al server web per informazioni su come rendere visibili le variabili di ambiente alle applicazioni CGI.
Causa: si verifica un errore rc=32 o un errore che menziona il file NETQ.CFG quando NetQuestion non può accedere in modo appropriato ad un indice del prodotto. Questo potrebbe accadere perché l'installazione di NetQuestion o un indice particolare sono stati danneggiati oppure potrebbe verificarsi solo sulla prima ricerca eseguita su un dato indice dopo il riavvio. Notare che sebbene il messaggio per alcune forme di questo errore menziona il file NETQ.CFG, questo file non esiste realmente; l'errore fa riferimento ai problemi con altri file di configurazione dell'indice NetQuestion.
Azione consigliata: stabilire la probabile causa del problema e correggere come descritto di seguito:
Se una ricerca riporta un messaggio di errore rc=76, è necessario ripristinare un o più degli indici di ricerca. Seguire queste istruzioni per ripristinare gli indici:
In alcune situazioni l'unico modo per far funzionare bene il proprio aiuto è quello di disinstallare e di installare nuovamente NetQuestion, quindi riconfigurare l'aiuto per i prodotti che utilizzano il VisualAge Help System. Notare che la disinstallazione di NetQuestion può provocare la rimozione degli indici di ricerca utilizzati dai prodotti, come ad esempio IBM DB2, che non utilizzano il VisualAge Help System e può, dunque, impedire la ricerca dell'aiuto di quei prodotti dopo la nuova installazione di NetQuestion. E' possibile che sia necessario installare nuovamente il prodotto in questione per ripristinare gli indici di ricerca.
Nelle istruzioni che seguono, immettere tutti i comandi da una prompt del comando. Prima di cominciare, è necessario determinare la directory d'installazione NetQuestion.
Il programma di disinstallazione di NetQuestion, uninstnq.exe nella directory NetQuestion, sposterà NetQuestion solo se non è stato registrato alcun indice. E' possibile prima rimuovere qualsiasi indice registrato dai prodotti che utilizzano il Sistema di aiuto VisualAge di IBM emettendo il comando vahcfg remove per ogni prodotto. Seguire queste istruzioni:
Dopo aver rimosso tutti questi prodotti è possibile verificare se gli indici sono ancora registrati per altri prodotti immettendo il seguente comando:
imnixlst
Se l'elenco che ne risulta contiene delle voci che cominciano con DB2, CXX o VAC, è possibile che si disponga di indici registrati con prodotti come DB2, IBM C e C++ Compilers, o VisualAge C++ 4.0, che non utilizzano il VisualAge Help System Help. Se si procede con la disinstallazione manuale di NetQuestion, tutti questi indici vengono persi e potrebbe essere necessario reinstallare i rispettivi prodotti per ricercare la guida ad essi relativa. Se questi indici sono ancora in elenco e e si è preparati a perdere le funzioni di ricerca per tali prodotti o a reinstallare gli stessi, procedere con la cancellazione degli indici rimanenti, seguendo queste istruzioni:
Se sono elencati gli indici i cui nomi iniziano con IVJ3, VJ32, IWZ o VA45, si consiglia di cancellarli poiché possono essere ripristinati successivamente utilizzando vahcfg install.
Se non è possibile cancellare tutti gli indici rimanenti a causa di un errore NetQuestion, è necessario spostare manualmente NetQuestion (consultare la sezione 11.4 sottostante).
Immettere il comando uninstnq e attendere qualche minuto, fino a che non si nota che la directory NetQuestion è quasi vuota. La directory non dovrebbe contenere nessun file che comincia con imn* o imq*. E' possibile attendere fino a dieci minuti per il completamento dell'operazione. Se dopo dieci minuti la directory contiene ancora i file imn* o imq*, potrebbero esservi degli indici ancora registrati con il servizio di ricerca (in questo caso tornare alla sezione 11.2) o l'installazione di NetQuestion potrebbe essere corrotta (passare alla sezione 11.4). Altrimenti, riavviare e passare alla sezione 11.5.
Se non è possibile rimuovere NetQuestion utilizzando uninstnq.exe, è possibile rimuoverlo manualmente nel modo seguente:
Per modificare o rimuovere le variabili d'ambiente, seguire le istruzioni specifiche della piattaforma riportate di seguito:
Per installare nuovamente NetQuestion, sarà necessario il CD del prodotto o un file zip d'installazione NetQuestion dal supporto IBM. I seguenti prodotti dispongono di una copia installabile di NetQuestion sul CD del prodotto:
Per altri prodotti, è possibile determinare se esiste una copia installabile di NetQuestion sul CD ricercando un file definito ntq_sbcs.iss. La directory che contiene questo file deve contenere un file setup.exe che può avviare l'installazione di NetQuestion.
Se si riceve un file zip d'installazione dall'IBM, decomprimerlo su una directory temporanea.
Dopo aver ricevuto una copia installabile di NetQuestion, seguire queste istruzioni:
Per ogni prodotto rimosso manualmente dal sistema di aiuto (utilizzando il comando vahcfg remove, come indicato nella sezione 11.1), eseguire il comando vahcfg install come descritto in 6.0 Nuova configurazione dell'aiuto. E' possibile ora ricercare l'aiuto del prodotto. Se gli errori persistono, verificare altre sezioni di questo documento per delle possibili soluzioni o contattare il supporto IBM.
Se non è possibile avviare l'aiuto dall'interno dell'interfaccia utente del prodotto, è possibile creare un'icona per avviarlo facendo doppio clic su un'icona (in modo che si possa utilizzare l'aiuto durante il tentativo di risolvere il problema).
Nota
E' possibile creare una scelta rapida per avviare l'aiuto del prodotto nel modo seguente:
instance "INSTALL_DIR\DOC_DIR\CONFIG_FILE" open index.htm
dove INSTALL_DIR è la directory in cui è installato il prodotto, DOC_DIR è generalmente doc o help e CONFIG_FILE è il nome del file di configurazione di aiuto del prodotto (ivjhlp.cfg per VisualAge per Java; consultare 2.0 Non accade nulla quando si tenta di avviare l'aiuto per informazioni su come stabilire i nomi del file di configurazione e delle per altri prodotti). Verificare che il percorso completo al file di configurazione sia tra virgolette, se quel percorso contiene spazi.
E' possibile aggiungere l'icona creata al menu Avvio/Start facendo clic con il tastino destro del mouse sull'icona, selezionando Copia dal menu a comparsa, quindi in Windows Explorer ricercare la directory di installazione Windows, sotto ...\Profili\Tutti gli utenti\Menu avvio e incollarli sulla directory o su una sottodirectory appropriata.
E' possibile installare e configurare il sistema di aiuto su un server web di Windows NT o di Windows 2000, in modo che altri membri dell'organizzazione possano visualizzare e ricercare l'aiuto in linea su una rete senza dover utilizzare NetQuestion e il codice del sistema di aiuto sulle workstation.
Note sul prodotto
Per effettuare questa installazione di rete, è necessario disporre del software del server web, come ad esempio Microsoft PWS (Peer Web Services) o Microsoft IIS, installato sul server. Il server web deve disporre di directory per gli script. (In PWS e IIS, la directory script si trova generalmente sotto x:\inetpub.) Dopo l'installazione del software del server, seguire queste istruzioni:
vahwebx.exe vahwebx.cat vahelp.cfg *foot.htm *head.htm *henus.htm
I primi tre file sono necessari; i file successivi devono essere copiati se presenti, ma se mancano dalla directory NetQuestion non è necessario averli nella directory x:\inetpub\scripts.
HTML_HOSTNAME=server.city.domain.organization CGI_BIN_DIR=scripts START_LITE_DAEMON=0 START_NETQ_DAEMON=0
Gli utenti devono essere in grado di accedere all'aiuto basato sul server premendo semplicemente F1 o selezionando una voce di menu ? dall'interno dell'applicazione IBM. Oppure possono accedere all'aiuto utilizzando l'URL seguente:
http://YourHostname/scripts/vahwebx.exe/help/prodname/Extract/0/index.htm
dove prodname è:
IN seguito se si esegue vahcfg install o vahcfg regen sul sistema server, è necessario modificare il file di definizione nell'istruzione 3 precedente.
Dopo che gli utenti hanno modificato i loro file di configurazione del prodotto per puntare al server, essi possono eseguire il comando per cancellare tutti i file *.toc, *.htm e *.zip e i file d'indice della ricerca, dalla propria directory di aiuto del prodotto:
vahcfg remove /p prodname /f %IMNINSTSRV%
oppure possono semplicemente cancellare manualmente i file *.toc, *.htm e *.zip. Tuttavia, questo metodo non cancellerà le directory dell'indice riportate di seguito, quindi sarà necessario cancellarle manualmente.
Consultare 14.0 Avvio del server di ricerca NetQuestion invece di questa sezione, se si sta configurando il server in una configurazione dell'aiuto in rete.
E' possibile impostare l'HTTP e i server di ricerca perché si avviino automaticamente al momento del logon, impostando due voci di registro sul sistema. Per impostare queste voci, seguire queste istruzioni:
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"
In questo modo le due voci verranno importate nel registro in modo che al successivo logon(o riavvio su Windows 95 o Windows 98) i server si avviino automaticamente.
Se si sta utilizzando una configurazione di aiuto in rete in cui l'aiuto viene distribuito da un server e non dal proprio sistema, è possibile che si verifichino dei problemi durante le ricerche sul sistema remoto. Quando si configura l'avvio manuale del daemon di ricerca NetQuestion (durante l'installazione del prodotto, o dopo aver seguito le istruzioni in 13.0 Avvio automatico dei server NetQuestion) il daemon si non avvia effettivamente fino a che l'utente non si collega al sistema server. Ciò indica che dopo il riavvio del sistema e prima che l'utente del sistema si sia collegato, il daemon di ricerca non è attivo. E' possibile, tuttavia, utilizzare Task Scheduler di Windows per avviare il daemon di ricerca all'avvio del sistema. Le istruzioni in questa sezione si applicano al sistema che serve l'aiuto.
Nota: se non si sta utilizzando una configurazione di aiuto della rete, non è necessario seguire le istruzioni in questa sezione.
Prima di cominciare, è necessario stabilire la directory d'installazione NetQuestion. E' possibile inoltre che sia necessaria una eliminazione manuale del contenuto del registro. Il registro può contenere voci per l'avvio del daemon di ricerca NetQuestion al momento del logon. Se l'avvio del daemon è impostato al momento dell'avvio del sistema, la voce di registro non è necessaria. Per eliminare il contenuto del registro:
Ora è possibile impostare Windows in modo che i server vengano avviati al momento dell'avvio del sistema. Prima, verificare che Microsoft Windows Task Scheduler sia installato sul sistema che agisce da server di aiuto:
Per configurare l'avvio di NetQuestion Search Server al momento dell'avvio del sistema sul server di aiuto:
Nota: dopo il riavvio della macchina server di aiuto, potrebbe essere necessaria un'attesa di un minuto o oltre dopo la visualizzazione del pannello del login, prima che Windows avvii il server di ricerca.
E' possibile stabilire l'ubicazione della directory di installazione NetQuestion aprendo una prompt del comando e immettendo:
set IMNINSTSRV
La directory restituita è la directory di installazione NetQuestion. Se la variabile non è impostata, è possibile determinare la directory di installazione cercando nel registro di Windows. Immettere regedit in una prompt del comando e aprire le voci di registro per la chiave HKEY_LOCAL_MACHINE\SOFTWARE\IBM\NetQuestion\CurrentVersion\Installation Directory. La voce "Directory" per questa chiave deve puntare alla directory di installazione NetQuestion.
Su Windows 95 e Windows 98, se la variabile d'ambiente IMNINSTSRV non è impostata ma è possibile impostare la directory dal registro, è possibile che sia necessario modificare il file autoexec.bat. (Se si verifica questa condizione con una versione di Windows Millennium Edition, consultare 17.0 Considerazioni particolari per Windows Millennium Edition). Il processo di installazione NetQuestion dovrebbe aver modificato autoexec.bat per aggiungere un comando che richiami il file batch imnenv.bat archiviato nella directory NetQuestion. Il comando aggiunto è:
se esiste _NETQ_DIR_\imnenv.bat call _NETQ_DIR_\imnenv.bat
Se questa riga manca o _NETQ_DIR_ punta alla directory errata, aggiungere la riga con la directory NetQuestion corretta. E' necessario inoltre verificare che il file batchimnenv.bat richiamato in autoexec.bat esista effettivamente e contenga voci che indicano la directory corrente e non altre directory NetQuestion. Il contenuto di imnenv.bat deve essere:
@echo off set IMNINSTSRV=_NETQ_DIR_ set IMNINST=help set PATH=PATH;%IMNINSTSRV%
Se non è possibile avviare l'aiuto dal browser o da una riga comandi, è possibile che non si disponga dell'associazione dei file appropriati impostati per i file HTML. Il codice client del Sistema di aiuto utilizza le voci di registro per stabilire il browser del sistema di default in base alle associazioni di file. E' possibile verificare le associazioni di file utilizzando l'editor del registro:
SE non appare tale voce, è possibile aggiungerla nel modo seguente:
Per Netscape Communicator:
user_pref("browser.wfe.ignore_def_check", true);
Per Internet Explorer:
Se si sta utilizzando Windows Millennium Edition, le modifiche apportate a autoexec.bat per caricare le variabili d'ambiente NetQuestion potrebbero non essere attive anche dopo un riavvio; esse potrebbero anche perdersi. Per questo motivo le variabili d'ambiente NetQuestion potrebbero rimanere non definite, quindi potrebbero, a turno, provocare i seguenti tipi di errori:
E' possibile individuare la causa dei problemi verificando, dopo il riavvio, che la variabile d'ambiente sia impostata correttamente. SE non è ancora impostata, utilizzare il programma misconfig.exe nella directory del sistema Windows, per apportare le seguenti modifiche all'ambiente:
Component Broker non utilizza la parte client di VisualAge Help System, la parte che avvia l'aiuto da un'azione di menu F1 o Help nell'interfaccia utente. Questo ha due implicazioni importanti:
Component Broker fornisce informazioni sull'aiuto per la risoluzione dei problemi nella directory doc\readme.
Sui sistemi su cui l'aiuto installato è scritto interamente o parzialmente in Cinese semplificato (locale zh_CN), Taiwanese (zh_TW), Coreano (ko_KR) o Giapponese (ja_JP), è necessario apportare modifiche ai comandi vahcfg e NetQuestion nel modo seguente:
vahcfg regen /p vj32 /f %IMNINSTSRV% /l ja_JP
Gli errori di inclusione della locale possono danneggiare gli indici di ricerca e il sistema di ricerca NetQuestion.
| Comando SBCS | Comando DBCS |
| imnixlst | imqixlst |
| imnixdel | imqixdel |
| imnss start server | imqss -start dbcshelp |
Queste modifiche sono necessarie perché NetQuestion utilizza file eseguibili e server differenti per i propri sistemi di ricerca single-byte e double-byte.