Befehl 'mqsichangeflowstats'

Unterstützte Plattformen

  • Windows
  • Linux- und UNIX-Systeme
  • z/OS

Zweck

Verwenden Sie den Befehl mqsichangeflowstats für folgende Aktionen:
  • Zum Aktivieren oder Inaktivieren von Veröffentlichungen der Momentaufnahme von Berechnungen und Statistiken oder zum Archivieren der Ausgabe von Einträgen.
  • Zur Angabe, dass der Befehl für einen bestimmten Nachrichtenfluss, für alle Nachrichtenflüsse in einer Ausführungsgruppe oder für alle Ausführungsgruppen eines Brokers angewendet wird.
  • Zum Ändern der Unterteilung der zusätzlich zum Standardnachrichtenfluss erfassten Daten von Berechnungen und Statistiken. In diesen zusätzlichen Daten können Daten zu Threads, Knoten, Knotenterminals oder eine Verbindung dieser Daten enthalten sein.

Die zur Verwendung dieses Befehls festgelegten Optionen bleiben aktiv, bis sie durch einen nachfolgenden mqsichangeflowstats-Befehl geändert werden.

Syntax

Windows-Plattformen, Linux- und UNIX-Systeme

z/OS

Synonym cs

Parameter

Brokername
(Erforderlich auf Windows- und UNIX-Plattformen) Gibt die Kennung des Brokers an, für den Berechnungen und Statistiken geändert werden sollen.
-a
(Erforderlich) Gibt an, dass durch den Befehl Archivierungsberechnungen und Statistikerfassungen geändert werden.
Anmerkung: Geben Sie -a oder -s an. Wenn Sie keines dieser Argumente angeben, wird eine Warnung ausgegeben.
-s
(Erforderlich) Gibt an, dass durch den Befehl Berechnungen der Momentaufnahmen und Statistikerfassungen geändert werden.
Anmerkung: Geben Sie -a oder -s an. Wenn Sie keines dieser Argumente angeben, wird eine Warnung ausgegeben.
-e Ausführungsgruppe
(Erforderlich) Gibt den Namen der Ausführungsgruppe an, für die Berechnungs- und Statistikoptionen geändert werden sollen.
Anmerkung: Geben Sie -e oder -g an. Wenn Sie keines dieser Argumente angeben, wird eine Warnung ausgegeben.
-f Nachrichtenfluss
(Erforderlich) Gibt die Kennung des Nachrichtenflusses an, für den Berechnungs- und Statistikoptionen geändert werden sollen.
Anmerkung: Geben Sie -f oder -j an. Wenn Sie keines dieser Argumente angeben, wird eine Warnung ausgegeben.
-g
(Erforderlich) Gibt an, dass der Befehl für alle Ausführungsgruppen des Brokers ausgeführt wird.
Anmerkung: Geben Sie -e oder -g an. Wenn Sie keines dieser Argumente angeben, wird eine Warnung ausgegeben.
-j
(Erforderlich) Gibt an, dass der Befehl für alle Nachrichtenflüsse der Ausführungsgruppe ausgeführt wird.
Anmerkung:
  1. Geben Sie -f oder -j an. Wenn Sie keines dieser Argumente angeben, wird eine Warnung ausgegeben.
  2. Wenn Sie die Option -g für alle Ausführungsgruppen festlegen, müssen Sie anstelle von -f die Option -j verwenden.
-c Steuerung
(Optional) Gibt den Zeichenfolgewert an, der die Stufe der Aktion steuert, die für die Erfassung der Berechnungen und Statistiken für Momentaufnahmen oder Archivierung angewendet wird. Folgende Werte sind möglich:
  • active - Momentaufnahmen oder Archivierung wird aktiviert
  • inactive - Momentaufnahmen oder Archivierung wird inaktiviert
-t Threaddaten
(Optional) Gibt einen Zeichenfolgewert an, der die Erfassung von statistischen Daten der Threads für einen Nachrichtenfluss ändert. Folgende Werte sind möglich:
  • none - Es werden keine threadspezifischen Daten für die Statistik erfasst
  • basic - Es werden threadspezifische Daten für die Statistik erfasst
-n Knotendaten
(Optional) Gibt einen Zeichenfolgewert an, der die Erfassung von Daten zur Knotenstatistik für einen Nachrichtenfluss ändert. Folgende Werte sind möglich:
  • 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
-r
(Optional) Gibt an, dass das Zurücksetzen der Archivdaten erforderlich ist.
Anmerkung: Diese Aktion ist nur für Archivdaten gültig.
Dadurch wird das Löschen der Berechnungs- und Statistikdaten verursacht, die bisher für dieses Intervall erfasst wurden. Die Daten werden von diesem Punkt ab erneut erfasst. Sämtliche Archivdaten für alle Nachrichtenflüsse in der Ausführungsgruppe (oder in mehreren Ausführungsgruppen) werden zurückgesetzt.

Der Intervallzeitgeber des Archivs wird nur zurückgesetzt, wenn die Option -v (Statistikarchivintervall) von mqsicreatebroker oder mqsichangebroker nicht null ist. Das bedeutet, dass der Intervallzeitgeber nur festgelegt wird, wenn der interne Mechanismus zur Benachrichtigung verwendet wird, und nicht eine externe Methode wie beispielsweise ENF unter z/OS.

-b Account-Ursprung
Dieser Parameter hat keine Auswirkungen.
-o Ausgabeformat
(Optional) Gibt die Zieladresse der Ausgabe von Statistikberichten an. Folgende Werte sind möglich:
  • Benutzertrace - Dies ist die Standardeinstellung, durch die BIP-Nachrichten in den Benutzertrace geschrieben werden. Dieser kann auf normale Weise mit Hilfe der Befehle mqsireadlog und mqsiformatlog nachbearbeitet werden.
  • XML - Die Statistikberichte werden als XML-Dokumente generiert und durch den Broker veröffentlicht, der den Nachrichtenfluss ausführt.
    Das Thema, auf dem die Daten veröffentlicht werden, hat folgende Struktur:
    $SYS/Broker/<brokerName>/StatisticsAccounting/<recordType>/<executionGroupLabel>/<messageFlowLabel>
    Dabei wird 'Datensatztyp' auf Momentaufnahme oder Archivierung gesetzt, und Broker, Ausführungsgruppe und Nachrichtenfluss werden gemäß den Anforderungen des Subskribenten angegeben.
  • SMF - (nur z/OS). Statistikberichte werden als Einträge vom SMF-Typ 117 ausgegeben.

Autorisierung

Die Benutzer-ID, die zur Ausgabe des Befehls verwendet wird, muss über die Berechtigung 'mqbrkrs' verfügen.

Antworten

Dieser Befehl gibt die folgenden Antworten zurück:
  • BIP2226 Änderungsanforderung für Attribut im Nachrichtenflussknoten ' ': Nachrichtenfluss ist nicht vorhanden
  • BIP8004 Ungültige Optionen und Argumente ausgewählt
  • BIP8013 Komponente nicht vorhanden
  • BIP8020 Zugriff auf Datenbank nicht möglich
  • BIP8029 Broker nicht konfiguriert
  • BIP8033 XML-Nachricht konnte nicht gesendet werden
  • BIP8038 Nicht unterstützte Befehlsoption
  • BIP8039 Ausführungsgruppe nicht verfügbar
  • BIP8040 Es konnte keine Verbindung zu der Datenbank hergestellt werden

Beispiele

Aktivieren Sie die Statistik der Momentaufnahme für den Nachrichtenfluss "myFlow1" in allen Ausführungsgruppen auf BrokerA, und geben Sie an, dass die Daten nach dem Account-Ursprung zusammengestellt werden sollen:
mqsichangeflowstats BrokerA -s -g -j -b none   
Inaktivieren Sie die Erfassung der Archivstatistiken für den Nachrichtenfluss "MyFlow1" in der Ausführungsgruppe "EGRP2" für BrokerA, und ändern Sie gleichzeitig die Unterteilung der Daten, die bei der nächsten Aktivierung erfasst werden sollen, damit auch Threaddaten eingeschlossen werden.
mqsichangeflowstats BrokerA -a -e "EGRP2" -f MyFlow1 -c inactive -t basic   
Inaktivieren Sie die Daten der Momentaufnahme für alle Nachrichtenflüsse in allen Ausführungsgruppen für Broker A.
mqsichangeflowstats BrokerA -s -g -j -c inactive  
Zugehörige Konzepte
Nachrichtenflüsse - Übersicht
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 18.05.2006
an11770_