Utilizzando una variante del comando runwithtrace , è possibile raccogliere la traccia da un'istanza di IBM® MQ Explorer installata nel proprio ambiente Eclipse o in un prodotto basato su Eclipse.
Prima di iniziare
Questa attività presuppone che IBM MQ Explorer sia stato installato nel proprio ambiente Eclipse o in un prodotto basato su Eclipsee, pertanto, non può utilizzare il comando runwithtrace standard come descritto in Raccolta della traccia di IBM MQ Explorer.
Informazioni su questa attività
IBM MQ Explorer può essere installato nel proprio ambiente Eclipse o nel prodotto basato su Eclipse per facilitare lo sviluppo di applicazioni Java o per sviluppare delle proprie estensioni.
Per raccogliere la traccia, utilizzare un comando runwithtrace per avviare IBM MQ Explorer. Non è possibile utilizzare il comando runwithtrace fornito con il prodotto. Si utilizza invece una variante del comando, come descritto nella seguente procedura.
Nota: normalmente la traccia viene abilitata solo su richiesta del rappresentante del servizio IBM . La traccia rallenta IBM MQ Explorer e i file di traccia possono diventare rapidamente grandi.
Procedura
- Il meccanismo di traccia IBM MQ Explorer si basa sui plug-in AspectJ e Equinox Weaving installati. Per confermare che sono installati:
- Fare clic su ?
- Fare clic su Informazioni ...
- Fare clic su Dettagli di installazione
- Fare clic sulla scheda Plug-in .
Il plug-in org.eclipse.equinox.weaving.caching.j9
non esiste più ma si ha bisogno di questo plug-in se si stanno utilizzando le release IBM MQ 9.0 Long Term Support o IBM MQ 9.0 Continuous Delivery, antecedenti a IBM MQ 9.0.4.
Verificare che i seguenti plug-in siano installati:
org.aspectj.runtime
org.aspectj.weaver
org.eclipse.equinox.weaving.aspectj
org.eclipse.equinox.weaving.caching
org.eclipse.equinox.weaving.caching.j9
org.eclipse.equinox.weaving.hook
- Se non sono già installati, installare i plug-in AspectJ ed Equinox Weaving. Questi
plug-in devono corrispondere alla versione di Eclipse che si sta utilizzando e possono essere scaricati dal sito di download di Eclipse AspectJ Development Tools. Per determinare quale sito di scaricamento utilizzare per la versione di Eclipse, consultare https://projects.eclipse.org/projects/tools.ajdt.
Per informazioni sul livello Eclipse su cui si basa IBM MQ Explorer , consultare Novità e modifiche in IBM MQ Explorer.
Al momento, queste build sono disponibili soltanto come build di sviluppo;
selezionare l'ultima disponibile.
Per installare i plug-in AspectJ ed Equinox Weaving,
completare la seguente procedura secondaria:
- Fare clic sulla Guida quindi fare clic su Installa nuovo software ...
- Fare clic su Aggiungi ... quindi immettere l'ubicazione del sito di download appropriato per la versione di Eclipse.
Ad esempio, per Eclipse 4.4, immettere https://download.eclipse.org/tools/ajdt/44/dev/update.
- Fare clic su OK
Viene visualizzato un elenco del software disponibile.
- Espandere la categoria Altri strumenti AJDT (facoltativo) e selezionare AspectJ Compiler and Equinox Weaving SDK.
- Fare clic su Avanti e seguire le istruzioni della procedura guidata.
- Traccia IBM MQ Explorer.
Quando si avvia IBM MQ Explorer utilizzando il comando runwithtrace , vengono incorporati ulteriori parametri che abilitano la traccia di IBM MQ Explorer. Notare che il
comando runwithtrace non prende alcun parametro.
L'ubicazione di output del file di traccia viene stampata sulla riga comandi quando viene eseguito il comando perché l'ubicazione effettiva dipende
- dallo stato dell'installazione di IBM MQ.
- dalle autorizzazioni utente.
I file di traccia IBM MQ Explorer hanno un nome del formato AMQYYYYMMDDHHmmssmmm.TRC.n che indica l'ora di inizio della sessione di traccia. Quando un file di traccia raggiunge la sua dimensione massima, la funzione di traccia rinomina tutti i file di traccia dalla sessione incrementando di una unità il suffisso del file .n. La funzione di traccia crea quindi un nuovo file con il suffisso .0 che contiene l'ultima traccia.
- Disinstallare i plug-in AspectJ ed Equinox Weaving. Una volta terminata la traccia IBM MQ Explorer , è possibile rimuovere i plugin AspectJ ed Equinox Weaving dall'ambiente Eclipse . Per disinstallare i plug-in AspectJ ed Equinox Weaving:
- Fare clic su Guida e quindi su Informazioni su ....
- Fare clic su Dettagli di installazione e quindi sulla scheda Software installato .
- Selezionare gli elementi AspectJ Complier e Equinox Weaving SDK.
- Fare clic su Disinstalla ... e attenersi alle istruzioni della procedura guidata.