Mit dem Befehl mqsicreatebar können implementierbare Brokerarchivdateien erstellt werden, die Nachrichtenflüsse und Wörterverzeichnisse enthalten.
Wenn Sie ein Repository zum Speichern Ihrer Nachrichtenflüsse und Wörterverzeichnisse verwenden, können Sie Scripts schreiben, die den Befehl mqsicreatebar und die Befehlszeilentools des Repositorys für die Implementierung Ihrer Nachrichtenflussanwendungen nutzen.
>>-mqsicreatebar-- -data--Arbeitsbereich--+---------------+-----> '- -b -BAR-Name-' >--+--------------+--+---------------------------------+--------> '- -cleanBuild-' '- -version -Versionszeichenfolge-' >--+----------+--+--------------------------+-------------------> '- -Esql21-' | .-----------------. | | V | | '- -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.
Dieser Parameter ist erforderlich, wenn der Parameter -compileOnly nicht verwendet wird.
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 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. Wenn dieser Parameter enthalten ist, wird statt der standardmäßigen implementierbaren ESQL Inline-ESQL erstellt.
Wird der Parameter -deployAsSource verwendet, werden alle anwendbaren Ressourcen als Quellendateien zur Brokerarchivdatei hinzugefügt und nicht in Nachrichtenflussdateien (.cmf-Dateien) kompiliert.
Es ist nicht möglich, sowohl die kompilierte Version (.cmf) als auch die Quellenversion (.msgflow) eines Nachrichtenflusses in eine BAR-Datei aufzunehmen.
Wird dieser Parameter mit dem Parameter -b und mindestens einem der Parameter -a, -l, -d oder -o angegeben, generiert der Befehl sowohl die kompilierten Ressourcen als auch die angegebene BAR-Datei.
Sie können mehrere Bibliotheken hinzufügen, indem Sie folgendes Format verwenden: -l Bibliotheksname1 Bibliotheksname2 .... Bibliotheksname'n'
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