WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

Befehl 'mqsichangeflowstats' - Windows-, Linux- und UNIX-Systeme

Verwenden Sie den Befehl mqsichangeflowstats auf Windows-, Linux- und UNIX-Systemen, um die Akkumulation von Statistikdaten zum Nachrichtenflussbetrieb zu steuern.

Syntax

Syntaxdiagramm lesenSyntaxdiagramm überspringen
>>-mqsichangeflowstats--Brokername --+- -a +-------------------->
                                     '- -s-'   

                                                         (1)   
>--+- -e--Ausführungsgruppe--+- -f--Nachrichtenfluss-+-+-------->
   |                         '- -j-------------------' |       
   '- -g-- -j------------------------------------------'       

>--+--------------------------+--+----------------+------------->
   '- -b--Abrechnungsursprung-'  '- -c--Steuerung-'   

>--+---------------------+--+------------------+---------------->
   '- -k -Anwendungsname-'  '- -n--Knotendaten-'   

>--+--------------------+--+-----+--+------------------+-------->
   '- -o--Ausgabeformat-'  '- -r '  '- -t--Threaddaten-'   

>--+----------------------+------------------------------------><
   '- -y -Bibliotheksname-'   

Anmerkungen:
  1. Informationen zu gültigen Kombinationen der Parameter e,f, g und j finden Sie in den Parameterbeschreibungen.

Parameter

Brokername
(Erforderlich) Gibt die Bezeichnung des Brokers an, für den die Abrechnungs- und Statistikoptionen geändert werden sollen.
-a
(Erforderlich) Gibt an, dass die Abrechnungs- und Statistikerfassung für die Archivierung geändert werden soll.

Sie müssen -a oder -s angeben. Wird keines dieser Attribute angegeben, wird eine Warnung ausgegeben.

-b Abrechnungsursprung
(Optional) Gibt an, dass der Umgebungsstrukturpfad Broker.Accounting.Origin für die Partitionierung der erfassten Statistikdaten in verschiedene Ausgabedateien verwendet wird. Gültige Werte sind:
  • none - Die Statistikdaten werden nicht entsprechend des Ursprungs der Abrechnungsdaten partitioniert.
  • basic - Die Statistikdaten werden entsprechend des Ursprungs der Abrechnungsdaten partitioniert.
-c Steuerung
(Optional) Gibt den Zeichenfolgewert an, der die Aktion bezüglich der Abrechnungs- und Statistikerfassung für die Momentaufnahme oder die Archivierung festlegt. Gültige Werte sind:
  • active - Momentaufnahme oder Archivierung wird aktiviert
  • inactive - Momentaufnahme oder Archivierung wird inaktiviert.
-e Ausführungsgruppe
(Erforderlich) Gibt den Namen der Ausführungsgruppe an, für die Berechnungs- und Statistikoptionen geändert werden sollen.

Sie müssen -e oder -g angeben. Wird keines dieser Attribute angegeben, wird eine Warnung ausgegeben.

-f Nachrichtenfluss
(Erforderlich) Gibt den Namen des Nachrichtenflusses an, für den die Abrechnungs- und Statistikoptionen geändert werden sollen.

Sie müssen -f oder -j angeben. Wird keines dieser Attribute angegeben, wird eine Warnung ausgegeben.

-g
(Erforderlich) Gibt an, dass der Befehl für alle Ausführungsgruppen des Brokers ausgeführt werden soll.

Sie müssen -e oder -g angeben. Wird keines dieser Attribute angegeben, wird eine Warnung ausgegeben.

-j
(Erforderlich) Gibt an, dass der Befehl für alle Nachrichtenflüsse der Ausführungsgruppe ausgeführt werden soll.

Sie müssen -f oder -j angeben. Wird keines dieser Attribute angegeben, wird eine Warnung ausgegeben.

Anmerkung: Wenn Sie die Option -g für alle Ausführungsgruppen setzen, müssen Sie -j anstatt -f angeben.
-k Anwendungsname
(Optional) Dieser Parameter gibt den Namen der Anwendung an, die den Nachrichtenfluss enthält, für den Statistikdaten erfasst werden.

Wenn Sie diesen Parameter setzen, müssen Sie auch entweder den Parameter -f (Nachrichtenfluss) oder den Parameter -j (alle Nachrichtenflüsse) angeben. Um Statistikdaten für einen benannten Nachrichtenfluss in einer bestimmten Anwendung zu erfassen, müssen Sie die Parameter -k und -f angeben. Um Statistikdaten für alle Nachrichtenflüsse in einer Anwendung zu erfassen, müssen Sie die Parameter -k und -j angeben.

Sie können diesen Parameter zusammen mit dem Parameter -y (Bibliotheksname) verwenden, um anzugeben, dass der Nachrichtenfluss in einer Bibliothek enthalten ist, auf die von der Anwendung verwiesen wird.

-n Knotendaten
(Optional) Gibt einen Zeichenfolgewert an, um die Erfassung von knotenspezifischen Daten für einen Nachrichtenfluss zu ändern. Gültige Werte sind:
  • none - Es werden keine knotenspezifischen Daten für die Statistik erfasst.
  • basic - Es werden knotenspezifische Daten für die Statistik erfasst.
  • advanced - Es werden knoten- und terminalspezifische Daten für die Statistik erfasst.
-o Ausgabeformat
(Optional) Gibt die Zieladresse für die Ausgabe der Statistikberichte an. Folgende Werte sind möglich:
  • usertrace - (Standard) BIP-Nachrichten werden in den Benutzertrace geschrieben, der anschließend unter Verwendung der Befehle mqsireadlog und mqsiformatlog auf normalem Weg verarbeitet werden kann.
  • xml - Die Statistikberichte werden als XML-Dokumente erstellt und von dem Broker veröffentlicht, in dem die Nachrichtenflüsse ausgeführt werden.
    Das Thema, in dem die Daten veröffentlicht werden, hat die folgende Struktur:
    $SYS/Broker/<brokerName>/StatisticsAccounting/<recordType>
    /<executionGroupLabel>/<messageFlowLabel>
    Dabei wird recordType auf Snapshot oder Archive gesetzt und es werden entsprechend den Anforderungen des Subskribenten die Namen des Brokers, der Ausführungsgruppe und des Nachrichtenflusses angegeben.
-r
(Optional) Dieser Parameter gilt nur für Archivdaten und gibt an, dass diese zurückgesetzt werden sollen.

Bei Angabe dieser Option werden die innerhalb dieses Intervalls bereits erfassten Abrechnungs- und Statistikdaten gelöscht und die Erfassung ab diesem Zeitpunkt neu gestartet. Alle Archivierungsdaten für alle Nachrichtenflüsse der Ausführungsgruppe(n) werden zurückgesetzt.

Der Intervallzeitgeber für die Archivierung wird nur zurückgesetzt, wenn für die Option -v (statistics archive interval) des Befehls mqsicreatebroker oder mqsichangebroker ein Wert ungleich null angegeben wird.

Das bedeutet, dass der Intervallzeitgeber nur festgelegt wird, wenn der interne Mechanismus zur Benachrichtigung verwendet wird, und nicht eine externe Methode.

-s
(Erforderlich) Gibt an, dass die Abrechnungs- und Statistikerfassung für die Momentaufnahme geändert werden soll.

Sie müssen -a oder -s angeben. Wird keines dieser Attribute angegeben, wird eine Warnung ausgegeben.

-t Threaddaten
(Optional) Gibt einen Zeichenfolgewert an, um die Erfassung von Threadstatistikdaten für einen Nachrichtenfluss zu ändern. Mögliche Werte:
  • none - Es werden keine threadspezifischen Daten für die Statistik erfasst.
  • basic - Es werden threadspezifische Daten für die Statistik erfasst.
-y Bibliotheksname
(Optional) Dieser Parameter gibt den Namen der Bibliothek an, die den Nachrichtenfluss enthält, für den Statistikdaten erfasst werden.

Wenn Sie diesen Parameter setzen, müssen Sie auch entweder den Parameter -f (Nachrichtenfluss) oder den Parameter -j (alle Nachrichtenflüsse) angeben. Um Statistikdaten für einen benannten Nachrichtenfluss in einer bestimmten Bibliothek zu erfassen, müssen Sie die Parameter -k und -f angeben. Um Statistikdaten für alle Nachrichtenflüsse in einer Bibliothek zu erfassen, müssen Sie die Parameter -k und -j angeben.

Beispiele

Aktivieren Sie die Erfassung von Statistikdaten für die Momentaufnahme für den Nachrichtenfluss "myFlow1" in allen Ausführungsgruppen von BrokerA und geben Sie an, dass die Statistikdaten nicht gemäß den ursprünglichen Abrechnungsdaten untergliedert werden:
mqsichangeflowstats BrokerA -s -g -j -b none -c active  
Inaktivieren Sie die Erfassung von Statistikdaten für die Archivierung für Nachrichtenfluss "MyFlow1" in Ausführungsgruppe "EGRP2" für Broker "BrokerA", und geben Sie an, dass (bei der nächsten Aktivierung) zusätzlich noch threadspezifische Daten erfasst werden sollen:
mqsichangeflowstats BrokerA -a -e EGRP2 -f MyFlow1 -c inactive -t basic   
Inaktivieren Sie die Daten für die Momentaufnahme für alle Nachrichtenflüsse in allen Ausführungsgruppen von Broker A:
mqsichangeflowstats BrokerA -s -g -j -c inactive  
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:21:50


ReferenzthemaReferenzthema | Version 8.0.0.5 | an28420_