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 Sie Ihre Nachrichtenflüsse und Wörterverzeichnisse in einem Repository speichern, können Sie Scripts schreiben, die den Befehl mqsicreatebar und die Befehlszeilentools des Repositorys für die Implementierung der Nachrichtenflussanwendungen verwenden.

Syntax

Syntaxdiagramm lesenSyntaxdiagramm überspringen
>>-mqsicreatebar-- -data -Arbeitsbereich-- -b -BAR-Name--------->

>--+--------------+--+---------------------------------+-------->
   '- -cleanBuild-'  '- -version -Versionszeichenfolge-'   

                 .----------------------.   
                 V                      |   
>--+----------+----+------------------+-+----------------------->
   '- -Esql21-'    '- -p -Projektname-'     

        .---------------.   
        V               |   
>-- -o -----Dateipfad---+--------------------------------------><

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 BAR-Datei (komprimierte Archivdatei), 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
(Erforderlich) Der relative Pfad des Arbeitsbereichs (einschließlich des Projekts) einer implementierbaren Datei, die der BAR-Datei hinzugefügt werden soll (beispielsweise ein msgflow- oder messageSet.mset-Datei).

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

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

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

Der Befehl mqsicreatebar kann aus einem Fenster, das an beliebiger Stelle in der Dateistruktur geöffnet wird, ausgeführt werden, sofern die Umgebungsvariable PATH den richtigen Pfad zum Verzeichnis WMB toolkit angibt.
  • Bei 32-Bit-Editionen von Windows ist C:\Programme\IBM\WMBT700 die Standardposition des Verzeichnisses WMB toolkit.
  • Bei 64-Bit-Editionen von Windows ist die Standardposition C:\Programme(x86)\IBM\WMBT700.
  • Bei Linux on x86 ist die Standardposition /opt/IBM/WMBT700.
Ihre Installation verwendet unter Umständen eine andere Standardeinstellung.

Der Parameter -b gibt den Namen der BAR-Datei und einen optionalen alternativen Pfad für die Generierung der BAR-Datei an. Wenn mit dem Parameter -b kein Pfad angegeben wird, ergibt sich aus der Position in der Dateistruktur, an der Sie den Befehl mqsicreatebar ausführen, wo die Brokerarchivdatei erstellt wird. Wenn Sie sich beispielsweise gerade im Verzeichnis C:\> befinden und den Befehl mqsicreatebar ausführen, wird die Brokerarchivdatei in C:\ erstellt. Wenn Sie den Befehl mqsicreatebar jedoch unter Angabe des Parameters -b c:\myfiles\myflow.bar ausführen, wird die Brokerarchivdatei im Verzeichnis myfiles erstellt.

Im folgenden Beispiel wird eine Brokerarchivdatei namens myflow.bar in dem Verzeichnis erstellt, in dem der Befehl ausgeführt wird. Der Nachrichtenfluss Test.msgflow aus TestFlowProject wird der BAR-Datei als kompilierte Nachrichtenflussdatei (.cmf) hinzugefügt.
mqsicreatebar -data C:\Workspace -b myflow.bar -p TestFlowProject -o TestFlowProject\TestFlow\Test.msgflow
Im folgenden Beispiel wird eine Brokerarchivdatei namens mySet.bar 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 erstellt. Der Brokerarchivdatei werden die Nachrichtengruppe messageSet.mset aus TestSetProject und der Nachrichtenfluss Test.msgflow aus TestFlowProject hinzugefügt. Der Nachrichtenfluss wird als kompilierte Nachrichtenflussdatei (.cmf) hinzugefügt.
mqsicreatebar -data C:\Workspace -b mySet.bar -o TestFlowProject\TestFlow\Test.msgflow
TestSetProject\TestSet\messageSet.mset 
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

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


ReferenzthemaReferenzthema | Version 7.0.0.5 | an19540_