endmqtrc

Den Trace für einige der oder alle Entitäten beenden, für die er durchgeführt wird.

Zweck

Verwenden Sie den Befehl endmqtrc , um die Traceerstellung für die angegebene Entität oder alle Entitäten zu beenden. Der Befehl endmqtrc beendet nur den Trace, der durch seine Parameter beschrieben wird. Die Verwendung von endmqtrc ohne Parameter beendet die Traceerstellung für alle Prozesse in einem frühen Stadium.

Achtung: Zwischen der Beendigung des Befehls endmqtrc und der tatsächlichen Beendigung aller Traceoperationen kann es zu einer leichten Verzögerung kommen. Dies liegt daran, dass IBM MQ -Prozesse auf ihre eigenen Tracedateien zugreifen. Da die einzelnen Prozesse zu unterschiedlichen Zeiten aktiv werden, werden ihre Tracedateien unabhängig voneinander geschlossen.

Syntax

The syntax of this command is as follows:

Optionale Parameter

-m QMgrName

Der Name des Warteschlangenmanagers, für den die Tracefunktion beendet werden soll. Dieser Parameter ist nur bei Serverprodukten gültig.

Der Name des Warteschlangenmanagers muss mit dem Namen des Warteschlangenmanagers genau übereinstimmen, der für den Befehl strmqtrc angegeben wurde. Wenn für den Befehl strmqtrc Platzhalterzeichen verwendet wurden, muss für den Befehl endmqtrc die gleiche Spezifikation mit Platzhalterzeichen verwendet werden. Dies umfasst auch die Verwendung von Escapezeichen für Platzhalterzeichen, um zu verhindern, dass sie von der Befehlsumgebung verarbeitet werden.

Maximal ein -m-Flag und der zugehörige Warteschlangenmanagername können im Befehl angegeben werden.

-i PidTids

Prozess-ID (PID) und Thread-ID (TID), für die die Tracefunktion beendet werden soll. Sie können das Flag -i nicht mit dem Flag -e verwenden. Wenn Sie versuchen, das Flag -i mit dem Flag -e zu verwenden, wird eine Fehlernachricht ausgegeben. Dieser Parameter darf nur unter Anleitung des IBM Service verwendet werden.

-p Apps

Die benannten Prozesse, für die die Tracefunktion beendet werden soll. Apps ist eine durch Kommas getrennte Liste. Sie müssen jeden Namen in der Liste genau so angeben, wie der Programmname im FDC-Header "Program Name" angezeigt wird. Ein Asterisk (*) oder Fragezeichen (?) sind als Platzhalterzeichen zulässig. Sie können das Flag -p nicht mit dem Flag -e verwenden. Wenn Sie versuchen, das Flag -p mit dem Flag -e zu verwenden, wird eine Fehlernachricht ausgegeben.

-e

Beendet die Tracefunktion für alle Prozesse in einem frühen Stadium.

Die Verwendung von endmqtrc ohne Parameter bewirkt das Gleiche wie endmqtrc -e. Es ist nicht möglich, das Flag '-e' mit dem Flag '-m', '-i' oder '-p' anzugeben.

-a

Beendet die gesamte Tracefunktion.

Dieses Flag muss alleine angegeben werden.

Rückkehrcodes

Rückkehrcode	Beschreibung
AMQ5611	Diese Nachricht wird ausgegeben, wenn ungültige Argumente für den Befehl angegeben wurden.
58	Inkonsistente Verwendung von Installationen erkannt

Beispiele

Mit diesem Befehl wird die Tracefunktion für Daten für einen Warteschlangenmanager namens QM1 beendet.

endmqtrc -m QM1

Die folgenden Beispiele sind eine Sequenz, die zeigt, wie der Befehl endmqtrc nur den Trace beendet, der durch seine Parameter beschrieben wird.

Mit dem folgenden Befehl wird die Tracefunktion für Warteschlangenmanager QM1 und Prozess amqxxx.exe aktiviert:
```
strmqtrc -m QM1 -p amqxxx.exe
```
Mit dem folgenden Befehl wird die Tracefunktion für Warteschlangenmanager QM2 aktiviert:
```
strmqtrc -m QM2
```
Mit dem folgenden Befehl wird die Tracefunktion nur für Warteschlangenmanager QM2 beendet. Für Warteschlangenmanager QM1 und Prozess amqxxx.exe bleibt die Tracefunktion aktiv:
```
endmqtrc -m QM2
```

Mit diesen Befehlen wird die Traceerstellung für alle Warteschlangenmanagerprozesse in allen CPUs gestoppt:

run -cpu=0 endmqtrc -a
...
run -cpu=15 endmqtrc -a

Weitere Befehle

Befehl	Beschreibung
dspmqtrc	Formatierte Traceausgabe anzeigen
strmqtrc	Trace starten