Mit dem Befehl mqsicreatebar können implementierbare Brokerarchivdateien erstellt werden, die Nachrichtenflüsse und Wörterverzeichnisse enthalten.
Wenn Sie Ihre Nachrichtenflüsse und Wörterverzeichnisse in einem Repository speichern, können Sie mithilfe des Befehls mqsicreatebar und der Befehlszeilentools des Repositorys Scripts für die Implementierung der Nachrichtenflussanwendungen schreiben.
>>-mqsicreatebar-- -data--Arbeitsbereich-- -b -BAR-Name---------> >--+--------------+--+---------------------------------+--------> '- -cleanBuild-' '- -version -Versionszeichenfolge-' .----------------------. V | >--+----------+----+------------------+-+-----------------------> '- -Esql21-' '- -p -Projektname-' >--+---------------------+--+------------------+----------------> '- -a -Anwendungsname-' '- -deployAsSource-' >--+---------------+--+----------------------+------------------> '- -compileOnly-' '- -l -Bibliotheksname-' >--+----------------------------+--+----------------+-----------> '- -d -Anwendungsdomänenname-' '- -o -Dateipfad-' >--+--------------------+--+------------------------------+---->< '- -skipWSErrorCheck-' '- -trace - -v -Tracedateipfad-'
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.
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.
-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'

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.
-compileOnly
(Optional) Schließen Sie diesen Parameter ein, um Nachrichtengruppen und
Java-Code zu kompilieren, bevor Sie den Befehl
mqsipackagebar ausführen. Weitere Informationen zum
Befehl mqsipackagebar finden Sie im Abschnitt
Befehl mqsipackagebar.
Sie können mehrere Bibliotheken hinzufügen, indem Sie folgendes Format verwenden: -l Bibliotheksname1 Bibliotheksname2 .... Bibliotheksname'n'
-d Anwendungsdomänenname
(Optional) Der Name einer .NET-Anwendungsdomäne, die zur BAR-Datei hinzugefügt werden
soll.Sie können mehrere Anwendungsdomänen hinzufügen, indem Sie folgendes Format verwenden: -d Anwendungsdomänenname1 Anwendungsdomänenname2 .... Anwendungsdomänenname1'n'

Sie können mehrere implementierbare Dateien zu diesem Befehl hinzufügen, indem Sie folgendes Format verwenden: -o Dateipfad1 Dateipfad2 .... Dateipfad 'n'
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.
Bei Angabe des Dateinamens oder relativen Pfads wird die Datei im Standardarbeitsverzeichnis erstellt. Wenn dieser Parameter angegeben werden soll, muss auch der Parameter -trace gesetzt werden. Der Parameter -v kann nicht allein angegeben werden.
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.
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.
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.
mqsicreatebar -data C:\Workspace -b myflow.bar -p TestFlowProject -o TestFlowProject\TestFlow\Test.msgflow
mqsicreatebar -data C:\Workspace -b C:\myfiles\myflow.bar -p TestFlowProject -o TestFlowProject\TestFlow\Test.msgflow -deployAsSource
mqsicreatebar -data C:\Workspace -b mySet.bar -o TestSetProject\TestSet\messageSet.mset
mqsicreatebar -data C:\Workspace -b mySet.bar -o TestFlowProject\TestFlow\Test.msgflow
TestSetProject\TestSet\messageSet.mset
mqsicreatebar -data C:\Workspace -b myflow.bar -a Application1 -trace