Befehl mqsiapplybaroverride

Mit dem Befehl mqsiapplybaroverride können konfigurierbare Werte im Implementierungsdeskriptor des Brokerarchivs durch neue Werte ersetzt werden, die in einer Eigenschaftendatei angegeben werden.

Unterstützte Betriebssysteme

  • Windows
  • Linux- und UNIX-Systeme
  • z/OS. Führen Sie diesen Befehl aus, indem Sie BIPOBAR anpassen und übergeben.

Zweck

Ü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.

Syntax

Syntaxdiagramm lesenSyntaxdiagramm überspringen
>>-mqsiapplybaroverride-- -b --BAR-Datei------------------------>

>--+----------------------+--+----------------------+----------->
   '- -k --Anwendungsname-'  '- -m --NeueWerteListe-'   

>--+--------------------+--+----------------------+------------->
   '- -o --Ausgabedatei-'  '- -p --NeueWerteDatei-'   

>--+----------------------+--+------------------------+--------><
   '- -v --Tracedateiname-'  '- --y --Bibliotheksname-'   

Parameter

-b BAR-Datei
(Erforderlich) Der Pfad der Brokerarchivdatei (im komprimierten Format), auf die die neuen Werte angewendet werden. Dies kann ein absoluter oder relativer Pfad zum ausführbaren Befehl sein.
-k Anwendungsname
(Optional) Der Name einer Anwendung in der BAR-Datei, auf die Überschreibungen angewendet werden sollen.

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.

-m NeueWerteListe
(Optional) Eine Liste der property-name=override- und/oder current-property-value=override-Paare, die auf die BAR-Datei angewendet werden sollen. Die Paare in der Liste sind durch Kommas (,) getrennt. Unter Windows muss die Liste in Anführungszeichen (" ") gesetzt werden. Bei Verwendung mit dem Parameter zur Dateiüberschreibung ( –p) werden über den Parameter für manuelle Überschreibungen (–m) angegebene Überschreibungen erst angewendet, nachdem alle mit dem Parameter –p definierten Überschreibungen erfolgt sind.
-p NeueWerteDatei
(Optional) Der Pfad zu einer der folgenden Ressourcen:
  • Ein Brokerarchiv mit dem Implementierungsdeskriptor, der für Überschreibungen in der BAR-Datei angewendet wird.
    Für die Implementierungsdeskriptordatei kann XML verwendet werden. Wenn Sie eine XML-Eigenschaftendatei verwenden, die in EBCDIC unter z/OS erstellt wurde, müssen Sie sämtliche encoding="UTF-8"-Elemente aus dem XML-Header entfernen. Ändern Sie zum Beispiel:
    <?xml version="1.0" encoding="UTF-8"?>
    in
    <?xml version="1.0"?>
  • Eine Eigenschaftendatei, in der jede Zeile ein property-name=override- oder current-property-value=new-property-value-Paar enthält.
  • Ein Implementierungsdeskriptor, der für die Anwendung neuer Werte auf die Brokerarchivdatei verwendet wird.

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.

-o Ausgabedatei
(Optional) Der Name der BAR-Ausgabedatei, in der die BAR-Dateiänderungen durchgeführt werden sollen. Wenn keine Ausgabedatei angegeben wird, wird die Eingabedatei überschrieben.
-v Tracedateiname
(Optional) Gibt an, dass der interne Trace an die genannte Datei gesendet werden soll.
-y Bibliotheksname
(Optional) Der Name einer Bibliothek in der BAR-Datei, auf die Überschreibungen angewendet werden sollen.

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.

Jede in einem Parameter –p zur Dateiüberschreibung bzw. in einem Parameter –m zur Listenüberschreibung angegebene Überschreibung muss einer der folgenden Syntaxmöglichkeiten entsprechen:
  • Flussname#Knotenname.Eigenschaftsname=NeuerWert (oder Flussname#Eigenschaftsname=NeuerWert für Nachrichtenflusseigenschaften), wobei Folgendes gilt:
    • Flussname ist der Name des Nachrichtenflusses ohne die Erweiterung .cmf (z. B. Flow1).
    • Knotenname ist der optionale Name des Knotens, dessen Eigenschaft überschrieben werden soll (z. B. InputNode).
    • Eigenschaftsname ist der Name der Eigenschaft, die überschrieben werden soll (z. B. 'queueName').
    • NeuerWert ist der Wert, der dieser Eigenschaft zugewiesen werden soll (z. B. PRODUCTION_QUEUE_NAME).
  • AlterWert=NeuerWert. Mit dieser Syntax wird der Eigenschaftswert OldPropertyValue gesucht und ersetzt. Die Wertfelder von AlterWert im Implementierungsdeskriptor werden mit NeuerWert überschrieben.
  • Flussname#Knotenname.Eigenschaftsname (oder Flussname#Eigenschaftsname für Nachrichtenflusseigenschaften). Mit dieser Syntax werden alle neuen Werte entfernt, die für die Eigenschaft des angegebenen Namens gesetzt wurden.
Nach dem Aufruf des Befehls mqsiapplybaroverride wird die verwendete Befehlsversion (Laufzeitumgebung oder WebSphere Message Broker Toolkit) angezeigt, bevor der Befehl ausgeführt wird. Beispiel:
BIP1138I: Overriding BAR File using runtime mqsiapplybaroverride (Überschreiben der BAR-Datei mit dem Laufzeitbefehl mqsiapplybaroverride)

Autorisierung

Auf Systemen unter Windows 7 und Windows Server 2008 muss die Benutzer-ID, unter der dieser Befehl ausgeführt wird, auf dem lokalen System über höhere Rechte verfügen:
  • Die Benutzer-ID muss Mitglied der Gruppe Administratoren sein.
  • Der Befehl muss aus einer Umgebung gestartet werden, in der die Berechtigung Als Administrator ausführen gilt.

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.

Antworten

Dieser Befehl gibt die folgenden Antworten zurück:
0
Der Befehl wurde erfolgreich ausgeführt.
99
Mindestens einer der von Ihnen angegebenen Parameter ist ungültig.
Windows platform 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
...

Beispiele

Brokerarchivdatei myflow.bar öffnen und konfigurierbare Werte im zugehörigen Implementierungsdeskriptor (normalerweise broker.xml) durch die Werte der Eigenschaftendatei mychanges.properties ersetzen:
mqsiapplybaroverride  -b myflow.bar -p mychanges.properties 
Überschreiben der Werte in der Brokerarchivdatei myflow.bar mit den Werten aus der Brokerarchivdatei myOriginalBarFile.bar:
mqsiapplybaroverride -b myflow.bar -p myOriginalBarFile.bar
Aktualisieren der Implementierungsdeskriptoren für Anwendung1 und ihrer referenzierten Bibliotheken aus der Brokerarchivdatei myOriginalBarFile.bar:
mqsiapplybaroverride -b myflow.bar -k Anwendung1 -p myOriginalBarFile.bar
Aktualisieren der Implementierungsdeskriptoren für Anwendung1 und Bibliothek1:
mqsiapplybaroverride -b myflow.bar -k Anwendung1 -y Bibliothek1 -p myOtherBroker.xml
Implementierungsdeskriptor in der Datei c:\test.bar unter Verwendung der in c:\my.properties angegebenen Schlüssel=Wert-Paare ersetzen:
mqsiapplybaroverride -b c:\test.bar -p c:\my.properties 
Implementierungsdeskriptor in c:\test.bar unter Verwendung des Implementierungsdeskriptors in c:\previous.bar ersetzen:
mqsiapplybaroverride –b c:\test.bar –p c:\previous.bar  
Implementierungsdeskriptor in c:\test.bar unter Verwendung des Implementierungsdeskriptors in c:\broker.xml ersetzen:
mqsiapplybaroverride –b c:\test.bar –p c:\broker.xml  
Alle Eigenschaften mit den Werten OLDA und OLDB in c:\test.bar durch die Werte NEWA bzw. NEWB ersetzen:
mqsiapplybaroverride –b c:\test.bar –m OLDA=NEWA,OLDB=NEWB  
Wert des Eigenschaftsnamens sampleFlow#MQInput.queueName durch NEWC ersetzen:
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.

Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2011Copyright IBM Corporation 1999, 2011.

        
        Letzte Aktualisierung
        
        Letzte Aktualisierung : 2012-01-20 09:49:32


ReferenzthemaReferenzthema | Version 8.0.0.0 | an19545_