Befehl 'mqsicreateexecutiongroup'

Unterstützte Plattformen

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

Zweck

Mit dem Befehl mqsicreateexecutiongroup können Sie einem Broker eine neue Ausführungsgruppe hinzufügen.

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

Der Broker muss im Konfigurationsmanager definiert werden, bevor der Befehl ausgeführt werden kann.

Syntax

Parameter

-b Brokername
(Erforderlich) Der Name des Brokers, in dem die Ausführungsgruppe erstellt werden soll.
-e Ausführungsgruppe
(Erforderlich) Der Name der neuen Ausführungsgruppe
-l
(Optional) Erstellt eine 64-Bit-Ausführungsgruppe.
-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 Brokerwarteschlangenmanager
Ein Broker mit dem zugehörigen Warteschlangenmanagernamen muss im Konfigurationsmanager definiert werden, falls er nicht bereits vorhanden ist. Wenn der Broker bereits im Konfigurationsmanager definiert 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 erstellt werden kann, ist die vollständige Zugriffsberechtigung auf das Brokerobjekt notwendig; eine Liste mit den 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 ausgeführt und die Ausführungsgruppe erfolgreich im Repository des Konfigurationsmanagers erstellt wurde. Wenn der Broker das nächste Mal implementiert wird, wird die neue Ausführungsgruppenliste im Broker initialisiert.
2
(Failure) Gibt an, dass die Ausführungsgruppe aus irgendeinem Grund nicht erstellt 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

Erstellen der Ausführungsgruppe EG1 im 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.

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

Erstellen der Ausführungsgruppe EG2 im Broker BROKER in der über die Datei domain1.configmgr angegebenen Domäne.

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

Erstellen der Ausführungsgruppe EG3 im Broker FRED in der über die Datei domain2.configmgr angegebenen Domäne. Der Konfigurationsmanager hat Minuten Zeit für eine Antwort. Die Ausgabe erfolgt in die Datei trace.txt.

  mqsicreateexecutiongroup –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
an26000_