Befehl 'mqsistopmsgflow'

Unterstützte Plattformen

  • Windows
  • Linux- und UNIX-Systeme
  • z/OS. Führen Sie diesen Befehl aus, indem Sie BIPSPMF anpassen und übergeben; weitere Informationen erhalten Sie unter Inhalt der Konfigurationsmanager-PDSE

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 Konfigurationsparameterdatei
(Optional) Dieser Parameter gibt den Namen der .configmgr-Datei an, in der die Verbindungsparameter für den Konfigurationsmanager definiert sind.
Es handelt sich dabei um eine XML-Datei im Format .configmgr, die von der Workbench gespeichert wird; z. B.:
<?xml version="1.0" encoding="UTF-8"?>
<configmgr crlNameList="" domainName="" host="winmvsd0" listenerPort="2206" 
queueManager="mq06" securityExit="" securityExitJar="" sslCipherSuite="NONE" 
sslDistinguishedNames="" sslKeyStore="" sslTrustStore="" svrconn="SYSTEM.BKR.CONFIG"/>
Wenn Sie diese Datei unter z/OS verwenden, müssen Sie die Anweisung encoding="UTF-8" aus der ersten Zeile sowie den Wert für das Host-Attribut entfernen, damit die Anweisung wie folgt lautet:
<?xml version="1.0"?>
<configmgr crlNameList="" domainName="" host="" listenerPort="2206" 
queueManager="mq06" securityExit="" securityExitJar="" sslCipherSuite="NONE" 
sslDistinguishedNames="" sslKeyStore="" sslTrustStore="" svrconn="SYSTEM.BKR.CONFIG"/>
-i IP-Adresse
(Optional) Dieser Parameter gibt den Hostnamen oder die IP-Adresse des Konfigurationsmanagers an. Erfolgt keine Angabe, wird der Standardwert "" für eine Verbindung mit lokaler Bindung verwendet.
-p Port
(Optional) Dieser Parameter ist die Portnummer des Konfigurationsmanagers. Erfolgt keine Angabe, wird der Standardwert 1414 verwendet.
-q Warteschlangenmanager
(Optional) Dieser Parameter gibt den Namen des WebSphere MQ-Warteschlangenmanagers an, der vom Konfigurationsmanager verwendet wird. Erfolgt keine Angabe, wird der Standardwert "" verwendet.
-w Zeitlimit
(Optional) Dieser Parameter gibt die Zeit in Sekunden an, die das Dienstprogramm auf die erfolgreiche Ausführung des Befehlswartet; der Standardwert beträgt 60 Sekunden.
-v Tracedateiname
(Optional) Dieser Parameter sendet interne Debug-Trace-Informationen an die angegebene Datei.

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 Broker 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 Konfigurationsparameterdatei | ([-i IP-Adresse] [-p Port] [-q Warteschlangenmanager]))
 -b Brokername [-e Ausführungsgruppe [-m Nachrichtenfluss]] [-w Zeitlimit]
[-v Tracedateiname]
Befehlsoptionen:
'-n Konfigurationsparameterdatei' Datei (.configmgr) mit den Verbindungsparametern für den Konfigurationsmanager
'-i IP-Adresse' IP-Adresse oder Hostname des Konfigurationsmanagers
'-p Port' Portnummer des Konfigurationsmanagers
'-q Warteschlangenmanager' Warteschlangenmanager des Konfigurationsmanagers
'-b Brokername' Name des Brokers, in dem die Nachrichtenflüsse gestoppt werden sollen
'-e Ausführungsgruppe' 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 Nachrichtenfluss' Name des Nachrichtenflusses, der gestartet werden soll. 
Falls dieser Parameter nicht angegeben wurde, werden alle Nachrichtenflüsse in der Ausführungsgruppe gestoppt.
'-w Zeitlimit' Wartezeit (in Sekunden), bevor die Nachrichtenflüsse gestoppt werden (Standardwert = 60)
'-v Tracedateiname' Sendet den ausführlichen internen Trace an die angegebene Datei.
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
an26110_