Comando mqsichangeflowstats

Piattaforme supportate

Scopo

Utilizzare il comando mqsichangeflowstats per:
  • Attivare o disattivare la pubblicazione dell'istantanea degli account e delle statistiche o per archiviare l'output del record.
  • Specificare che il comando venga applicato a uno specifico flusso di messaggi di flusso, a tutti i flussi in un gruppo di esecuzione o a tutti i gruppi di esecuzione appartenenti a un broker.
  • Modificare la granulosità dei dati raccolti in aggiunta a statistiche e account del flusso di messaggi standard. Questi dati aggiuntivi possono includere dati relativi a thread, a nodi, a terminali di nodi o a una composizione di questi dati.

Le opzioni impostate tramite questo comando rimangono attive sino alla successiva modifica tramite un nuovo comando mqsichangeflowstats.

Sintassi

Piattaforme Windows e sistemi Linux e UNIX

z/OS

Sinonimo cs

Parametri

brokername
(Obbligatorio - Piattaforme Windows e sistemi Linux e UNIX) Specifica l'etichetta del broker per il quale devono essere modificati account e statistiche.
-a
(Obbligatorio) Specifica che il comando modifica la raccolta di statistiche e account di archivio.
Nota: è necessario specificare -a o -s. Se non viene specificato uno di questi argomenti si riceverà un messaggio di avvertenza.
-s
(Obbligatorio) Specifica che il comando modifica la raccolta di istantanee di account e statistiche.
Nota: è necessario specificare -a o -s. Se non viene specificato uno di questi argomenti si riceverà un messaggio di avvertenza.
-e ExecutionGroupName
(Obbligatorio) Specifica il nome del gruppo di esecuzione, per il quale devono essere modificate le opzioni di account e statistiche.
Nota: è necessario specificare -e o -g. Se non viene specificato uno di questi argomenti si riceverà un messaggio di avvertenza.
-f MessageFlow
(Obbligatorio) Specifica l'etichetta del flusso di messaggi, per il quale devono essere modificate le opzioni di account e statistiche.
Nota: è necessario specificare -f o -j. Se non viene specificato uno di questi argomenti si riceverà un messaggio di avvertenza.
-g
(Obbligatorio) Specifica che il comando viene applicato a tutti i gruppi di esecuzione appartenenti al broker.
Nota: è necessario specificare -e o -g. Se non viene specificato uno di questi argomenti si riceverà un messaggio di avvertenza.
-j
(Obbligatorio) Specifica che il comando viene applicato a tutti i flussi di messaggi appartenenti al gruppo di esecuzione.
Nota:
  1. è necessario specificare -f o -j. Se non viene specificato uno di questi argomenti si riceverà un messaggio di avvertenza.
  2. Se viene impostata l'opzione -g per tutti i gruppi di esecuzione, è necessario utilizzare -j invece di -f.
-c control
(Facoltativo) Specifica il valore stringa che controlla il livello dell'azione da applicare alla raccolta di account e statistiche per istantanee o archiviazione. I valori possibili sono:
  • active - attiva istantanea o archiviazione
  • inactive - disattiva istantanea o archiviazione.
-t ThreadData
(Facoltativo) Specifica un valore stringa per modificare la raccolta di dati di statistiche del thread per un flusso di messaggi. I valori possibili sono:
  • none - esclude i dati correlati al thread dalle statistiche
  • basic - include i dati correlati al thread nelle statistiche.
-n NodeData
(Facoltativo) Specifica un valore stringa per modificare la raccolta di dati di statistiche del nodo per un flusso di messaggi. I valori possibili sono:
  • none - esclude i dati correlati al nodo dalle statistiche
  • basic - include i dati correlati al nodo nelle statistiche.
  • advanced - include i dati correlati al nodo e al terminale nelle statistiche.
-r
(Facoltativo) Specifica che è richiesta la reimpostazione di un dato di archivio.
Nota: questa azione è valida solo per dati di archivio.
Ciò provoca la cancellazione dei dati statistiche e account raccolti fino ad ora per questo intervallo e la raccolta viene riavviata da questo punto. Tutti i dati di archivio per tutti i flussi nel gruppo o nei gruppi di esecuzione vengono reimpostati.

Il timer dell'intervallo di archiviazione viene reimpostato solo se l'opzione -v (intervallo archiviazione statistiche) di mqsicreatebroker o mqsichangebroker è diverso da zero. Ossia, il timer dell'intervallo è impostato solo se viene utilizzato il meccanismo interno di notifica dell'intervallo e non un metodo esterno; come ad esempio, ENF su z/OS.

-b AccountingOrigin
(Facoltativo) Specifica che il percorso della struttura ad albero degli ambienti Broker.Accounting.Origin viene utilizzato per suddividere in partizioni la raccolta di statistiche in output distinti. I valori possibili sono:
  • none - non suddivide in partizioni le statistiche in base ai dati di origine di account
  • basic - suddivide in partizioni le statistiche in base ai dati di origine di account
-o OutputFormat
(Facoltativo) Specifica la destinazione dell'output per i prospetti statistiche. I valori possibili sono:
  • usertrace - questo è il valore predefinito e scrive messaggi "bip" su usertrace, che è possibile elaborare successivamente nel modo normale tramite i comandi mqsireadlog e mqsiformatlog
  • xml - i prospetti statistiche vengono generati come documenti XML e pubblicati dal broker eseguendo il flusso di messaggi.
    L'argomento sul quale i dati vengono pubblicati ha la seguente struttura:
    $SYS/Broker/<brokerName>/StatisticsAccounting/<recordType>/<executionGroupLabel>/<messageFlowLabel>
    dove recordType è impostato su Snapshot o Archive, e i nomi del broker, del gruppo di esecuzione e del flusso di messaggi sono specificati in base ai requisiti del sottoscrittore (subscriber).
  • smf - (solo per z/OS). I prospetti statistiche sono output come tipo di record 117 SMF.

Autorizzazione

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

Risposte

Questo comando restituisce le seguenti risposte:
  • BIP2226 Richiedere la modifica di un attributo nel nodo flusso di messaggi '': il flusso di messaggi non esiste
  • BIP8004 Indicatori e argomenti selezionati non validi
  • BIP8013 Il componente non esiste
  • BIP8020 Impossibile accedere al database
  • BIP8029 Broker non configurato
  • BIP8033 Impossibile inviare il messaggio XML
  • BIP8038 Opzione di comando non supportata
  • BIP8039 Gruppo di esecuzione non disponibile
  • BIP8040 Impossibile collegarsi al database

Esempi

Attiva statistiche di istantanea per il flusso di messaggi "myFlow1" in tutti i gruppi di esecuzione di BrokerA e specifica che i dati devono essere raccolti dall'origine di account:
mqsichangeflowstats BrokerA -s -g -j -b none   
Disattiva la raccolta delle statistiche di archivio per il flusso di messaggi "MyFlow1" nel gruppo di esecuzione "EGRP2" per BrokerA, allo stesso tempo modifica la granularità dei dati che devono essere raccolti (quando poi attivato) per includere i dati correlati al thread.
 mqsichangeflowstats BrokerA -a -e "EGRP2" -f MyFlow1 -c inactive -t basic   
Disattiva i dati di istantanea per tutti i flussi di messaggi in tutti i gruppi di esecuzione per il Broker A.
mqsichangeflowstats BrokerA -s -g -j -c inactive  
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
an11770_