Befehl 'mqsiapplybaroverride'

Unterstützte Plattformen

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

Zweck

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

Erstellen Sie Scripts zum Erstellen von Brokerarchivdateien und wenden Sie neue Werte in der Implementierungsdeskriptorarchivdatei des Brokers an, indem Sie die Befehle mqsiapplybaroverride und mqsicreatebar ausführen.

Syntax

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.
-p NeueWerteDatei
(Optional) Der Pfad eines der folgenden Objekte:
  • Ein Brokerarchiv mit dem Implementierungsdeskriptor, der für die Anwendung neuer Werte auf die BAR-Datei verwendet wird.
  • 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 BAR-Datei verwendet wird.
-m NeueWerteListe
(Optional) Eine Liste der 'property-name=override'-Paare, 'current-property-value=override'-Paare (oder einer Kombination aus beiden), 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 (" ") stehen. Bei Verwendung in Verbindung mit dem Parameter -p werden neue Werte, die mit dem Parameter -m angegeben werden, erst angewendet, nachdem alle mit dem Parameter -p angegebenen neuen Werte angewendet wurden.
-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.

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.

Jeder neue Wert, der in einer mit dem Parameter –p angegebenen Datei oder einer mit dem Parameter –m angegebenen Liste enthalten ist, muss einer der folgenden Syntaxen 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. Fluss1)
    • Knotenname ist der optionale Name des Knotens, dessen Eigenschaft überschrieben wird (z. B. InputNode)
    • Eigenschaftsname ist der Name der Eigenschaft, die überschrieben wird (z. B. queueName)
    • NeuerWert ist der Wert, der dieser Eigenschaft zugewiesen werden soll (z. B. PRODUCTION_QUEUE_NAME).
  • AlterWert=NeuerWert. Bewirkt, dass der Eigenschaftswert AlterWert global gesucht und ersetzt wird. Die Wertfelder von AlterWert im Implementierungsdeskriptor werden mit NeuerWert überschrieben.
  • Flussname#Knotenname.Eigenschaftsname (oder Flussname#Eigenschaftsname für Nachrichtenflusseigenschaften). Entfernt alle neuen Werte, die auf die Eigenschaft mit dem angegebenen Namen angewendet wurden.
Beim Aufruf des Befehls mqsiapplybaroverride wird die verwendete Version des Befehls (Laufzeit oder Toolkit) angezeigt, bevor er ausgeführt wird. Beispiel:
BIP1138I: Overriding BAR File using runtime mqsiapplybaroverride (Überschreiben der BAR-Datei mit dem Laufzeitbefehl mqsiapplybaroverride)

Autorisierung

Auf allen Plattformen muss die Benutzer-ID, unter der dieser Befehl abgesetzt wird, über Schreibberechtigung für die BAR-Datei auf dem lokalen System verfügen.

Antworten

Dieser Befehl gibt die folgenden Antworten zurück:
0
(Success) Die Anforderung wurde erfolgreich ausgeführt.
2
(Failure) Der Befehl ist fehlgeschlagen.
99
Die übergebenen Parameter sind 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

Öffnen der BAR-Datei myflow.bar und Ersetzen konfigurierbarer Werte im Implementierungsdeskriptor (normalerweise broker.xml) durch die in der Eigenschaftendatei mychanges.properties angegebenen Werte:
mqsiapplybaroverride  -b myflow.bar -p mychanges.properties 
Überschreiben des Implementierungsdeskriptors in 'c:\test.bar' mit den in 'c:\my.properties' angegebenen Schlüssel=Wert-Paaren:
mqsiapplybaroverride -b c:\test.bar -p c:\my.properties 
Überschreiben des Implementierungsdeskriptors in 'c:\test.bar' mit dem in 'c:\previous.bar' enthaltenen Implementierungsdeskriptor:
mqsiapplybaroverride mqsiapplybaroverride –b c:\test.bar –p c:\previous.bar  
Überschreiben des Implementierungsdeskriptors in 'c:\test.bar' mit dem in 'c:\broker.xml' enthaltenen Implementierungsdeskriptor:
mqsiapplybaroverride mqsiapplybaroverride –b c:\test.bar –p c:\broker.xml  
Überschreiben aller Eigenschaften mit den Werten OLDA und OLDB in 'c:\test.bar' durch die Werte NEWA bzw. NEWB:
mqsiapplybaroverride mqsiapplybaroverride –b c:\test.bar –o OLDA=NEWA:OLDB=NEWB  
Überschreiben des Wertes der Eigenschaft 'sampleFlow#MQInput.queueName' durch NEWC:
mqsiapplybaroverride mqsiapplybaroverride –b c:\test.bar –o sampleFlow#MQInput.queueName=NEWC  

Ein Beispiel für den Inhalt einer Eigenschaftendatei finden Sie im Abschnitt Konfigurierbare Eigenschaften bearbeiten.

Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
an19545_