Mit dem Befehl mqsicreatebar können implementierbare Brokerarchivdateien erstellt werden, die Nachrichtenflüsse und Wörterverzeichnisse enthalten.
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.
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.
Sie können mehrere implementierbare Dateien zu diesem Befehl hinzufügen, indem Sie folgendes Format verwenden: -o Dateipfad1 Dateipfad2 .... Dateipfad 'n'
Sie können mehrere Anwendungen hinzufügen, indem Sie folgendes Format verwenden: -a Anwendungsname1 Anwendungsname2 .... Anwendungsname'n'
Sie können mehrere Bibliotheken hinzufügen, indem Sie folgendes Format verwenden: -l Bibliotheksname1 Bibliotheksname2 .... Bibliotheksname'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.
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.
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.
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.
mqsicreatebar -data C:\Workspace -b myflow.bar -p TestFlowProject -o TestFlowProject\TestFlow\Test.msgflow
mqsicreatebar -data C:\Workspace -b 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