Befehl 'mqsideploy'

Unterstützte Plattformen

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

Zweck

Mit dem Befehl mqsideploy können Sie eine Implementierungsanforderung an den Konfigurationsmanager absetzen. Dadurch können Sie die verschiedenen Versionen der Implementierungsanforderungen über ein Befehlsscript im Stapelbetrieb ausführen, ohne dabei manuell vorgehen zu müssen.

Die Standardsituation ist dabei eine Deltaimplementierung oder eine inkrementelle Implementierung. Das Standardverfahren kann mit -m außer Kraft gesetzt werden.

Bei dem Befehl mqsideploy ist keine Angabe des Namensparameters für den Konfigurationsmanager erforderlich, da alle notwendigen Verbindungsangaben über die Parameter -n, -q, -i und -p erhalten werden.

Syntax

Anmerkung: Die Befehlsattribute unterscheiden sich von denen des Befehls mqsideploy in den älteren Versionen. Auf Windows-Plattformen können dieselben Befehlsparameter wie in den älteren Versionen angegeben werden, allerdings muss dann der Befehl mqsideploy.bat verwendet werden.

Parameter

-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 Eclipse-GUI 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 -n angeben.

-b Brokername
(Erforderlich) Der Name des Brokers, für den die Implementierung ausgeführt werden soll. Ist der Parameter -t oder -l angegeben, wird die Option -b ignoriert. Dies liegt daran, dass bei der Implementierung von Themen oder Topologien alle Broker in der Domäne betroffen sind. Ohne Angabe der Attribute -e und -a wird die Implementierung einer Brokerkonfiguration eingeleitet.

Über die Option -c wird die Implementierung für den betreffenden Broker abgebrochen.

-e Ausführungsgruppe
(Optional) Name der Ausführungsgruppe, für die eine Implementierung durchgeführt werden soll. Zusammen mit dieser Option müssen auch die Optionen -b und -a angegeben werden.
-aBAR-Dateiname
(Optional) Name der Brokerarchivdatei, die für die Implementierung eines Nachrichtenflusses oder einer Nachrichtengruppe verwendet werden soll. Zusammen mit dieser Option müssen auch die Optionen -b und -e angegeben werden.
-t-topics
(Optional) Alle Konfigurationsdaten des Themas werden implementiert. Die Informationen werden für alle Broker in der Domäne implementiert.
-l-topology
(Optional) Diese Option gibt an, dass die Topologiekonfiguration implementiert werden soll. Die Informationen werden für alle Broker in der Domäne implementiert, wenn auch die Option -m angegeben wurde. Andernfalls werden die Informationen nur für Broker mit einer geänderten Topologiekonfiguration implementiert.
-c-cancel
(Optional) Weist den Konfigurationsmanager an, nicht länger auf Antworten auf zuvor übergebene Implementierungsanforderungen zu warten. Wird diese Option zusammen mit -b angegeben, wartet der Konfigurationsmanager nicht länger auf ausstehende Antworten des angegebenen Brokers auf zuvor übergebene Implementierungsanforderungen; ohne Angabe der Option -b wartet der Konfigurationsmanager nicht länger auf ausstehende Antworten aller Broker in der Domäne.

Zusammen mit dieser Option muss die Option -c angegeben werden. Die Option sollte nur verwendet werden, wenn der betroffene Broker auf die Implementierungsanforderung antwortet; wenn ein Broker anschließend eine bereits abgebrochene Implementierungsanforderung verarbeitet, ignoriert der Konfigurationsmanager die Antwort; in diesem Fall sind Konfigurationsmanager und Broker nicht mehr synchron.

-w Zeitlimit
(Optional) Zeitdauer in Sekunden, in der das Dienstprogramm auf eine Antwort des Brokers wartet, bevor die Steuerung an die Befehlszeile zurückgegeben wird. Mit dem Befehl mqsideploy werden die Protokollsätze für den Konfigurationsmanager auf das Ergebnis der zuvor abgesetzten Implementierungsanforderung abgefragt. In den relevanten Protokollsätzen sind Informationen darüber enthalten, ob die Implementierung erfolgreich war. Das Zeitlimit gibt die Anzahl der Sekunden bis zum Abbruch an. Der Wert liegt zwischen 1 und 999.999. Wenn kein Zeitlimit angegeben wird oder der Wert kleiner als 1 oder größer als 999.999 ist, wird ein Fehler zurückgegeben.
-d Implementierte_Objekte
(Optional) Beschreibt die Gruppe von Objekten, die aus der Ausführungsgruppe entfernt werden sollen. Es können mehrere implementierte Dateien angegeben werden, die durch das Zeichen ":" getrennt werden müssen.
Es können alle Objekttypen angegeben werden, allerdings mit den folgenden Einschränkungen:
  1. Nachrichtenflüsse und Nachrichtengruppen können nur angegeben werden, wenn der Konfigurationsmanager, mit dem der Befehl verbunden ist, nicht die Version 6 hat.
  2. Bei dem Versuch beispielsweise, eine XSL-Datei für einen Konfigurationsmanager der Version 6.0 zu entfernen, wird der Fehler "Objekt nicht gefunden" gemeldet.
  3. Bei Angabe eines mehrdeutigen Objektnamens (z. B. "top", wenn sowohl "top.dictionary" als auch "top.cmf" in derselben Ausführungsgruppe implementiert sind), schlägt der Befehl insgesamt fehl, und die Fehlernachricht BIP1089 wird ausgegeben. In einem solchen Fall muss der vollständig qualifizierte Name der Objekte angegeben werden, die entfernt werden sollen, z. B. "top.dictionary:top.cmf".
-v Tracedateiname
(Optional) Sendet die internen Trace-Informationen für die Fehlerbehebung des Konfigurationsmanager-Proxys an die angegebene Datei.
-m -complete
(Optional) Setzt vollständige Informationen ein:
  • Beim Implementieren einer BAR-Datei werden mit -m als Teil der Implementierung alle derzeit implementierten Nachrichtenflüsse und Nachrichtengruppen aus der Ausführungsgruppe entfernt. Wenn -m nicht angegeben wurde, wird der Inhalt der BAR-Datei zusätzlich zu den in der Ausführungsgruppe bereits vorhandenen Komponenten implementiert. In diesem Fall werden die implementierten Objekte durch Elemente desselben Namens in der BAR-Datei ersetzt.
  • Beim Implementieren einer Topologiekonfiguration werden mit der Option -m vollständige brokerübergreifende Konfigurationsdaten für alle Broker implementiert. Wenn -m nicht angegeben wurde, wird nur eine geänderte brokerübergreifende Konfiguration für Broker implementiert, deren brokerübergreifende Konfiguration geändert wurde.
  • Bei einer Brokerimplementierung werden mit -m alle für den Broker verfügbaren Konfigurationsattribute für den angegebenen Broker implementiert, z. B. Multicastparameter. Wenn -m nicht angegeben wurde, werden nur die geänderten Konfigurationsattribute implementiert.
  • Beim Implementieren einer Themenstruktur wird mit -m die gesamte Themenstruktur für alle Broker implementiert. Wenn -m nicht angegeben wurde, werden für alle Broker nur die Änderungen an der Themenbaumstruktur implementiert.
  • Wenn ein Nachrichtenfluss oder eine Nachrichtengruppe entfernt wird, wird diese Option ignoriert.

Autorisierung

Für eine erfolgreiche Implementierung muss die Benutzer-ID, unter der der Befehl eingegeben wird, über ausreichende Berechtigungen im Konfigurationsmanager verfügen. Die erforderlichen Berechtigungen sind dieselben wie für die Ausführung der entsprechenden Funktion in Message Brokers Toolkit. 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 an, dass der Konfigurationsmanager eine Implementierungsanforderung abgesetzt hat und alle relevanten Broker noch vor Ablauf des Zeitlimitintervalls erfolgreich geantwortet haben.
2
(Failure) Gibt an, dass der Konfigurationsmanager eine Implementierungsanforderung abgesetzt hat und mindestens ein Broker eine negative Antwort zurückgegeben hat. Weitere Informationen in einem solchen Fall finden Sie in der Nachrichtenausgabe des Dienstprogramms (oder im Ereignisprotokoll des Konfigurationsmanagers).
3
(Initiated) Gibt an, dass der Konfigurationsmanager eine Antwort des Inhalts gesendet hat, dass die Implementierung gestartet wurde, aber bis zum Ablauf des Zeitlimitintervalls noch keine Antworten von Brokern empfangen wurden.
5
(Submitted) Gibt an, dass die Implementierungsnachricht an den Konfigurationsmanager gesendet wurde, aber bis zum Ablauf des Zeitlimitintervalls noch keine Antwort empfangen wurde.
6
(SuccessSoFar) Gibt an, dass der Konfigurationsmanager die Implementierungsanforderung abgesetzt hat und einige, aber nicht alle der betroffenen Broker noch vor Ablauf des Zeitlimitintervalls erfolgreich geantwortet haben; es wurden keine negativen Antworten empfangen.
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 soll eine Verbindung zu dem Konfigurationsmanager hergestellt werden, dessen Verbindungsparameter in der Datei cm1.configmgr definiert sind. Außerdem soll der Nachrichtenfluss top und das Dictionary bar aus der Ausführungsgruppe default in Broker b1 entfernt werden.

Wenn in der Ausführungsgruppe keine anderen Objekte des Namens top und bar implementiert sind, ist für die Option -d die verkürzte Angabe top:bar möglich.

   mqsideploy –n cm1.configmgr –b B1 –e default –d top.cmf:bar.dictionary
Zugehörige Konzepte
Laufzeitumgebung
Zugehörige Tasks
Implementieren
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2005 Letzte Aktualisierung: Nov 17, 2005
an09020_