Mit dem Befehl mqsichangetrace werden die Traceeigenschaften für einen Broker festgelegt.
Sie können die Benutzertracefunktion (oder Service-Tracefunktion) für einen Broker einleiten, ändern oder beenden.
Die Trace-Knoten können für einen Broker ein- und ausgeschaltet werden, der Service-Trace für die WebSphere Message Broker Toolkit kann mit diesem Befehl jedoch nicht eingeleitet werden.
Es können nur Broker oder Brokerressourcen (Ausführungsgruppen oder Nachrichtenfluss) angegeben werden, die vor dem Trace implementiert wurden. Falls Sie den Benutzertrace mit dem Befehl mqsichangetrace starten oder stoppen möchten, müssen Sie sich vergewissern, dass der Broker aktiv ist. Im Fall des Service-Trace ist die Aktivierung oder Inaktivierung des Trace mit dem Befehl mqsichangetrace auch möglich, wenn der Broker beendet wurde. Auf diese Weise kann der Start der Brokerkomponenten über einen Trace verfolgt werden.
Die durch diese Befehle generierte Ausgabe für Service und Benutzertrace wird im Unterverzeichnis log in die Tracedateien geschrieben. Nach Beendigung der Arbeit, für die Sie einen Trace durchführen möchten, verwenden Sie den Befehl mqsireadlog, um das Protokoll als Datei im Format XML abzurufen. Verwenden Sie zum Anzeigen der XML-Einträge den Befehl mqsiformatlog (um eine formatierte Datei herzustellen) oder einen XML-Browser.
Wenn die Tracefunktion aktiviert wird, werden für sämtlichen Aktivitäten des überwachten Brokers zusätzliche Prozesse angestoßen. Wenn der Trace aktiv ist, wird die Leistung vermutlich beeinträchtigt.
Wenn Sie für den ausführbaren Befehl selbst einen Trace ausführen möchten, legen Sie vor dem Einleiten der Tracefunktion die Umgebungsvariablen MQSI_UTILITY_TRACE und MQSI_UTILITY_TRACESIZE fest.
Je nachdem, ob Sie einen normalen oder einen Debug-Trace erstellen möchten, können Sie MQSI_UTILITY_TRACE auf normal oder debug setzen. MQSI_UTILITY_TRACESIZE sollten Sie auf die maximal erforderliche Größe der Tracedatei in Kilobyte (KB) setzen. Der Standardwert ist 102400 (100 MB).
Stellen Sie sicher, dass nach Abschluss des Trace für den betreffenden Befehl diese Variablen wieder zurückgesetzt werden. Andernfalls wird für alle in Folge eingegebenen Befehle ebenfalls ein Trace durchgeführt, was deren Ausführungszeit beeinträchtigt. Weitere Informationen zu MQSI_UTILITY_TRACE und MQSI_UTILITY_TRACESIZE finden Sie im Abschnitt Service-Trace starten.
Sie können auch die Traceaktivität der Ausführungsgruppen und Nachrichtenflüsse mithilfe der WebSphere Message Broker Toolkit-Funktionen starten und stoppen. Weitere Informationen hierzu finden Sie unter Benutzertrace.
Mit dem Befehl mqsireporttrace können Sie die derzeit aktivierten Traceoptionen anzeigen.