Mit dem Befehl mqsideploy können Sie auf Windows-, Linux- und UNIX-Systemen eine Implementierungsanforderung an den Broker absetzen.
Verwenden Sie diese Option, wenn sich mehrere Benutzer mit demselben Broker verbinden möchten, oder wenn Sie erweiterte Verbindungsparameter wie beispielsweise SSL verwenden.
Klicken Sie zur Erstellung dieser Datei mit der rechten Maustaste auf den Broker imWebSphere Message Broker Explorer und wählen Sie *.broker-Datei exportieren aus. Wenn Sie dazu aufgefordert werden, navigieren Sie zu der Position, an der Sie die Datei speichern möchten, und geben Sie den Dateinamen ein; die Erweiterung .broker wird automatisch angehängt, wenn Sie auf Speichern klicken. Geben Sie bei der Festlegung dieses Parameters die Position (den Pfad) und den Dateinamen an. Bei der Ausführung dieses Befehls muss die Position unbedingt zugänglich sein.
Wenn Sie einen Befehl ausführen möchten, der SSL zur Verwaltung eines fernen Brokers über einen gesicherten Kanal verwendet, müssen Sie das Schlüsselspeicher- und Truststore-Kennwort für die Verbindung mithilfe der IBM_JAVA_OPTIONS-Umgebungsvariable angeben. Weitere Informationen finden Sie im Abschnitt Probleme bei der Befehlsausführung beheben.
Nutzen Sie diese Option für Verbindungen mit fernen Brokern, die keine erweiterten Verbindungsparameter erfordern.
Bei Auswahl dieser Option müssen Sie mindestens einen dieser drei Parameter angeben. Die Reihenfolge ist dabei nicht relevant. Kein Parameter darf mehrmals angegeben werden.
Für die nicht angegebenen Parameter werden die Standardwerte übernommen:
Sie können Objekte aller Typen angeben, jedoch bei Angabe eines mehrdeutigen Objektnamens (z. B. "top", wenn sowohl "top.dictionary" als auch "top.cmf" in derselben Ausführungsgruppe implementiert sind) schlägt der Befehl insgesamt fehl, und die Fehlernachricht BIP1089 wird ausgegeben. In einem solchen Fall muss der vollständig qualifizierte Name der Objekte angegeben werden, die entfernt werden sollen, z. B. "top.dictionary:top.cmf".
Wenn die Brokerarchivdatei (BAR-Datei) Ressourcen für andere Anwendungen oder für die Ausführungsgruppe enthält, werden diese Ressourcen ignoriert. Wenn Nachrichtenflüsse, Nachrichtenflussabhängigkeiten oder Bibliotheken vorhanden sind, werden sie ersetzt; sind sie nicht vorhanden, werden sie erstellt. Falls Nachrichtenflüsse, Nachrichtenflussabhängigen oder Bibliotheken zwar in der Brokerkomponente vorhanden, aber nicht in der BAR-Datei enthalten sind, verbleiben sie in der Brokerkomponente.
Für diesen Parameter können Sie einen Wert im Bereich zwischen 1 und 2 145 336 164 festlegen. Wenn Sie keinen Zeitlimitwert angeben oder der Wert kleiner als 1 oder größer als 2 145 336 164, wird ein Fehler zurückgegeben.
Legen Sie für diesen Parameter einen Wert fest, der größer als die Summe der Zeitlimitparameter ConfigurationChangeTimeout und InternalConfigurationTimeout der Konfiguration ist, die Sie für den Broker angegeben haben, um sicherzustellen, dass eine Antwort innerhalb des Zeitlimitwerts zurückgegeben wird. Wenn ein geringerer Wert festgelegt wird, kann in der zurückgegebenen Antwort angezeigt werden, dass der Status der Implementierungsanforderungen unbekannt ist.
Wenn die Brokerarchivdatei (BAR-Datei) Ressourcen für andere Anwendungen oder Bibliotheken oder für die Ausführungsgruppe enthält, werden diese Ressourcen ignoriert. Wenn Nachrichtenflüsse oder Nachrichtenflussabhängigkeiten vorhanden sind, werden sie ersetzt; sind sie nicht vorhanden, werden sie erstellt. Falls Nachrichtenflüsse oder Nachrichtenflussabhängigen zwar in der Brokerkomponente vorhanden, aber nicht in der BAR-Datei enthalten sind, verbleiben sie in der Brokerkomponente.
Wenn Sie die Parameter -k und -y nicht angeben, verweist die Implementierung auf die Ausführungsgruppe. Enthält die BAR-Datei Anwendungen oder Bibliotheken, die in der Brokerkomponente vorhanden sind, werden diese Anwendungen oder Bibliotheken erneut implementiert. Im Rahmen dieser erneuten Implementierung werden die vorhandenen Nachrichtenflüsse und Brokerkomponenten, die in den Anwendungen oder Bibliotheken enthalten sind, gelöscht und die neuen Versionen implementiert.
Anhand der folgenden Beispiele wird gezeigt, wie mit dem Parameter -n die Verbindungsparameter für den Broker definiert werden. Wenn Sie dies vorziehen, können Sie auch die Parameter i, p und q angeben. Wenn sich der Broker auf dem lokalen Computer befindet, kann er namentlich genannt werden.
mqsideploy -n b1.broker -e default -a mybar.bar -m -w 600
mqsideploy –n b1.broker –e default –d top.cmf:bar.dictionary
Die folgenden Beispiele zeigen, wie die Implementierung in Anwendungen und Bibliotheken angegeben wird.
mqsideploy MB8BROKER -e default -a myBar.bar -k myApplication
mqsideploy MB8BROKER -e default -a myBar.bar -k myApplication -y myAppLibrary
Informationen zur Verwendung dieses Befehls mit SSL-geschützten Kanälen finden Sie im Abschnitt Ausführen eines Befehls, der SSL zur Verwaltung eines fernen Brokers über einen gesicherten Kanal verwendet.