Befehl 'mqsichangetrace'

Unterstützte Plattformen

  • Windows
  • Linux- und UNIX-Systeme
  • z/OS - als ein Konsolbefehl

Zweck

Mit dem Befehl mqsichangetrace werden die Traceeigenschaften für eine Komponente gesetzt. Dieser Befehl wird für die folgenden Tracefunktionen verwendet:
  • Benutzertrace (Option -u).
  • Servicetrace (Option -t). Diese Option sollte nur angegeben werden, wenn Sie in einer BIPxxxx-Nachricht oder vom IBM Support Center dazu aufgefordert werden.
  • Trace-Knoten. Geben Sie die Option -n an, um Trace-Knoten ein- oder auszuschalten. Sie können die Leistung eines Flusses durch die Inaktivierung von Trace-Knoten deutlich verbessern.

Sie können die Benutzertracefunktion für einen Broker, einen Konfigurationsmanager oder den Benutzernamensserver (gekennzeichnet durch den Komponentennamen) einleiten, ändern oder beenden. Sie können Trace-Knoten für einen Broker ein- und ausschalten. Die Benutzertracefunktion für die Workbench kann mit diesem Befehl nicht eingeleitet werden.

Es können nur Broker oder Brokerressourcen (Ausführungsgruppen oder Nachrichtenfluss) angegeben werden, die vor dem Trace eingesetzt wurden.

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 mqsireadlog, um das Protokoll als Datei im Format XML abzurufen. Verwenden Sie zum Anzeigen der XML-Einträge mqsiformatlog (um eine formatierte Datei herzustellen) oder einen XML-Browser.

Wenn die Tracefunktion aktiviert wird, werden für sämtlichen Aktivitäten der überwachten Komponente zusätzliche Prozesse angestoßen. Eine aktivierte Tracefunktion kann sich also auf die Systemleistung auswirken.

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.

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.

Sie können auch die Traceaktivität der Ausführungsgruppen und Nachrichtenflüsse mit Hilfe der Workbench-Funktionen starten und stoppen. Weitere Informationen hierzu finden Sie unter Benutzertrace.

Wählen Sie den entsprechenden Link für Details zu diesem Befehl für die Plattform(en) aus, die in Ihrem Unternehmen verwendet wird (werden):

Berechtigung

Unter Windows-, Linux- und UNIX-Systemen muss die Benutzer-ID, unter der der Befehl eingegeben wird, die Berechtigung mqbrkrs haben.

Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
an07260_