Befehl mqsicreatebar

Mit dem Befehl mqsicreatebar können implementierbare Brokerarchivdateien erstellt werden, die Nachrichtenflüsse und Wörterverzeichnisse enthalten.

Unterstützte Plattformen

  • Windows
  • Linux on x86

Zweck

Wenn die Nachrichtenflüsse und Wörterverzeichnisse in einem Repository gespeichert werden, können Sie Scripts schreiben, um die Nachrichtenflussanwendungen über den Befehl mqsicreatebar und die Befehlszeilentools des Repositorys zu implementieren.

Syntax

Format des Syntaxdiagramms      Pfeildiagram      Nummeriert

Parameter

-data Arbeitsbereich
(Erforderlich) Pfad zum Arbeitsbereich, in dem Ihre Projekte erstellt werden.

Die Position des Arbeitsbereichs ist auch die Standardposition für Projekte. Relative Pfade werden als relativ zu dem Verzeichnis interpretiert, in dem der Befehl gestartet wurde.

-b BAR-Dateiname
(Erforderlich) Der Name der Brokerarchivdatei (komprimiertes Dateiformat), in der das Ergebnis gespeichert wird. Die Brokerarchivdatei wird ersetzt, wenn sie bereits vorhanden ist und die Datei META-INF/broker.xml erstellt wird.
-cleanBuild
(Optional) Aktualisiert die Projekte im Arbeitsbereich und ruft anschließend ein bereinigten Build auf, bevor neue Elemente zur Brokerarchivdatei hinzugefügt werden.
Verwenden Sie den Parameter -cleanBuild , um alle Projekte in der Brokerarchivdatei zu aktualisieren und einen bereinigten Build auszuführen, wenn Sie BAR-Dateiressourcen unter Verwendung von externen Tools geändert haben.
-version Versionszeichenfolge
(Optional) Fügt vor der Dateierweiterung das Unterstreichungszeichen (_) und die Versionszeichenfolge an die Namen der kompilierten Versionen des Nachrichtenflusses (.cmf-Dateien) an, die der BAR-Datei hinzugefügt werden.
-Esql21
(Optional) Kompilieren Sie ESQL für Broker auf Produktversion 2.1.
-p Projektname
(Optional) Projekte, die Dateien enthalten, die in einem neuen Arbeitsbereich in die BAR-Datei aufgenommen werden sollen. Ein neuer Arbeitsbereich ist ein Systemordner ohne den Ordner .metadata.

Die definierten Projekte müssen bereits in dem im Parameter -data angegebenen Ordner enthalten sein. Der Ordner muss alle Projekte und Referenzprojekte enthalten, die die im Parameter -o definierten implementierbaren Ressourcen benötigen.

Bei einem vorhandenen Arbeitsbereich ist der Parameter -p optional, in einer Erstellungsumgebung sollte der Parameter jedoch mit einem neuen Arbeitsbereich verwendet werden.

Falls ein angegebenes Projekt zwar Teil des Arbeitsbereichs jedoch geschlossen ist, wird es mit dem Befehl geöffnet und aufgebaut, damit die Dateien in dem Projekt in die BAR-Datei aufgenommen werden können.

-o Dateipfad
(Optional) Der relative Arbeitsbereichspfad (einschließlich Projekt) einer Datei des Typs msgflow oder messageSet.mset, die der Brokerarchivdatei hinzugefügt werden soll.

Sie können mehrere implementierbare Dateien zu diesem Befehl hinzufügen, indem Sie folgendes Format verwenden: -o Dateipfad1 Dateipfad2 .... Dateipfad 'n'

-a Anwendungsname
(Optional) Der Name einer Anwendung, die der BAR-Datei hinzugefügt werden soll.

Sie können mehrere Anwendungen hinzufügen, indem Sie folgendes Format verwenden: -a Anwendungsname1 Anwendungsname2 .... Anwendungsname'n'

-l Bibliotheksname
(Optional) Der Name einer Bibliothek, die der BAR-Datei hinzugefügt werden soll.

Sie können mehrere Bibliotheken hinzufügen, indem Sie folgendes Format verwenden: -l Bibliotheksname1 Bibliotheksname2 .... Bibliotheksname'n'

-deployAsSource
(Optional) Schließen Sie diesen Parameter ein, um anwendbare Ressourcendateien zu implementieren, ohne sie zu kompilieren.

Bei Verwendung des Befehls mqsicreatebar werden Ressourcen wie .esql-Dateien in Nachrichtenflussdateien (.cmf-Dateien) kompiliert und nicht als einzelne Quellendateien zur Brokerarchivdatei hinzugefügt.

Wird der Parameter -deployAsSource verwendet, werden alle anwendbaren Ressourcen als Quellendateien zur Brokerarchivdatei hinzugefügt und nicht in Nachrichtenflussdateien (.cmf-Dateien) kompiliert.

-trace
(Optional) Dieser Parameter zeigt Traceinformationen für eine BAR-Dateikompilierung an.

Der Parameter -trace schreibt Traceinformationen in der durch die Systemländereinstellung festgelegten Sprache in den Systemausgabedatenstromparameter. Wenn Sie der BAR-Datei eine oder mehrere Anwendungen oder Bibliotheken hinzufügen, werden die angegebene Anwendung oder Bibliothek und alle referenzierten Projekte im Arbeitsbereich geöffnet. Die Tracefunktion zeichnet diese Informationen auf, damit Sie feststellen können, ob referenzierte Projekte fehlen.

-skipWSErrorCheck
(Optional) Selbst wenn Fehler im Arbeitsbereich vorhanden sind, erzwingt dieser Parameter die Ausführung des Kompilierungsprozesses der BAR-Datei.

Berechtigung

Auf Systemen unter Windows XP und Windows Server 2003 muss die Benutzer-ID, unter der dieser Befehl ausgeführt wird, Mitglied der Gruppe Administratoren auf dem lokalen System sein.

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.

Unter Linux on x86 muss die Benutzer-ID über Schreibzugriff auf die Verzeichnisse -data (Arbeitsbereich) und -b (Speicherposition der Brokerarchivdatei) verfügen.

Antworten

Dieser Befehl gibt die folgenden Antworten zurück:
  • BIP0956 Der Befehl 'mqsicreatebar' kann nicht gestartet werden
  • BIP0957 Falsche Argumente für Befehl 'mqsicreatebar' angegeben
  • BIP0958 'mqsicreatebar' kann keine Aktionen ausführen
  • BIP0959 Falsche Argumente für Befehl 'mqsicreatebar' angegeben (Projektname)
  • BIP0960 Falsche Argumente für Befehl 'mqsicreatebar' angegeben (Projektverzeichnis)
  • BIP0961 Fehler beim Öffnen des Arbeitsbereichs in 'mqsicreatebar' (Projekt konnte nicht erstellt werden)
  • BIP0962 Fehler beim Öffnen des Arbeitsbereichs in 'mqsicreatebar' (Projekt konnte nicht geöffnet werden)
  • BIP0963 Fehler beim Speichern der Datei 'mqsicreatebar'
  • BIP0964 Falsches Argument "-o" in Befehl 'mqsicreatebar' angegeben
  • BIP0965 Fehler beim Kompilieren von Dateien in 'mqsicreatebar'

Beispiele

Sie müssen den Befehl im Verzeichnis eclipse ausführen. Die Standardposition des Verzeichnisses eclipse ist C:\Programme\IBM\WMBT800\eclipse unter Windows 32–Bit-Editionen, C:\Programme(x86)\IBM\WMBT800\eclipse unter Windows 64–Bit-Editionen und /opt/IBM/WMBT800/eclipse unter Linux on x86.

Im folgenden Beispiel wird eine Brokerarchivdatei namens myflow.bar im Arbeitsbereich im Verzeichnis C:\Workspace erstellt. Der Brokerarchivdatei wird der Nachrichtenfluss Test.msgflow aus TestFlowProject hinzugefügt.
mqsicreatebar -data C:\Workspace -b myflow.bar -p TestFlowProject -o TestFlowProject\TestFlow\Test.msgflow
Im folgenden Beispiel wird eine Brokerarchivdatei namens myflow.bar im Arbeitsbereich im Verzeichnis C:\Workspace erstellt. Der Nachrichtenfluss Test.msgflow aus dem TestFlowProject wird zur Brokerarchivdatei hinzugefügt und alle anwendbaren Ressourcendateien werden zur Brokerarchivdatei hinzugefügt, ohne kompiliert zu werden.
mqsicreatebar -data C:\Workspace -b myflow.bar -p TestFlowProject -o TestFlowProject\TestFlow\Test.msgflow -deployAsSource
Im folgenden Beispiel wird eine Brokerarchivdatei namens mySet.bar im Arbeitsbereich im Verzeichnis C:\Workspace erstellt. Der Brokerarchivdatei wird die Nachrichtengruppe messageSet.mset aus TestSetProject hinzugefügt.
mqsicreatebar -data C:\Workspace -b mySet.bar -o TestSetProject\TestSet\messageSet.mset
Im folgenden Beispiel wird eine Brokerarchivdatei namens mySet.bar im Arbeitsbereich im Verzeichnis C:\Workspace erstellt. Der Brokerarchivdatei werden die Nachrichtengruppe messageSet.mset aus TestSetProject und der Nachrichtenfluss Test.msgflow aus TestFlowProject hinzugefügt.
mqsicreatebar -data C:\Workspace -b mySet.bar -o TestFlowProject\TestFlow\Test.msgflow
TestSetProject\TestSet\messageSet.mset 
Im folgenden Beispiel wird eine Brokerarchivdatei namens myflow.bar im Arbeitsbereich im Verzeichnis C:\Workspace erstellt. Der Brokerarchivdatei wird die Anwendung Application1 hinzugefügt. Die Tracefunktion wird aktiviert.
mqsicreatebar -data C:\Workspace -b myflow.bar -a Application1 -trace
Bemerkungen | Marken | Dieser Link öffnet ein neues Fenster Downloads | Dieser Link öffnet ein neues Fenster Bibliothek | Dieser Link öffnet ein neues Fenster Support | Feedback

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

        
        Letzte Aktualisierung
        
        Letzte Aktualisierung : 2011-11-04 19:54:46


ReferenzthemaReferenzthema | Version 8.0.0.0 | an19540_