Mit dem Befehl mqsiapplybaroverride können konfigurierbare Werte im Implementierungsdeskriptor des Brokerarchivs durch neue Werte ersetzt werden, die in einer Eigenschaftendatei angegeben werden.
Über den Befehl mqsireadbar können Sie anzeigen, welche Eigenschaften Sie mit dem Befehl mqsiapplybaroverride konfigurieren können.
Schreiben Sie Scripts zum Erstellen von Brokerarchivdateien und wenden Sie unterschiedliche neue Werte in der Archivdatei des Brokerimplementierungsdeskriptors an, indem Sie den Befehl mqsiapplybaroverride in Verbindung mit dem Befehl mqsicreatebar verwenden. Eine Liste der Eigenschaften der Nachrichtenflussknoten und der entsprechenden Eigenschaften des Befehls mqsiapplybaroverride finden Sie im Abschnitt Konfigurierbare Eigenschaften. Die Eigenschaften des Befehls mqsiapplybaroverride werden ebenfalls für jeden beteiligten Knoten in der Eigenschaftentabelle im Abschnitt zu den Verweisen aufgeführt.
Sie können diesen Parameter zusammen mit den Parametern –p (NeueWerteDatei) und –m (NeueWerteListe) verwenden, um Überschreibungen auf eine bestimmte Anwendung in der BAR-Datei anzuwenden. Wenn die mit dem Parameter –p angegebene Datei mit neuen Werten eine BAR-Datei ist und Sie den Parameter –k angeben, werden die Implementierungsdeskriptoren für die Anwendung und alle ihre Bibliotheken aus der BAR-Quellendatei aktualisiert. Wenn die mit dem Parameter –p angegebene Datei mit neuen Werten ein Implementierungsdeskriptor ist und Sie den Parameter –k angeben, wird nur der Implementierungsdeskriptor für die Anwendung aktualisiert. Wenn Sie die Parameter –m und –k angeben, wird die Liste mit neuen Werten auf die genannte Anwendung angewendet.
Um Überschreibungen auf eine bestimmte Bibliothek in einer Anwendung anzuwenden, können Sie den Parameter –k zusammen mit dem Parameter –y (Bibliotheksname) angeben.
Wenn Sie den Parameter -k nicht angeben und die mit dem Parameter -p angegebene Datei eine BAR-Datei ist, die Anwendungen enthält, und dieselben Anwendungen auch in der BAR-Zieldatei enthalten sind, wird der Implementierungsdeskriptor der BAR-Zieldatei aus der BAR-Quellendatei aktualisiert.
<?xml version="1.0" encoding="UTF-8"?>in
<?xml version="1.0"?>
Wenn die mit dem Parameter -p angegebene Datei eine BAR-Datei ist, die Anwendungen oder Bibliotheken enthält, und Sie nicht den Parameter -k oder -y angeben und wenn dieselben Anwendungen oder Bibliotheken auch in der BAR-Zieldatei enthalten sind, wird der Implementierungsdeskriptor der BAR-Zieldatei aus der BAR-Quellendatei aktualisiert.
Sie können diesen Parameter zusammen mit den Parametern –p (NeueWerteDatei) und –m (NeueWerteListe) verwenden, um Überschreibungen auf eine bestimmte Bibliothek in der BAR-Datei anzuwenden. Wenn die mit dem Parameter –p angegebene Datei mit neuen Werten eine BAR-Datei ist und Sie den Parameter –y angeben, werden die Implementierungsdeskriptoren für die Bibliothek aus der BAR-Quellendatei aktualisiert. Wenn die mit dem Parameter –p angegebene Datei mit neuen Werten ein Implementierungsdeskriptor ist und Sie den Parameter –y angeben, wird nur der Implementierungsdeskriptor für die Bibliothek aktualisiert. Wenn Sie die Parameter –m und –y angeben, wird die Liste mit neuen Werten auf die genannte Bibliothek angewendet.
Um Überschreibungen auf eine bestimmte Bibliothek in einer Anwendung anzuwenden, können Sie den Parameter –y zusammen mit dem Parameter –k (Anwendungsname) angeben.
Wenn Sie den Parameter -y nicht angeben und die mit dem Parameter -p angegebene Datei eine BAR-Datei ist, die Bibliotheken enthält, und dieselben Bibliotheken auch in der BAR-Zieldatei enthalten sind, wird der Implementierungsdeskriptor der BAR-Zieldatei aus der BAR-Quellendatei aktualisiert.
In allen Fällen wird ein in der BAR-Datei enthaltener Implementierungsdeskriptor in META-INF\broker.xml.old umbenannt, wobei eine eventuell vorhandene Datei mit diesem Namen ersetzt wird.
BIP1138I: Overriding BAR File using runtime mqsiapplybaroverride (Überschreiben der BAR-Datei mit dem Laufzeitbefehl mqsiapplybaroverride)
Wenn Sie den Befehl nicht aus einer entsprechend berechtigten Umgebung ausführen, werden Sie zu einer Bestätigung aufgefordert, dass Sie den Vorgang fortsetzen möchten. Wenn Sie auf OK klicken, wird eine neue berechtigte Befehlskonsole erstellt und der Befehl ausgeführt, wobei jedoch alle Antworten an die berechtigte Umgebung ausgegeben werden und verloren gehen, sobald die Konsole nach Ausführung des Befehls geschlossen wird.
Auf allen Betriebssystemen muss die Benutzer-ID, mit der dieser Befehl aufgerufen wird, über die Schreibberechtigung für die Brokerarchivdatei im lokalen System verfügen.
Dieser Befehl wird als Stapeldatei übergeben. Wenn Sie den Befehl in einem Automatisierungssystem oder aus einem Script ausführen, können Sie durch Verwendung des CALL-Befehls für Windows sicherstellen, dass die korrekte Fehlerkategorie (ERRORLEVEL) zurückgegeben wird:...
CALL mqsiapplybaroverride
...
mqsiapplybaroverride -b myflow.bar -p mychanges.properties
mqsiapplybaroverride -b myflow.bar -p myOriginalBarFile.bar
mqsiapplybaroverride -b myflow.bar -k Anwendung1 -p myOriginalBarFile.bar
mqsiapplybaroverride -b myflow.bar -k Anwendung1 -y Bibliothek1 -p myOtherBroker.xml
mqsiapplybaroverride -b c:\test.bar -p c:\my.properties
mqsiapplybaroverride –b c:\test.bar –p c:\previous.bar
mqsiapplybaroverride –b c:\test.bar –p c:\broker.xml
mqsiapplybaroverride –b c:\test.bar –m OLDA=NEWA,OLDB=NEWB
mqsiapplybaroverride –b c:\test.bar –m sampleFlow#MQInput.queueName=NEWC
Ein Beispiel für den Inhalt einer Eigenschaftendatei finden Sie im Abschnitt Konfigurierbare Eigenschaften bearbeiten.