Befehl 'mqsideleteexecutiongroup'

Unterstützte Plattformen

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

Zweck

Mit dem Befehl mqsideleteexecutiongroup können Sie eine Ausführungsgruppe aus einem Broker löschen.

Vor dem Ausgeben dieses Befehls müssen Sie den Konfigurationsmanager starten.

Wenn Sie eine Ausführungsgruppe löschen, für die zuvor eine Implementierung durchgeführt wurde, müssen Sie vor Ausführung dieses Befehls auch den Broker starten.

Syntax

Parameter

-b Brokername
(Erforderlich) Der Name des Brokers, in dem sich die Ausführungsgruppe befindet.
-e Ausführungsgruppe
(Erforderlich) Name der Ausführungsgruppe, die gelöscht werden soll.
-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.
-f
Der Broker muss aus dem Konfigurationsmanager entfernt werden, falls es sich hierbei um die letzte Ausführungsgruppe handelt. Wenn dies nicht die letzte Ausführungsgruppe im Broker ist, wird dieses Attribut ignoriert.
-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

Auf Windows-Plattformen sowie auf Linux- und UNIX-Systemen müssen Sie zur Gruppe 'mqm' gehören; außerdem ist die Ausführung des Befehls nur erfolgreich, wenn die Benutzer-ID, unter der der Befehl ausgeführt wird, über die korrekte, in der Zugriffssteuerungsliste des Konfigurationsmanagers definierte Berechtigung verfügt.

Damit eine Ausführungsgruppe gelöscht werden kann, ist die volle Zugriffsberechtigung auf das Brokerobjekt notwendig; eine Übersicht über die 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 an, dass die Anforderung erfolgreich verarbeitet und die Ausführungsgruppe erfolgreich gelöscht wurde. Wenn der Befehl für eine Ausführungsgruppe abgesetzt wurde, für die zuvor eine Implementierung vorgenommen wurde, gibt dieser Rückkehrcode an, dass der Broker gestoppt wurde und alle Ressourcen in Zusammenhang mit dem Broker (beispielsweise Nachrichtenflüsse) freigegeben wurden.
2
(Failure) Gibt an, dass die Ausführungsgruppe aus irgendeinem Grund nicht gelöscht werden 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

Löschen der Ausführungsgruppe EG1 aus dem Broker BROKER in der Domäne, die von dem Konfigurationsmanager gesteuert wird, dessen Warteschlangenmanager die Bezeichnung QMGR hat und den Port fred.abc.com:1414 überwacht.

  mqsideleteexecutiongroup -i fred.abc.com -p 1414 -q QMGR -b BROKER –e EG1

Löschen der Ausführungsgruppe EG2 aus dem Broker BROKER in der über die Datei domain1.configmgr angegebenen Domäne.

  mqsideleteexecutiongroup –n domain1.configmgr –b BROKER –e EG2 

Löschen der Ausführungsgruppe EG3 aus dem Broker FRED in der über die Datei domain2.configmgr angegebenen Domäne. Der Konfigurationsmanager hat fünf Minuten Zeit, alle belegten Ressourcen freizugeben. Die Ausgabe erfolgt in die Datei trace.txt.

  mqsideleteexecutiongroup –n domain2.configmgr –b FRED –e EG3 –w 300 –v trace.txt
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
an26010_