Comando mqsireporttrace

Piattaforme supportate

  • Windows
  • Sistemi Linux e UNIX
  • z/OS

Scopo

Utilizzare il comando mqsireporttrace per visualizzare le opzioni di traccia attualmente in vigore. Questo comando è valido per:
  • Traccia utente. Specificare l'opzione -u.

    Su z/OS, la traccia utente viene eseguita in un determinato gruppo di esecuzione di un broker. E' possibile limitare il comando al fine di eseguire la traccia di un determinato flusso di messaggi.

  • Traccia del servizio. Specificare l'opzione -t. Utilizzare questa opzione solo se indicato dall'azione descritta in un messaggio BIPxxxx o dal centro di assistenza IBM.

    Su z/OS, la traccia del servizio può essere eseguita per un determinato gruppo di esecuzione (come la traccia utente). A differenza della traccia utente, la traccia del servizio può essere eseguita anche per un agent attivo (ovvero, un broker o Server nomi utente).

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 interrogare le impostazioni della traccia.

Sintassi

Piattaforme Windows e sistemi Linux e UNIX

Traccia utente

Traccia del servizio

z/OS

Traccia utente

Traccia del servizio

Parametri

componente
(Obbligatorio - Piattaforme Windows e sistemi Linux e UNIX) Il nome del broker per il quale sono riportate le opzioni o il valore fisso UserNameServer. Entrambi i valori sono sensibili al maiuscolo/minuscolo sui sistemi Linux e UNIX.
-u
(Obbligatorio per traccia utente) Ricava le informazioni del prospetto dalla traccia utente.
-e egroup
(Obbligatorio per traccia utente, altrimenti facoltativo) L'etichetta del gruppo di esecuzione per il quale è richiesto un prospetto. Ciò è valido solo se è stato specificato come componente un broker.

Su z/OS questo nome è sensibile al maiuscolo/minuscolo. Includere il nome tra apici se contiene caratteri sia maiuscoli che minuscoli.

-f mflow
(Facoltativo) L'etichetta del flusso di messaggi per il quale è richiesto un prospetto. Ciò è valido solo se è stato specificato come componente un broker e un gruppo di esecuzione.

Su z/OS questo nome è sensibile al maiuscolo/minuscolo. Includere il nome tra apici se contiene caratteri sia maiuscoli che minuscoli.

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 per traccia del servizio) Ricava le informazioni del prospetto dalla traccia del servizio.
-b
(Alternativo a -e su tutte le piattaforme) Richiede un prospetto per la funzione agent.

Autorizzazione

L'ID utente utilizzato per immettere il comando deve avere l'autorizzazione mqbrkrs.

Risposte

  • BIP8002 Indicatori selezionati non compatibili (solo per z/OS)
  • BIP8003 Rilevati indicatori duplicati (solo per z/OS)
  • BIP8013 Il componente non esiste
  • BIP8020 Impossibile accedere al database
  • BIP8029 Broker non configurato
  • BIP8032 Impossibile collegarsi alla coda (solo piattaforme Windows e sistemi Linux e UNIX)
  • 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
  • BIP8045 Flusso di messaggi non disponibile
  • BIP8158 Formato non valido per il comando (solo per z/OS)
  • BIP8159 Parametro sconosciuto "..." (solo per z/OS)

Esempi

Piattaforme Windows e sistemi Linux e UNIX:
mqsireporttrace BrokerA -t -e "exgrp1"
z/OS:
F MQP1BRK,reporttrace t=yes,e='exgrp1'
Attività correlate
Utilizzo della traccia
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
an07310_