Befehl mqsiapplybaroverride

Mit dem Befehl mqsiapplybaroverride können konfigurierbare Werte im Deploymentdeskriptor 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 Brokerdeploymentdeskriptors 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------------------------>

>--+----------------------+--+--------------------+------------->
   '- -m --NeueWerteListe-'  '- -o --Ausgabedatei-'   

>--+----------------------+--+----------------------+----------><
   '- -p --NeueWerteDatei-'  '- -v --Tracedateiname-'   

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.
-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.
-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.
-p NeueWerteDatei
(Optional) Der Pfad zu einer der folgenden Ressourcen:
  • Eine BAR-Datei mit dem Deploymentdeskriptor, der für Überschreibungen in der BAR-Datei angewendet wird.
    Sie können XML für die Deploymentdeskriptordatei verwenden. Bei Verwendung einer in EBCDIC unter z/OS geschriebenen XML-Eigenschaftendatei müssen alle encoding="UTF-8"-Einträge aus dem XML-Header entfernt werden; erforderlich ist beispielsweise eine Änderung von
    <?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 Deploymentdeskriptor, der für die Anwendung neuer Werte auf die Brokerarchivdatei verwendet wird.
-v Tracedateiname
(Optional) Gibt an, dass der interne Trace an die genannte Datei gesendet werden soll.

In allen Fällen wird ein in der BAR-Datei enthaltener Deploymentdeskriptor 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 Deploymentdeskriptor 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.
Anmerkung: Variablen und Kommentare sind in Eigenschaftendateien nicht zulässig.
Bei der Ausführung des Befehls mqsiapplybaroverride wird zuerst die Version des verwendeten Befehls (Laufzeitumgebung oder WebSphere Message Broker Toolkit) angezeigt. Beispiel:
BIP1138I: Overriding BAR File using runtime mqsiapplybaroverride (Überschreiben der BAR-Datei mit dem Laufzeitbefehl mqsiapplybaroverride)

Autorisierung

Auf Systemen unter Windows 7, Windows Vista 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 Deploymentdeskriptor (normalerweise broker.xml) durch die Werte der Eigenschaftendatei mychanges.properties ersetzen:
mqsiapplybaroverride  -b myflow.bar -p mychanges.properties 
Deploymentdeskriptor 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 
Deploymentdeskriptor in c:\test.bar unter Verwendung des Deploymentdeskriptors in c:\previous.bar ersetzen:
mqsiapplybaroverride –b c:\test.bar –p c:\previous.bar  
Deploymentdeskriptor in c:\test.bar unter Verwendung des Deploymentdeskriptors 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, 2012Copyright IBM Corporation 1999, 2012.

        
        Letzte Aktualisierung
        
        Letzte Aktualisierung : 2012-08-06 17:57:59


ReferenzthemaReferenzthema | Version 7.0.0.5 | an19545_