- -u
- (Nur für Benutzertrace erforderlich, wenn die Komponente ein Broker ist).
Gibt an, dass Benutzertraceoptionen geändert werden müssen.
Diese Option ist nur gültig, wenn Sie diesen Befehl für einen Broker, also nicht für einen Konfigurationsmanager oder Benutzernamensserver) ausgegeben haben.
- -e Ausführungsgruppe
- (Für Benutzertrace erforderlich; für Service-Trace optional)
Kennzeichnet die Ausführungsgruppe, für die Traceoptionen geändert (z. B. gestartet oder gestoppt) werden sollen. Diese Option kann nur für Broker angegeben werden.
Bei diesem Namen muss die Groß-/Kleinschreibung beachtet werden, und Sie müssen die Namen in einfache Anführungszeichen setzen, wenn sie sowohl Groß- als auch Kleinschreibung enthalten.
- -f MessageFlow
(Optional) Gibt die Nachrichtenfluss an, für die die Traceoptionen geändert werden sollen. Diese Option ist nur gültig, wenn eine Ausführungsgruppe (Flag -e) angegeben wurde.
Bei diesem Namen muss die Groß-/Kleinschreibung beachtet werden, und Sie müssen die Namen in einfache Anführungszeichen setzen, wenn sie sowohl Groß- als auch Kleinschreibung enthalten.
- -r
(Optional) Bei Angabe dieser Option wird das Traceprotokoll zurückgesetzt, d. h. alle aktuellen Datensätze werden gelöscht. Diese Option wird beim Start eines neuen Trace verwendet, damit alle Datensätze im Protokoll ausschließlich zu diesem neuen Trace gehören.
Diese Option ist nur gültig, wenn eine Ausführungsgruppe (Flag -e) angegeben wurde.
- -l Stufe
(Optional) Gibt die Tracestufe. Einer der folgenden Werte muss angegeben werden:
- normal. Es werden grundlegende Traceinformationen zurückgegeben.
- none. Die Tracefunktion wird inaktiviert.
- debug. Es werden umfassendere Traceinformationen zurückgegeben.
Dies ist für alle Komponenten gültig, die alle mit dem Standardwert none erstellt werden. Wenn Sie diesen Parameter nicht angeben, bleibt der aktuelle Wert unverändert. Wird dieser Wert erfolgreich geändert, ist diese neue Einstellung persistent.
- -m Modus
(Optional) Gibt an, wie die Traceinformationen gespeichert werden:
- safe. Die Traceeinträge werden in eine Datei geschrieben.
- fast. Die Traceeinträge werden in einen Puffer gestellt und im Stapelbetrieb in eine Datei geschrieben.
Bei der Erstellung jeder Komponente wird als Standardwert
safe gesetzt.
Wenn Sie diesen Parameter nicht angeben, bleibt der aktuelle Wert unverändert.
Diese Option ist nur zulässig, wenn die Komponente, die Sie angegeben haben, Folgendes ist:
- Ein Broker. Wenn dieser Wert geändert wird, hat dies Auswirkungen auf die eventuell angegebene Ausführungsgruppe oder die Agentenkomponente (wenn keine Ausführungsgruppe angegeben wurde).
- Der Benutzernamensserver. Wenn Sie diesen Wert ändern, hat dies Auswirkungen auf die Tracefunktion für die gesamte Komponente. Diese zweite Option ist nur für Service-Trace gültig und - wenn Sie diesen Wert erfolgreich geändert haben - persistent.
- -c Größe
(Optional) Die Größe der Tracedatei in KB.
Wenn Sie diesen Parameter nicht angeben, bleibt der aktuelle Wert unverändert.
Bei der Erstellung jeder Komponente wird ein Standardwert von 4096 KB gesetzt. Geben Sie diese Option an, wenn ein anderer Wert gesetzt werden soll. Der Maximalwert, den Sie angeben können, ist davon abhängig, wie das Protokoll anschließend mithilfe des Befehls
mqsireadlog gelesen werden soll:
- Wenn Sie diesen Befehl mit der festgelegten Option -f verwenden, wird die Protokolldatei direkt aus dem Dateisystem gelesen. In diesem Fall kann maximal der Wert 2097151 angegeben werden, wodurch eine Tracedatei von bis zu 2 GB (Gigabyte) erstellt werden kann.
- Wenn Sie diesen Befehl verwenden, ohne die Option -f festzulegen, wird eine WebSphere MQ-Nachricht an den Broker gesendet, um das Protokoll abzurufen. In diesem Fall darf die Tracedatei nur eine maximale Größe von 70 MB haben. Der Maximalwert, der von Ihnen festgelegt werden kann, ist 70000.
Unabhängig davon, wie die Tracedatei abgerufen wird, sollten Sie die Dateigröße möglichst gering halten, indem Sie entweder einen niedrigen Wert für diesen Parameter angeben oder die Option -r in diesem Befehl angeben, um das Traceprotokoll zu löschen. Der Vorteil bei dieser Methode besteht darin, dass der Formatierungsprozess (mqsiformatlog) viel schneller durchgeführt werden kann und zum Ausführen der zugehörigen Task weniger Ressourcen erforderlich sind.
Diese Option ist nur zulässig, wenn die Komponente, die Sie angegeben haben, Folgendes ist:
- Ein Broker. Wenn dieser Wert geändert wird, hat dies Auswirkungen auf die eventuell angegebene Ausführungsgruppe oder die Agentenkomponente (wenn keine Ausführungsgruppe angegeben wurde).
- Der Benutzernamensserver. Wenn Sie diesen Wert ändern, hat dies Auswirkungen auf die Tracefunktion für die gesamte Komponente. Diese zweite Option ist nur für Service-Trace gültig.