Befehl 'mqsistop'

Unterstützte Plattformen

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

Zweck

Verwenden Sie den Befehl mqsistop, um eine WebSphere Message Broker-Komponente zu stoppen.Unter z/OS muss der Controller aktiv sein.

Beginn der ÄnderungIn der folgenden Tabelle wird zwischen den Befehlen stop (/P) und stopcomponent unterschieden, und es werden die verfügbaren Optionen aufgeführt:
  • Verwenden Sie den Befehl stop (/P), um eine Komponente in einen Zustand zu bringen, in dem Sie den passenden change-Befehl ausführen können.
  • Mit dem Befehl stopcomponent können Sie einen Broker, Konfigurationsmanager oder Benutzernamensserver stoppen, wenn der Controller (Steuerungsprozess) bereits aktiv ist.
Komponente Befehl Beschreibung
Broker
  • /P <brokerName>
  • /F <brokerName>,P
  • /F <brokerName>,PC
  • Broker stoppen.
  • Broker stoppen; dies ist der Name als /P. Sie können auch "/F <brokerName>,STOP" verwenden.
  • Brokerkomponente stoppen. Dadurch wird der Brokerprozess gestoppt (einschließlich der Ausführung von Gruppenadressräumen), der Konsolbefehlserver des Nachrichtenbrokers bleibt jedoch innerhalb des Adressraumes des Controllers aktiv. Dies ermöglicht Ihnen, den Befehl 'mqsichangebroker'-Konsolenbefehl auszuführen. Starten Sie danach den Broker neu, indem Sie den Konsolbefehl Befehl 'mqsistart' (SC) ausführen.
Konfigurationsmanager
  • /P <configMgrName>
  • /F <configMgrName>,P
  • /F <configMgrName>,PC
  • Stoppen Sie Konfigurationsmanager.
  • Stoppen Sie Konfigurationsmanager; dies ist der Name als /P. Sie können auch "/F <configMgrName>,STOP" verwenden.
  • Stoppen Sie die Konfigurationsmanager-Komponente. Dadurch wird der Konfigurationsmanager-Prozesse gestoppt, der Konsolbefehlserver des Nachrichtenbrokers bleibt jedoch innerhalb des Adressraumes des Controllers aktiv. Dies ermöglicht Ihnen, den Befehl 'mqsichangeconfigmgr'-Konsolenbefehl auszuführen. Starten Sie danach den Broker neu, indem Sie den Konsolbefehl Befehl 'mqsistart' (SC) ausführen.
Benutzernamensserver
  • /P <BenutzernamensserverName>
  • /F <Benutzernamensserver>,P
  • /F <Benutzernamensserver>,PC
  • Stoppen Sie Benutzernamensserver.
  • Stoppen Sie Benutzernamensserver; dies ist der Name als /P. Sie können auch "/F <Benutzernamensserver>,STOP" verwenden.
  • Stoppen Sie die Benutzernamensserver-Komponente. Dadurch wird der Benutzernamensserver-Prozesse gestoppt, der Konsolbefehlserver des Nachrichtenbrokers bleibt jedoch innerhalb des Adressraumes des Controllers aktiv. Dies ermöglicht Ihnen, den Befehl 'mqsichangeusernameserver'-Konsolenbefehl auszuführen. Starten Sie danach den Broker neu, indem Sie den Konsolbefehl Befehl 'mqsistart' (SC) ausführen.
Ende der Änderung

Syntax

Windows-Plattformen, Linux- und UNIX-Systeme

z/OS

Synonym: pc

Parameter

component
(Erforderlich - Windows-, Linux- und UNIX-Systeme) Hier muss der Name eines Brokers, der Name eines Konfigurationsmanagers oder einer der folgenden Festen Werte angegeben werden:
  • UserNameServer oder DatabaseInstanceMgr (auf Windows-Plattformen)
  • UserNameServer (auf Linux- und UNIX-Systemen)
Auf Linux- und UNIX-Systemen muss bei allen Namen die Groß-/Kleinschreibung beachtet werden.

Auf einem DatabaseInstanceMgr sollte dieser Befehl nur ausgeführt werden, wenn eine Derby-Datenbank verwendet wird.

-q
(Optional - nur Windows- Linux- und UNIX-Systeme) Stoppen Sie den WebSphere MQ-Warteschlangenmanager, der dieser WebSphere Message Broker-Komponente zugeordnet ist.

Dieses Attribut wird nur angegeben, wenn die WebSphere Message Broker-Komponente die einzige oder die letzte noch aktive WebSphere Message Broker-Komponente dieses Warteschlangenmanagers ist. Dieser Befehl veranlasst eine kontrollierte Beendigung des Warteschlangenmanagers und informiert die Benutzer dieses Warteschlangenmanagers über dessen Beendigung.

Wenn die anderen WebSphere Message Broker-Komponenten, die diesen Warteschlangenmanager verwenden, vor der Ausführung dieses Befehls mit dieser Option nicht gestoppt wurden, müssen Sie sie anschließend stoppen oder den Warteschlangenmanager erneut starten.

Bei Verwendung dieser Option werden die dem Warteschlangenmanager zugeordneten Empfangsprogramme nicht zusammen mit dem Warteschlangenmanager gestoppt. Sie müssen nach Ausführung dieses Befehls manuell beendet werden.

-i
(Optional) Stoppt den Broker unverzüglich.

Dieses Flag sollte nur angegeben werden, wenn schon einmal versucht wurde, den Broker ordnungsgemäß mit dem Befehl mqsistop ohne Angabe von -i zu stoppen.

Unter z/OS schlägt dieser Befehl fehl, wenn die Ausführung eines zuvor eingegebenen Befehls noch nicht abgeschlossen ist. Dieser Fehler kann beispielsweise auftreten, wenn ein oder mehrere Adressräume von Ausführungsgruppen nicht beendet werden können.

Berechtigung

Auf Windows-Plattformen muss die Benutzer-ID, unter der dieser Befehl ausgeführt wird, zur Gruppe Administratoren gehören.

Auf Linux- und UNIX-Systemen muss die Benutzer-ID, mit der dieser Befehl aufgerufen wird, folgende Voraussetzungen erfüllen:
  • Sie muss zur Gruppe mqbrkrs gehören.
  • Es muss sich bei der Benutzer-ID um root handeln, oder es muss sich um die Benutzer-ID handeln, die bei der Erstellung der Komponenten über den Parameter -i angegeben wurde.
  • Bei Angabe des Parameters -q muss die Benutzer-ID zur Gruppe mqm gehören.

Die für diesen Befehl verwendeten Sicherheitsanforderungen werden in den Abschnitten Sicherheitsanforderungen für Windows-Plattformen und Sicherheitsanforderungen für Linux- und UNIX-Plattformen zusammengefasst.

Antworten

Nur Windows-, Linux- und UNIX-Systeme:
  • BIP8012 Es kann keine Verbindung zu Systemkomponenten hergestellt werden
  • BIP8013 Komponente nicht vorhanden
  • BIP8016 Die Komponente kann nicht gestoppt werden
  • BIP8019 Komponente gestoppt
  • BIP8030 Änderungen an den Benutzerberechtigungen nicht möglich
  • BIP8049 Warteschlangenmanager konnte nicht gestoppt werden
  • BIP8093 Warteschlangenmanager wird gerade erstellt
  • BIP8094 Warteschlangenmanager wird gestoppt

Beispiele

Windows
So stoppen Sie den Datenbankinstanzmanager:
mqsistop DatabaseInstanceMgr
Windows-, Linux- und UNIX-Systeme.
So stoppen Sie den Broker mybroker und den zugeordneten WebSphere MQ-Warteschlangenmanager:
mqsistop mybroker -q
z/OS
So stoppen Sie einen Broker namens MQ00BRK:
F MQ00BRK,pc
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
an07240_