Befehl 'mqsideploy' - z/OS

Mit BIPDPLY wird mqsideploy ausgeführt, und auf z/OS führt dieser Befehl dies von JAVA-Bindungen aus; weitere Informationen erhalten Sie unter Nutzungshinweis.

Syntax

z/OS-Befehl - BIPDPLY

z/OS-Konsolbefehl

Synonym: dp

Parameter

-n Konfigurationsparameterdatei
(Optional) Dieser Parameter gibt den Namen der .configmgr-Datei an, in der die Verbindungsparameter für den Konfigurationsmanager definiert sind.
Entfernen Sie die Anweisung encoding="UTF-8" aus der ersten Zeile der Datei.configmgr und den Wert für das Host-Attribut, 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.

Wenn Sie eine Verbindung zum lokalen Host herstellen möchten, müssen Sie den Wert auf " " setzen.

-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.
-b Brokername
(Optional) Dieser Parameter gibt den Namen des Brokers an, für den die Implementierung ausgeführt werden soll. Wenn Sie den Parameter -t oder -l angeben, wird der Parameter -b ignoriert, da bei der Implementierung von Artikeln oder Topologien alle Broker in der Domäne betroffen sind. Ohne Angabe der Parameter -e und -a wird die Implementierung einer Brokerkonfiguration eingeleitet. Wenn Sie den Parameter -b nicht angeben, wird der Befehl auf alle Broker in der Domäne angewandt.
Geben Sie den Parameter -c an, um die Implementierung für einen bestimmten Broker abzubrechen.
-e EGName
(Optional) Dieser Parameter gibt den Namen der Ausführungsgruppe an, in die implementiert werden soll. Sie müssen -b und -a mit diesem Parameter angeben.
-aBAR-Dateiname
(Optional) Dieser Parameter gibt den Namen der BAR-Datei (Brokerarchiv) an, die für das Implementieren eines Nachrichtenflusses oder einer Nachrichtengruppe verwendet werden soll. Sie müssen auch die Parameter -b und -e mit dieser Option angeben.

Die BAR-Datei muss sich im Dateisystem befinden. Die BAR-Datei kann sich an einer beliebigen Stelle im Dateisystem befinden, solange die Benutzer-ID der Person oder der Konfigurationsmanager, der den Befehl ausführt, auf die Datei zugreifen und sie lesen kann.

-t
(Optional) Dieser Parameter gibt die Implementierung aller Konfigurationsdaten der Themen an.
  • In Verbindung mit dem Parameter -m verursacht der Parameter -t die Implementierung der kompletten Themenhierarchie für alle Broker in der Domäne.
  • Ohne den Parameter -m verursacht der Parameter -t nur die Implementierung von Änderungen an der Themenhierarchie (seit der letzten erfolgreichen Themenimplementierung) für alle Broker in der Domäne.
-l
(Optional) Dieser Parameter gibt an, dass die Topologiekonfiguration implementiert werden soll. Die Informationen werden für alle Broker in der Domäne implementiert, wenn auch der Parameter -m angegeben wurde. Andernfalls werden die Informationen nur für Broker mit einer geänderten Topologiekonfiguration implementiert.
-c
(Optional) Dieser Parameter weist den Konfigurationsmanager an, nicht länger auf Antworten auf zuvor übergebene Implementierungsanforderungen zu warten. Wird dieser Parameter zusammen mit -b angegeben, wartet der Konfigurationsmanager nicht länger auf ausstehende Antworten des angegebenen Brokers auf zuvor übergebene Implementierungsanforderungen; ohne Angabe des Parameters -b wartet der Konfigurationsmanager nicht länger auf ausstehende Antworten aller Broker in der Domäne.

Der Parameter -c sollte mit Vorsicht angegeben werden; er führt zum Abbrechen von Implementierungsanforderungen. Verwenden Sie diese Option nur, wenn es keine Möglichkeit gibt, dass die betroffenen Broker auf die ausstehenden Anforderungen antworten. Wenn ein Broker in der Folge eine Implementierungsanforderung verarbeitet, die abgebrochen wurde, ignoriert der Konfigurationsmanager die Antwort und wird daher nicht mehr mit dem Broker synchronisiert.

-w Zeitlimit
(Optional) Dieser Parameter definiert die 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. Die entsprechenden Protokollsätze geben Aufschluss, ob die Implementierung erfolgreich war. Das Zeitlimit gibt die Anzahl der Sekunden bis zum Abbruch an. Der Wert liegt zwischen 1 und 2 145 336 164. Wenn kein Zeitlimit angegeben wird oder der Wert kleiner als 1 oder größer als 2 145 336 164 ist, wird ein Fehler zurückgegeben.
-dImplementierte_Objekte
(Optional) Dieser Parameter beschreibt die Gruppe von Objekten, die aus der Ausführungsgruppe entfernt werden sollen. Sie können mehrere Dateien angeben, die implementiert werden sollen, indem Sie die Dateinamen mit einem Doppelpunkt (:) trennen.

Sie können Objekte aller Typen angeben, jedoch 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) Dieser Parameter sendet den internen Konfigurationsmanager-Proxy-Trace an die angegebene Datei.
-m
(Optional) Dieser Parameter gibt die Implementierung der vollständigen Informationen an:
  • 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. Alle implementierten Objekte mit demselben Namen wie ein Element in der BAR-Datei werden durch die Version innerhalb 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.
  • Dieser Parameter ist für die Implementierung der Brokerkonfiguration nicht gültig.
  • 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 der Parameter -m ignoriert.

Nutzungshinweis

Wenn Sie
mqsideploy -i cm_name -p port -q cm_qm -l  -m 
versucht der Befehl mqsideploy mit WebSphere MQ-Java-Clientcode auszuführen. Dieser ist unter z/OS nicht zulässig. Das Herstellen einer Verbindung zum lokalen Konfigurationsmanager mit den Parametern -i und -p zwingt den Befehl in einen Lokalmodus, und der folgende Fehler wird ausgegeben:
BIP1046E: Unable to connect with the Configuration Manager's queue manager (Verbindung zum Warteschlangenmanager des Konfigurationsmanagers kann nicht hergestellt werden)
Abhängig von der verwendeten Version von WebSphere MQ unterscheiden sich die Ursachencodes:
  • Unter WebSphere MQ V5.3.1:
    2012 0x000007dc MQRC_ENVIRONMENT_ERROR
  • Unter WebSphere MQ V6.0:
    2298 0x000008fa MQRC_FUNCTION_NOT_SUPPORTED

Beispiele

Publish/Subscribe-Nachbarn werden mit Hilfe einer Verbindungsdatei implementiert, deren Parameter in der Datei cm1.configmgr definiert sind; dabei sollte der Broker 10 Minuten Zeit haben, um zu antworten und die vollständigen brokerübergreifenden Konfigurationsdaten zu implementieren:
  mqsideploy -n cm1.configmgr -m -w 600 
Publish/Subscribe- Nachbarn werden unter Angabe der Parameter i, p und qimplementiert, damit eine Verbindung zum Konfigurationsmanager hergestellt werden kann; dabei sollte der Broker 10 Minuten Zeit haben, um zu antworten und die vollständigen brokerübergreifenden Konfigurationsdaten zu implementieren:
  mqsideploy -i localhost -p 1414 -q QMNAME -m -w 600 

In den folgenden Bespielen können Sie anstelle des Parameters -n die Parameter i, p und q verwenden.

Themenhierarchien werden mit Hilfe einer Verbindungsdatei implementiert, deren Parameter in der Datei cm1.configmgr definiert sind; dabei sollte der Broker 10 Minuten Zeit haben, um zu antworten und die vollständigen brokerübergreifenden Konfigurationsdaten zu implementieren:
  mqsideploy -n cm1.configmgr -t -m -w 600 
BAR-Dateien werden mit Hilfe einer Verbindungsdatei im Broker implementiert, deren Parameter in der Datei cm1.configmgr definiert sind; dabei sollte der Broker 10 Minuten Zeit haben, um im Zuge der Implementierung alle momentan implementierten Nachrichtenflüsse und Nachrichtengruppe aus der Ausführungsgruppe zu entfernen:
  mqsideploy -n cm1.configmgr -b broker1 -e default -a mybar.bar -m -w 600 
Eine Brokerkonfiguration wird mit Hilfe einer Verbindungsdatei im Broker implementiert, deren Parameter in der Datei cm1.configmgr definiert sind; der Broker sollte 15 Minuten Zeit haben, um zu antworten:
  mqsideploy -n cm1.configmgr -b broker1 -w 900 
Entfernen Sie mit Hilfe einer Verbindungsdatei, deren Parameter in der Datei cm1.configmgr definiert sind, den Nachrichtenfluss top und das Dictionary bar aus der Ausführungsgruppe default im Broker b1. (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
Eine Implementierung wird mit Hilfe einer Verbindungsdatei abgebrochen, deren Parameter in der Datei cm1.configmgr definiert sind; dabei sollte der Broker 15 Minuten Zeit haben, um zu antworten. In diesem Beispiel stoppt der Konfigurationsmanager und wartet auf alle ausstehenden Implementierungsanforderungen in der Domäne.
  mqsideploy -n cm1.configmgr -c -w 900 
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
an28530_