Befehl 'mqsicreateexecutiongroup'

Unterstützte Plattformen

Zweck

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

Vor Ausführung dieses Befehls müssen Sie den Konfigurationsmanager mit dem Befehl mqsistart (auf Windows-Plattformen sowie auf Linux- und UNIX-Systemen) oder startcomponent (unter z/OS) starten (siehe Befehl 'mqsistart').

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 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 Workbench 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 -connection angeben.

-w Zeitlimit
(Optional) Die Wartezeit in Sekunden, bevor die Ausführungsgruppe erstellt wird; Standardwert sind 60 Sekunden.
-v Tracedateiname
(Optional) Sendet den ausführlichen internen Trace an die angegebene Datei.

Autorisierung

Sie müssen 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 Sie die 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 Sie in der über die Datei domain1.configmgr angegebenen Domäne die Ausführungsgruppe EG2 im Broker BROKER.

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

Erstellen Sie in der über die Datei domain2.configmgr angegebenen Domäne die Ausführungsgruppe EG3 im Broker FRED. Geben Sie dem Konfigurationsmanager fünf Minuten Zeit für eine Antwort, und schreiben Sie die Ausgabe 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, 2006 Letzte Aktualisierung: 23. Aug. 2006
an26000_