Befehl 'mqsistopmsgflow'

Unterstützte Plattformen

Zweck

Mit dem Befehl mqsistopmsgflow können Sie Nachrichtenflüsse stoppen.

Syntax

Parameter

-b Brokername
(Erforderlich) Name des Brokers, in dem die Nachrichtenflüsse gestoppt werden sollen.

Werden die Parameter -e und -m nicht angegeben, werden alle Nachrichtenflüsse im Broker gestoppt.

-e Ausführungsgruppe
(Optional) Name der Ausführungsgruppe, in der Nachrichtenflüsse gestoppt werden.
-m Nachrichtenfluss
(Optional) Der Name des Nachrichtenflusses, der gestoppt wird.

Sie können in einem Befehl nur jeweils einen Nachrichtenfluss angeben. Wird dieser Parameter nicht angegeben, werden alle Nachrichtenflüsse in der Ausführungsgruppe oder im Broker gestoppt.

Bei Angabe dieses Parameters muss -e ebenfalls angegeben werden.

-n Datei_mit_Konfigurationsparametern
(Optional) Der Name der .configmgr-Datei, in der die Verbindungsparameter für den Konfigurationsmanager definiert sind.
Es handelt sich dabei um eine XML-Datei im Format .configmgr, die von der Eclipse-GUI gespeichert wird. Beispiel:
<?xml version="1.0" encoding="UTF-8"?>
<configmgr host="localhost" listenerPort="1414" queueManager="QNAME"
           securityExit="test.myExit"/>
Wenn Sie diese Datei unter z/OS verwenden, müssen Sie die Anweisung encoding="UTF-8" aus der ersten Zeile entfernen, damit die Anweisung wie folgt lautet:
<?xml version="1.0"?>
Außerdem müssen Sie den Wert für das Hostattribut entfernen, damit die Anweisung wie folgt lautet:
<configmgr host="" listenerPort="1414" queueManager="QNAME"
           securityExit="test.myExit"/>
Anmerkung: Wenn Sie diesen Parameter nicht verwenden, müssen Sie die Parameter -i, -p und -q angeben.
-i IP-Adresse
(Optional) Der Hostname oder die IP-Adresse des Konfigurationsmanagers.

Wenn Sie diese Datei unter z/OS verwenden und eine Verbindung zum lokalen Host herstellen möchten, müssen Sie den Wert auf "" setzen.

-p Port
(Optional) Die Portnummer des Konfigurationsmanagers.
-q Warteschlangenmanager
(Optional) Der Name des WebSphere MQ-Warteschlangenmanagers, der vom Konfigurationsmanager verwendet wird.

Wenn Sie die Parameter -i, -p und -q nicht verwenden, müssen Sie den Parameter -n angeben.

-w Zeitlimit
(Optional) Die Zeit in Sekunden, die das Dienstprogramm auf die erfolgreiche Ausführung des Stoppbefehls wartet; der Standardwert beträgt 60 Sekunden.
-v Tracedateiname
(Optional) Mit diesem Parameter werden interne Tracedaten in die angegebene Datei geschrieben.

Autorisierung

Zum Stoppen von Nachrichtenflüssen benötigen Sie die entsprechenden Berechtigungen, die in der Zugriffssteuerungsliste (ACL) des Konfigurationsmanagers definiert sind.

Es sind dieselben Berechtigungen wie sie zur Ausführung der entsprechenden Funktion im Message Brokers Toolkit benötigt werden; eine Liste der Berechtigungen, die im Konfigurationsmanager definiert werden können, finden Sie unter ACL-Berechtigungen.

Antworten

Dieser Befehl gibt die folgenden Antworten zurück:
0
(Success) Gibt die erfolgreiche Ausführung der Anforderung sowie den Status aller aktualisierten Nachrichtenflüsse an.
2
(Failure) Gibt an, dass mindestens ein Nachrichtenfluss aus irgendeinem Grund nicht den korrekten Status annehmen konnte.
98
Gibt an, dass keine Verbindung zum Konfigurationsmanager hergestellt werden konnte.
99
Gibt an, dass die an das Dienstprogramm übergebenen Argumente ungültig sind.

Beispiele

Es werden alle Nachrichtenflüsse in der Ausführungsgruppe default im Broker B1 gestoppt, der von dem Konfigurationsmanager gesteuert wird, dessen Verbindungsparameter in der Datei cm1.configmgr definiert sind. Die Steuerung wird an das aufrufende Programm zurückgegeben, wenn die Meldung erfolgt, dass alle Nachrichtenflüsse in der Ausführungsgruppe gestartet wurden, oder wenn die Standardwartezeit abgelaufen ist (je nachdem, was zuerst eintritt).

   mqsistopmsgflow –n cm1.configmgr –b B1 -e default

Der Nachrichtenfluss flow1 in der Ausführungsgruppe default im Broker B1 wird gestoppt; dieser Broker wird von dem Konfigurationsmanager gesteuert, dessen Verbindungsparameter in der Datei cm1.configmgr definiert sind. Die Steuerung wird an das aufrufende Programm zurückgegeben, wenn die Meldung erfolgt, dass der Nachrichtenfluss gestoppt wurde, oder wenn die Standardwartezeit abgelaufen ist (je nachdem, was zuerst eintritt).

   mqsistopmsgflow –n cm1.configmgr –b B1 -e default -m flow1

Geben Sie den Befehl mqsistopmsgflow ein, um Verwendungshinweise anzuzeigen:

> mqsistopmsgflow
BIP1025I: Nachrichtenflüsse werden gestoppt.

> Syntax:
mqsistopmsgflow (-n cfgParameterFileName | (-i ipAddress -p port -q qMgr))
 -b brokerName [-e executionGroupName [-m flowName]] [-w timeoutValue]
[-v traceFileName]
Befehlsoptionen:
'-n cfgParameterFileName' Datei (.configmgr) mit den Verbindungsparametern für den Konfigurationsmanager
'-i ipAddress' IP-Adresse oder Hostname des Konfigurationsmanagers
'-p port' Portnummer des Konfigurationsmanagers
'-q qMgr' Warteschlangenmanager des Konfigurationsmanagers
'-b brokerName' Name des Brokers, in dem die Nachrichtenflüsse gestoppt werden sollen
'-e executionGroupName' Name der Ausführungsgruppe, in der die Nachrichtenflüsse gestoppt werden sollen.
Falls dieser Parameter nicht angegeben wurde, werden alle Nachrichtenflüsse im Broker gestoppt.
'-m flowName' Name des Nachrichtenflusses, der gestartet werden soll.
Falls dieser Parameter nicht angegeben wurde, werden alle Nachrichtenflüsse in der Ausführungsgruppe gestoppt.
'-w timeoutValue' Wartezeit (in Sekunden), bevor die Nachrichtenflüsse gestoppt werden (Standardwert = 60)
'-v traceFileName' Sendet den ausführlichen internen Trace an die angegebene Datei.
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
an26110_