Befehl 'mqsireporttrace'

Unterstützte Plattformen

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

Zweck

Mit dem Befehl mqsireporttrace werden aktuellen Traceoptionen angezeigt. Dieser Befehl wird für die folgenden Tracefunktionen verwendet:
  • Benutzertrace (Option -u).

    Unter z/OS wird der Trace für eine bestimmte Ausführungsgruppe eines Brokers durchgeführt. Sie können mit diesem Befehl den Trace sogar auf einen einzelnen Nachrichtenfluss einschränken.

  • Servicetrace (Option -t). Diese Option sollte nur angegeben werden, wenn Sie in einer BIPxxxx-Nachricht oder vom IBM Support Center dazu aufgefordert werden.

    Unter z/OS kann der Servicetrace (wie der Benutzertrace) für eine einzelne Ausführungsgruppe durchgeführt werden. Anders als beim Benutzertrace kann der Servicetrace aber auch für einen aktiven Agenten (also einen Broker oder Benutzernamensserver) durchgeführt werden.

Broker oder Brokerressourcen (Ausführungsgruppe oder Nachrichtenfluss), die angegeben werden, müssen eingesetzt worden sein, bevor die Traceeinstellungen abgefragt werden können.

Syntax

Windows-Plattformen, Linux- und UNIX-Systeme

Benutzertrace

Servicetrace

z/OS

Benutzertrace

Servicetrace

Parameter

component
(Erforderlich - Windows-Plattformen sowie Linux- und UNIX-Systeme) Name des Brokers, für den Optionen zurückgemeldet wurden, oder der feste Wert UserNameServer. Auf Linux- und UNIX-Systemen muss bei beiden Angaben die Groß-/Kleinschreibung beachtet werden.
-u
(Für Benutzertrace erforderlich) Berichtsdaten werden aus dem Benutzertrace abgeleitet.
-e egroup
(Für Benutzertrace erforderlich, sonst optional) Die Bezeichnung der Ausführungsgruppe, für die ein Bericht angefordert wird. Diese Option ist nur zulässig, wenn als Komponente ein Broker angegeben wurde.

Unter z/OS muss bei der Angabe dieses Namens die Groß-/Kleinschreibung beachtet werden. Enthält er Groß- und Kleinbuchstaben, muss er in einfache Anführungszeichen gesetzt werden.

-f mflow
(Optional) Die Bezeichnung des Nachrichtenflusses, für den ein Bericht angefordert wird. Diese Option ist nur zulässig, wenn Sie einen Broker als Komponente und eine Ausführungsgruppe angegeben haben.

Unter z/OS muss bei der Angabe dieses Namens die Groß-/Kleinschreibung beachtet werden. Enthält er Groß- und Kleinbuchstaben, muss er in einfache Anführungszeichen gesetzt werden.

Zusätzliche Parameter für den Servicetrace

Diese Optionen sollten nur verwendet werden, wenn Sie vom IBM Support Center oder in einer BIPxxxx-Nachricht dazu aufgefordert werden.

-t
(Für Servicetrace erforderlich) Berichtsdaten werden aus dem Servicetrace abgeleitet.
-b
(Alternativ zu -e auf allen Plattformen) Fordert einen Bericht für die agent-Funktion an.

Berechtigung

Die Benutzer-ID, unter der der Befehl eingegeben wird, muss die Berechtigung mqbrkrs haben.

Antworten

  • BIP8002 Ausgewählte Optionen nicht kompatibel (nur unter z/OS)
  • BIP8003 Doppelte Option festgestellt (nur unter z/OS)
  • BIP8013 Komponente nicht vorhanden
  • BIP8020 Auf die Datenbank kann nicht zugegriffen werden
  • BIP8029 Broker nicht konfiguriert
  • BIP8032 Verbindung zu Warteschlange konnte nicht hergestellt werden (nur Windows-, Linux- und UNIX-Plattformen)
  • BIP8033 XML-Nachricht konnte nicht gesendet werden
  • BIP8035 Antwort wurde erst nach Ablauf der Zeitlimitüberschreitung empfangen
  • BIP8036 Negative Antwort empfangen
  • BIP8037 Eine nicht unterstützte Option wurde ausgewählt
  • BIP8038 Nicht unterstützte Befehlsoption
  • BIP8039 Ausführungsgruppe nicht verfügbar
  • BIP8040 Es kann keine Verbindung zur Datenbank hergestellt werden
  • BIP8045 Nachrichtenfluss wurde nicht gefunden
  • BIP8158 Ungültiges Befehlsformat (nur unter z/OS)
  • BIP8159 Unbekannter Parameter "..." (nur z/OS)

Beispiele

Windows-Plattformen, Linux- und UNIX-Systeme:
mqsireporttrace BrokerA -t -e "exgrp1"
z/OS:
F MQP1BRK,reporttrace t=yes,e='exgrp1'
Zugehörige Tasks
Die Tracefunktion verwenden
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
an07310_