Beim Erfassen von statistischen Daten für Nachrichtenflüsse können Sie das Ausgabeziel für die
Daten auswählen.
Wählen Sie eine der folgenden Zieladressen aus:
Wenn Sie die Erfassung der Statistikdaten über die Webbenutzerschnittstelle oder den WebSphere Message
Broker Explorer stoppen, werden
alle Ausgabeformate inaktiviert. Wenn Sie die Erfassung der Statistikdaten anschließend erneut mit dem Befehl
mqsichangeflowstats starten, wird das Ausgabeformat auf den Standardwert user
trace (Benutzertrace) zurückgesetzt, sofern keine anderen Ausgabeformate in dem Befehl angegeben sind. Wenn Sie die Erfassung der
Statistikdaten hingegen über den WebSphere Message
Broker Explorer bzw. die Webbenutzerschnittstelle erneut starten, werden die erfassten
Daten entsprechend im XML-Format bzw. im JSON-Format ausgegeben.
Statistische Daten werden in folgenden Situationen in die angegebenen Ausgabeziele geschrieben:
- Das Archivdatenintervall läuft ab.
- Das Momentaufnahmeintervall läuft ab.
- Der Broker wird heruntergefahren. Alle Daten, die vom Broker erfasst, aber noch nicht in das Ausgabeziel geschrieben wurden, werden beim Herunterfahren geschrieben. Deshalb kann es sich um
Daten eines unvollständigen Intervalls handeln.
- Eine Komponente der Brokerkonfiguration wird erneut eingesetzt. Nach einer erneuten Implementierung
können Konfigurationsdaten eine aktualisierte Konfiguration enthalten, die mit der bestehenden
Satzstruktur nicht konsistent ist (z. B. kann ein Nachrichtenfluss einen zusätzlichen Knoten oder
eine Ausführungsgruppe einen neuen Nachrichtenfluss enthalten). Deshalb werden die aktuellen Daten,
die sich möglicherweise auf ein unvollständiges Intervall beziehen, in das Ausgabeziel geschrieben.
Die Datenerfassung wird für die erneut eingesetzte Konfiguration fortgesetzt, bis Sie die Parameter
für die Datenerfassung ändern oder die Datenerfassung stoppen.
- Datenerfassungsparameter werden geändert. Wenn Sie die Parameter, die Sie für die Datenerfassung festgelegt haben, ändern, werden alle für den Nachrichtenfluss (oder die Nachrichtenflüsse) erfassten Daten in das Ausgabeziel geschrieben, um die Datenintegrität zu bewahren. Die Statistikerfassung wird gemäß den neuen Parametern erneut gestartet.
- Die Datenerfassung wird aufgrund eines Fehlers beendet. In diesem Fall müssen Sie die
Datenerfassung selbst erneut starten.
Benutzertrace
Sie können angeben, dass die erfassten Daten in das Benutzertraceprotokoll geschrieben werden. Die Daten werden auch dann geschrieben, wenn die Tracefunktion ausgeschaltet ist.
Wenn für die
Berechnungs- und Statistikdaten kein Ausgabeziel angegeben ist, werden die Daten standardmäßig in das Benutzertraceprotokoll ausgegeben.
Die Daten werden in eines der folgenden Verzeichnisse geschrieben:
Windows
- Wenn Sie den Arbeitspfad mithilfe des Parameters -w im Befehl
mqsicreatebroker festlegen, befinden sich die Protokolle unter workpath\common\log.
- Wenn Sie den Brokerarbeitspfad nicht angegeben haben, wird folgende
Position verwendet:
- Unter Windows:%ALLUSERSPROFILE%\Application
Data\IBM\MQSI\common\log, wobei %ALLUSERSPROFILE% die Umgebungsvariable
ist, die das Systemarbeitsverzeichnis definiert.
Das Standardverzeichnis ist vom Betriebssystem abhängig.
- Unter Windows XP and Windows Server 2003: C:\Dokumente
und Einstellungen\All Users\IBM\MQSI\common\log
- Unter Windows Vista, Windows 7 und Windows Server 2008: C:\ProgramData\IBM\MQSI\common\log
Da
auf Ihrem Computer möglicherweise nicht das Standardverzeichnis verwendet wird, sollten Sie %ALLUSERSPROFILE% angeben, um
sicherzustellen, dass Sie auf das korrekte Verzeichnis zugreifen.

Linux und UNIX
- /var/mqsi/common/log
z/OS
- /component_filesystem/log
XML-Veröffentlichung
Sie können angeben, dass die erfassten Daten im XML-Format veröffentlicht werden und Subskribenten, die im Brokernetz registriert sind und das richtige Thema subskribiert haben, zur Verfügung stehen.
Das Thema, für das
die Daten veröffentlicht werden, hat folgende Struktur:
$SYS/Broker/Brokername/StatisticsAccounting/Datensatztyp/executionGroupLabel/messageFlowLabel
Die Variablen entsprechen den folgenden Werten:
- Brokername
- Der Name des Brokers, für den Statistikdaten erfasst werden.
- Datensatztyp
- Wird je nach Datentyp, den Sie subskribieren, auf SnapShot (Momentaufnahme) oder Archive (Archiv) gesetzt. Alternativ können Sie sich mit # für Momentaufnahmedaten und für Archivdaten eintragen, wenn sie erzeugt werden. Bei diesem Wert wird die Groß-/Kleinschreibung berücksichtigt; er muss daher wie folgt eingegeben werden: SnapShot.
- executionGroupLabel
- Der Name der Ausführungsgruppe, für die Statistikdaten erfasst werden.
- messageFlowLabel
- Die Bezeichnung auf dem Nachrichtenfluss, für den Statistikdaten erfasst werden.
Subskribenten
können Filterausdrücke einfügen, um die Veröffentlichungen, die sie empfangen, zu begrenzen. Beispielsweise können sie festlegen, dass sie nur Momentaufnahmedaten oder für einen einzelnen Broker erfasste Daten erhalten. Subskribenten können Platzhalterzeichen (+ und #) angeben, um Veröffentlichungen zu erhalten, die auf mehrere Ressourcen verweisen.
Die folgenden Beispiele zeigen das Thema, für das sich ein Subskribent einträgt, wenn er verschiedene Datensorten erhalten möchte:
- Tragen Sie das folgende Thema ein, damit der Subskribent Daten für alle Nachrichtenflüsse erhält, die auf BrokerA ausgeführt werden:
$SYS/Broker/BrokerA/StatisticsAccounting/#
- Tragen Sie das folgende Thema ein, damit der Subskribent nur archivierte Statistikdaten zu einem Nachrichtenfluss namens Flow1 erhält, der in der Ausführungsgruppe Execution auf dem Broker BrokerA ausgeführt wird:
$SYS/Broker/BrokerA/StatisticsAccounting/Archive/Execution/Flow1
- Tragen Sie das folgende Thema ein, damit der Subskribent sowohl Momentaufnahmedaten als auch Archivdaten zum Nachrichtenfluss Flow1 erhält, der in der Ausführungsgruppe Execution auf dem Broker BrokerA ausgeführt wird:
$SYS/Broker/BrokerA/StatisticsAccounting/+/Execution/Flow1
Hilfe zum Eintragen eines Subskribenten finden Sie im Abschnitt SupportPac
(IH03) mit Dienstprogrammen zur Nachrichtenanzeige, zum Testen und zur
Leistungsmessung.
SMF
Unter z/OS können Sie
angeben, dass die erfassten Daten in SMF geschrieben werden. Abrechnungs- und
Statistikdaten liegen in Datensätzen des SMF-Typs 117 vor. SMF unterstützt die Erfassung von Daten von mehreren Subsystemen, was Ihnen die Möglichkeit gibt, die von verschiedenen Quellen aufgezeichneten Informationen zu synchronisieren.
Zum Auswerten der aufgezeichneten Informationen können Sie jedes Dienstprogramm verwenden, dass SMF-Datensätze verarbeitet.