Comando mqsireadlog

Piattaforme supportate

Scopo

Utilizzare il comando mqsireadlog per richiamare la registrazione di traccia per il componente specificato. Questo comando è valido per:
Traccia utente
Specificare l'opzione -u.
Traccia del servizio
Specificare l'opzione -t. Si consiglia di utilizzare questa opzione solo se indicato dall'azione descritta in un messaggio BIPxxxx o dal centro di assistenza IBM.

E' possibile specificare che l'output sia indirizzato ad un file o a stdout. I record di traccia restituiti da questo comando sono nel formato XML e possono essere esaminati con un browser XML. Se si indirizza l'output ad un file, i dati vengono scritti nella code page utf-8. Il file è quindi indipendente dalla piattaforma e può essere trasferito su altri sistemi per essere esaminato o formattato utilizzando il comando mqsiformatlog.

Su HP-UX si consiglia di impostare il parametro size del comando mqsichangetrace su un valore inferiore a 500 MB. Tenere presente che la dimensione dei file XML generati è spesso la metà del file di traccia di origine e l'impostazione del parametro size su un valore maggiore di 500 MB potrebbe causare dei problemi.

Se si trasferisce questo file su un altro sistema, accertarsi che si stia utilizzando un programma di trasferimento file che non converte i dati (ad esempio, specificando un'opzione di trasferimento binario).

Se si specifica un broker o una delle relative risorse (gruppo di esecuzione o flusso di messaggi), è necessario averne effettuato la distribuzione prima di poter avviare la traccia e leggere i file di registrazione.

Sintassi

Traccia utente

Traccia del servizio

Parametri

component
(Obbligatorio) Il nome del componente per il quale deve essere letta la registrazione. Questo può essere un nome di broker oppure un nome di Gestione configurazione o ancora i valori fissi , UserNameServer, workbench, o infine utility (sono tutti sensibili al maiuscolo/minuscolo sui sistemi Linux e UNIX e su z/OS).
-u
(Facoltativo) Consente di leggere il contenuto della registrazione della traccia utente. E' valido solo se si seleziona il componente broker.
-e egroup
(Facoltativo) L'etichetta del gruppo di esecuzione per il quale si desidera leggere le informazioni di registrazione.
-o outputfilename
(Facoltativo) Il nome del file nel quale si desidera scrivere i dati di registrazione. Se si specifica un nome di percorso completo, il file viene creato nella directory specificata. Se si specifica solo il nome del file, questo viene creato nella directory di lavoro corrente. Il contenuto del file viene scritto nella code page utf-8, che non dipende dalla piattaforma e conserva i dati come ad esempio caratteri DBCS.

E' necessario specificare il nome del file se si desidera formattare la registrazione utilizzando il comando mqsiformatlog. Se il nome del file non viene specificato, il contenuto della registrazione viene scritto su stdout. Si consiglia di utilizzare come estensione del file .xml.

-f
(Facoltativo per traccia utente - Obbligatorio per traccia del servizio). Consente di leggere il file di registrazione direttamente dal file system. Se non si specifica questa opzione, il comando invia un messaggio XML al componente per richiedere il contenuto della registrazione. Se è stato specificato -t (traccia del servizio), è necessario specificare anche questo indicatore. Per ulteriori informazioni dettagliate, fare riferimento a Ulteriori parametri di pertinenza della traccia del servizio.

Se si specifica questa opzione, arrestare la traccia (mediante mqsichangetrace) prima di utilizzare il comando mqsireadlog. Se il file di registrazione è in uso quando si immette questo comando con tale indicatore, potrebbero essere restituiti record XML parziali. E' possibile evitare ciò, specificando -m safe nel comando mqsichangetrace. Se il componente di cui deve essere eseguita la traccia si è arrestato, non sarà quindi necessario immettere il comando mqsichangetrace.

Se la traccia non viene arrestata prima dell'immissione di questo comando, verificare il contenuto del file di registrazione creato ed eliminare gli eventuali record parziali dalla fine utilizzando un editor di testo prima di utilizzare il comando mqsiformatlog, poiché i record parziali non possono essere letti dal comando di formattazione.

Ulteriori parametri di pertinenza della traccia del servizio

Utilizzare tali opzioni solo quando indicato dal centro di assistenza IBM o da un messaggio BIPxxxx.

-t
(Obbligatorio) Consente di leggere il contenuto della registrazione della traccia del servizio.
-b qualifier
(Obbligatorio) Consente di leggere il contenuto della registrazione dell'agent del broker, dell'agent di Gestione configurazione o dell'agent del Server nomi utente oppure del programma di utilità del comando specificato. Questa opzione è valida solo se è stato specificato -t (traccia del servizio).

Nella seguente tabella sono riportate le combinazioni valide di qualifier e component per traccia del servizio.

Tale opzione viene utilizzata di solito per eseguire la traccia dei comandi stessi. Se si desidera eseguire la traccia di un determinato comando, eseguire tale comando con la variabile di ambiente MQSI_UTILITY_TRACE impostata su debug o normal prima di immettere tale comando per leggere l'output di traccia generato.

Immettere tali valori così come mostrato.

La traccia agent viene avviata quando si specifica l'indicatore -b nel comando mqsichangetrace. Procedere in tale modo solo quando indicato dal centro di assistenza IBM o da un messaggio di errore WebSphere Message Broker.

La traccia service viene avviata quando si specifica l'indicatore -b nel comando mqsichangetrace. Il formato del comando è:
mqsireadlog <brokername> -t -b service -f -o service.xml
Procedere in tale modo solo quando indicato dal centro di assistenza IBM o da un messaggio di errore WebSphere Message Broker.
-f
(Obbligatorio) Consente di leggere il file della registrazione direttamente dal file system. Quando è utilizzato con la traccia del servizio, tale indicatore ha le stesse caratteristiche di quando viene utilizzato con la traccia utente. Resta facoltativo se è specificato l'indicatore -e. E' necessario specificare questa opzione se si specifica l'indicatore -b.
Qualifier Component= <broker_name> Component= nome_ConfigMgr Component= UserNameServer Component= workbench Component= programma di utilità
mqsichangebroker x        
mqsichangeconfigmgr   x      
mqsichangetrace x x x    
mqsichangeusernameserver     x    
mqsiclearmqpubsub x        
mqsicreateaclentry         x
mqsicreatebroker x        
mqsicreateconfigmgr   x      
mqsicreateusernameserver     x    
mqsideleteaclentry         x
mqsideletebroker x        
mqsideleteconfigmgr   x      
mqsideleteusernameserver     x    
mqsiformatlog1         x
mqsijoinmqpubsub   x      
mqsilist2   x     x
mqsilist x        
mqsilistaclentry         x
mqsireadlog x x x   x
mqsireporttrace   x   x  
mqsistart x x x    
mqsistop x x x    
agent x x x    
servizio x x x    
workbench       x  
httplistener x        
Note:
  1. Poiché questo comando non dispone di un parametro componente, le informazioni di traccia vengono registrate e richiamate dai file di traccia del componente programma di utilità. Per ulteriori informazioni dettagliate, fare riferimento al comando mqsichangetrace.
  2. Se tale comando viene richiamato senza un componente, le informazioni di traccia vengono registrate e richiamate dai file di traccia programma di utilità in aggiunta ai file specifici del componente. Per ulteriori informazioni dettagliate, fare riferimento al comando mqsichangetrace.

Autorizzazione

Sulle piattaforme UNIX, l'ID utente deve essere un membro del gruppo mqbrkrs. Se è specificato l'indicatore -f, anche l'ID utente utilizzato per richiamare tale comando deve disporre dell'accesso al file di traccia.

Sulle piattaforme Windows, se è stato specificato l'indicatore -f, l'ID utente utilizzato per richiamare tale comando deve disporre dell'accesso al file di traccia. Se non è specificato l'indicatore -f, l'ID utente utilizzato per immettere il comando deve disporre dell'autorizzazione mqbrkrs.

Risposte

  • BIP8020 Impossibile accedere al database
  • BIP8029 Broker non configurato
  • BIP8032 Impossibile collegarsi alla coda
  • BIP8033 Impossibile inviare il messaggio XML
  • BIP8035 Risposta non ricevuta alla scadenza del timeout
  • BIP8036 Ricevuta risposta negativa
  • BIP8037 Indicatore selezionato non supportato
  • BIP8038 Opzione di comando non supportata
  • BIP8039 Gruppo di esecuzione non disponibile
  • BIP8040 Impossibile collegarsi al database
  • BIP8132 Qualificatore non valido

Esempi

Traccia utente per il broker WBRK_BROKER:

mqsireadlog WBRK_BROKER -u -e default -o trace.xml

Traccia del servizio per il componente ConfigMgr:

mqsireadlog ConfigMgr -t -b agent -f -o trace.xml

Traccia del servizio per il programma di utilità mqsiformatlog:

mqsireadlog utility -t -b agent -f -o trace.xml

E' possibile formattare il file di registrazione (trace.xml negli esempi precedenti) utilizzando il comando mqsiformatlog oppure visualizzarlo mediante un visualizzatore o un editor XML.

Attività correlate
Utilizzo delle registrazioni
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
an07300_