Befehl mqsicreatebroker - Linux- und UNIX-Systeme

Verwenden Sie den Befehl mqsicreatebroker zur Erstellung eines Brokers auf einem Linux- oder UNIX-System.

Syntax

Syntaxdiagramm lesenSyntaxdiagramm überspringen
>>-mqsicreatebroker--Brokername--------------------------------->

>-- -q --Name_des_Warteschlangenmanagers------------------------>

>--+-------------------+--+------+--+------+-------------------->
   '- -w --Arbeitspfad-'  '- -t -'  '- -m -'   

>--+-------------------------+---------------------------------->
   '- -l --Benutzer-LIL-Pfad-'   

>--+--------------------------------------------+--------------->
   '- -g --Zeitlimit_der_Konfigurationsänderung-'   

>--+--------------------------------------------+--------------->
   '- -k --Zeitlimit_der_internen_Konfiguration-'   

>--+---------------------------------------+-------------------->
   '- -P --Port_des_HTTP-Empfangsprogramms-'   

>--+-------------------------------+---------------------------->
   '- -v --Statistikhauptintervall-'   

>--+---------------------------------------------------------+-->
   '- -y --LDAP-Principal-- -z --LDAP-Berechtigungsnachweise-'   

>--+------------------------------+----------------------------->
   '- -c --ICU-Konvertierungspfad-'   

>--+------------------------+--+---------------------+---------->
   '- -x --Benutzerexitpfad-'  '- -o --Betriebsmodus-'   

>--+--------------------+--+------------------------------+----->
   '- -s --+-active---+-'  '- -e --gemeinsamerArbeitspfad-'   
           '-inactive-'                                       

>--+---------------------+-------------------------------------><
   '- -d --+-defined---+-'   
           '-undefined-'     

Parameter

Brokername
(Erforderlich) Der Name des Brokers, den Sie erstellen. Dieser Parameter muss an erster Stelle angegeben werden; bei der Angabe muss die Groß-/Kleinschreibung beachtet werden.

Informationen zu Einschränkungen bei Zeichensatz, den Sie verwenden können, finden Sie unter Zulässige Zeichen in Befehlen.

-q Name_des_Warteschlangenmanagers
(Erforderlich) Der Name des WS-Managers (oder bei der Erstellung eines Brokers mit mehreren Instanzen des WS-Managers für mehrere Instanzen), der dieser Brokerinstanz zugeordnet ist. Verwenden Sie für Broker und Warteschlangenmanager denselben Namen, um die Netzverwaltung zu erleichtern. Namen von Warteschlangenmanagern können aus maximal 48 Zeichen bestehen; die Groß-/Kleinschreibung muss beachtet werden.

Standardmäßig wird ein WS-Manager mit dem Pfad mqm erstellt, wenn der WS-Manager noch nicht auf diesem Server vorhanden ist.

Wenn Sie einen Broker mit mehreren Instanzen erstellen, bei dem der WS-Manager noch nicht auf dem Server vorhanden ist, wird im gemeinsamen Arbeitspfad des Brokers mit mehreren Instanzen wie folgt mit dem Befehl WebSphere MQ crtmqm ein WS-Manager für mehrere Instanzen erstellt:
  crtmqm –md /<gemeinsamer Arbeitspfad des Brokers>/mqm/qmdata
         -ld //<gemeinsamer Arbeitspfad des Brokers>/mqm/qmlog queueManagerName

Wenn dieser gemeinsam genutzte WS-Managerpfad nicht geeignet ist, erstellen Sie den WS-Manager für mehrere Instanzen auf dem Server, bevor Sie diesen Befehl ausführen.

Das WS-Manager-Attribut MAXMSGLEN (max. Länge der Nachrichten, die in Warteschlangen eingereiht werden) wird auf 100 MB erhöht. Diese Aktualisierung dieses Attributs geschieht unabhängig davon, ob der Warteschlangenmanager mit diesem Befehl erstellt wurde.

Informationen zu Einschränkungen bei Zeichensatz, den Sie verwenden können, finden Sie unter Zulässige Zeichen in Befehlen.

-w Arbeitspfad
(Optional) Verzeichnis, in dem Arbeitsdaten für diesen Broker gespeichert werden. Wenn dieser Parameter nicht angegeben wird, werden die Dateien im Standardarbeitspfad gespeichert, der bei der Installation des Produkts angegeben wurde. Wenn Sie diesen Parameter angeben, muss dieses Verzeichnis vor dem Starten des Brokers erstellt werden.

Wenn ein Broker mit dem Attribut –e für den Mehrfachinstanzmodus aktiviert wurde, wird der Arbeitspfad (workPath) des Brokers in Daten unterteilt, die speziell für diese Brokerinstanz gelten, und in Daten, die von diesem Broker und seinen zugehörigen Instanzen, welche mit dem Befehl mqsiaddbrokerinstance erstellt wurden, gemeinsam genutzt werden. Die Daten, die speziell für den für mehrere Instanzen aktivierten Broker gelten, werden im Verzeichnis workPath auf dem lokalen Server gespeichert, während die gemeinsam genutzten Daten in einem Verzeichnis des Netzwerkspeichers unter der Position gespeichert werden, die über das Attribut –e angegeben wird.

In diesem Verzeichnis werden auch die Tracesätze gespeichert, die bei aktivierter Tracefunktion erstellt werden. Diese Datensätze werden in das Unterverzeichnis log geschrieben, das vor dem Start des Brokers von Ihnen erstellt werden muss.

Fehlerprotokolle, die vom Broker bei der abnormalen Beendigung von Prozessen erstellt werden, werden ebenfalls in diesem Verzeichnis gespeichert.

Das Fehlerprotokoll hat keine Größenbeschränkung, sein Umfang nimmt also ständig zu. Daher sollten Sie dieses Verzeichnis von Zeit zu Zeit überprüfen und alte Fehlerinformationen löschen.

Dieser Parameter kann nicht mit dem Befehl mqsichangebroker geändert werden. Zur Angabe oder Änderung des Arbeitspfads löschen Sie den Broker und erstellen Sie ihn neu.

Durch die Angabe dieses Parameters wird ein separates Arbeitsverzeichnis für den Broker erstellt. Bei diesem Arbeitsverzeichnis handelt es sich um eine Untergruppe der standardmäßigen Arbeitsverzeichnisstruktur, die weniger Unterverzeichnisse und kein common\profiles-Unterverzeichnis enthält.

-t
(Optional) Der Broker wird als WebSphere MQ-gesicherte Anwendung ausgeführt.

Wenn Sie diesen Parameter unter HP-UX und Solaris verwenden, geben Sie die Servicebenutzer-ID als mqm an.

Weitere Informationen zur Verwendung gesicherter WebSphere MQ-Anwendungen finden Sie im Abschnitt Intercommunication des Dieser Link öffnet ein neues FensterWebSphere MQ Version 7 Information Center online.

-l LIL-Pfad_des_Benutzers
(Optional) Eine Liste mit Pfaden (Verzeichnissen), aus denen der Broker LIL-Dateien (Loadable Implementation Libraries) für benutzerdefinierte Knoten für die Nachrichtenverarbeitung lädt.

Bei Verzeichnisnamen muss die Groß-/Kleinschreibung beachtet werden und sie müssen in einfache Anführungszeichen gesetzt werden, wenn sie Groß- und Kleinbuchstaben enthalten.

Schließen Sie keine Umgebungsvariablen in den Pfad ein; der Broker ignoriert sie.

Erstellen Sie Ihr eigenes Verzeichnis zum Speichern der LIL- bzw. JAR-Dateien erstellen. Diese Dateien sollten nicht im WebSphere Message Broker-Installationsverzeichnis gespeichert werden.

Bei Angabe mehrerer Verzeichnisse müssen diese durch einen Doppelpunkt (:) getrennt werden.

-g Zeitlimit_der_Konfigurationsänderung
(Optional) Die maximale Zeit (in Sekunden), die für die Verarbeitung einer Benutzerkonfigurationsanforderung zulässig ist. Dabei wird die Länge der Zeit definiert, die der Broker zur Anwendung einer von Ihnen initiierten Konfigurationsänderung für eine Ausführungsgruppe benötigt. Wenn Sie beispielsweise eine Konfiguration von der WebSphere Message Broker Toolkit implementieren, muss der Broker innerhalb dieser Zeit auf den Konfigurationsmanager antworten.

Ein Nachrichtenfluss kann nicht auf eine Konfigurationsänderung antworten, während er eine Anwendungsnachricht verarbeitet. Eine Ausführungsgruppe gibt der implementierten Konfigurationsnachricht eine negative Antwort zurück, wenn einer ihrer Nachrichtenflüsse die Verarbeitung einer Anwendungsnachricht nicht abschließt und die Konfigurationsänderung innerhalb dieses Zeitlimits anwendet.

Geben Sie den Wert in Sekunden in einem Bereich von 10 bis 3600 an. Der Standardwert ist 300.

Weitere Informationen zum Festlegen des Werts für dieses Zeitlimit finden Sie unter Zeitlimitwerte für die Konfiguration festlegen.

-k Zeitlimit_der_internen_Konfiguration
(Optional) Die maximale Zeit (in Sekunden), die für die Verarbeitung einer internen Konfigurationsänderung zulässig ist. Dabei wird beispielsweise die Länge der Zeit definiert, die der Broker zum Starten einer Ausführungsgruppe benötigt.

Die Reaktionszeit der einzelnen Ausführungsgruppen hängt von der Systembelastung und von ihrer Prozesslast ab. Der Wert muss die maximale Reaktionszeit einer Ausführungsgruppe wiedergeben. Wenn dabei ein zu niedriger Wert angegeben wird, gibt der Broker eine negative Antwort zurück und schreibt möglicherweise Fehlernachrichten in das lokale Fehlerprotokoll.

Geben Sie den Wert in Sekunden in einem Bereich von 10 bis 3600 an. Der Standardwert ist 60.

Weitere Informationen zum Festlegen des Werts für dieses Zeitlimit finden Sie unter Zeitlimitwerte für die Konfiguration festlegen.

-P HTTP-Empfangsprogrammport
(Optional) Geben Sie die Nummer des Ports an, an dem die Web-Serviceunterstützung empfangsbereit ist.

Der Broker startet dieses Empfangsprogramm, wenn ein Nachrichtenfluss, der HTTP-Knoten oder Web-Service-Unterstützung enthält, gestartet wurde; der Standardwert ist 7080.

Stellen Sie sicher, dass der Port, den Sie angeben, nicht bereits für andere Zwecke eingesetzt ist.

-v Statistikhauptintervall
(Optional) Geben Sie das Zeitintervall (in Minuten) an, in dem Statistik- und Abrechnungsarchivdatensätze geschrieben werden sollen. Es können Intervalle zwischen 1 und 43.200 Minuten angegeben werden, der Standardwert ist 60.
-y LDAP-Principal
(Optional, aber obligatorisch, wenn ldapCredentials angegeben wird.) Der Benutzer-Principal für den Zugriff auf ein optionales LDAP-Verzeichnis, das den vom JNDI verwalteten Ausgangskontext für den JMS-Provider enthält.
-z LDAP-Berechtigungsnachweise
(Optional, aber obligatorisch, wenn ldapPrincipal angegeben wird.) Das Benutzerkennwort für den LDAP-Zugriff.
-c ICU-Konvertierungspfad
(Optional) eine Verzeichnisgruppe (getrennt durch Semikolon (;)) für die Suche nach zusätzlichen Codepageumsetzern.
Verwenden Sie diesen Parameter nicht zum Festlegen des Converter-Pfads, wenn Sie einen Converter verwenden, der einem der bereitgestellten integrierten Converter entspricht, und der Converter die lokale Codepage für den Broker ist. Verwenden Sie stattdessen die Umgebungsvariable ICU_DATA.
-x Benutzerexitpfad
(Optional) Der Pfad, der die Verzeichnisse aller Benutzerexits enthält, die für die Ausführungsgruppen in diesem Broker geladen werden sollen. Dieser Pfad wird nur für den Prozess der Ausführungsgruppe dem Suchpfad für Systembibliotheken (PATH,LIBPATH,LD_LIBRARY_PATH,SHLIBPATH) hinzugefügt.
-o Betriebsmodus
Optional: Mit diesem Parameter können Sie den Modus Ihres Brokers festlegen (weitere Informationen siehe Betriebsmodi). Gültige Werte sind advanced (vollständiges Paket, advanced Modus), standard (Standard Edition Modus), express (Express Edition Modus) und adapter (Remote Adapter Deployment Modus). Der Standardwert ist advanced, außer bei der Trial Edition, für die der Standardwert trial lautet. Wenn Sie den Parameter -o nicht angeben, wird automatisch der Standardwert verwendet.
-s
(Optional) Geben Sie den Status der Verwaltungssicherheit für den Broker an.

Wenn Sie -s active angeben, wird die Verwaltungssicherheit aktiviert. Nur die von Ihnen dazu berechtigten Benutzer-IDs dürfen Aktionen auf dem Broker ausführen. Allen Benutzer-IDs der Sicherheitsgruppe mqbrkrs wird immer Lese-, Schreib- und Ausführungsberechtigung für die Sicherheitswarteschlange SYSTEM.BROKER.AUTH erteilt. Nach der Erstellung des Brokers können dieser Warteschlange weitere Benutzer-ID-Berechtigungen hinzugefügt werden.

Wenn Sie eine Ausführungsgruppe für einen Broker erstellen, für den die Verwaltungssicherheit aktiviert ist, wird die Warteschlange SYSTEM.BROKER.AUTH.Name_der_Ausführungsgruppe erstellt. Dieser Warteschlange müssen Sie die erforderlichen Benutzerberechtigungen hinzufügen.

Wenn Sie -s inactive angeben oder diesen Parameter weglassen, wird die Verwaltungssicherheit für den Broker inaktiviert. In diesem Fall können alle Benutzer alle Aktionen am Broker oder an den Ausführungsgruppen durchführen.

Weitere Informationen zur Verwendung der Sicherheitsfunktionen finden Sie in den Abschnitten Sicherheit der Brokerverwaltung und Berechtigung für die Sicherheit der Brokerverwaltung erteilen und entziehen.
-e gemeinsamerArbeitspfad
(Optional) Durch die Festlegung dieses Werts wird der Broker für den Mehrfachinstanz-Betriebsmodus aktiviert.
Vor dem Start des Brokers müssen Sie sicherstellen, dass der Broker auf diese Netzspeicheradresse zugreifen kann, und dass der WS-Manager für den Broker als ein WebSphere MQ-WS-Manager für mehrere Instanzen konfiguriert wurde. Die in diesem gemeinsam genutzten Verzeichnis gespeicherten Informationen umfassen Folgendes:
  • Das Brokerregister
  • Komponentenverzeichnisse
  • Interne Brokertabellen und Dateien für implementierte Nachrichtenflüsse
  • Konfigurierbare Serviceeigenschaften.
-d
(Optional) Geben Sie an, ob es möglich sein soll, dass ein Broker beim Starten und Stoppen des WS-Managers als WebSphere MQ-Service gestartet bzw. gestoppt wird.

Diese Option ist eine Alternative zum Start eines Brokers mit mehreren Instanzen im Bereitschaftsmodus über den Befehl mqsistart.

Bei der Angabe von -d defined wird der WebSphere MQ-Service im WS-Manager definiert und der Broker wird beim Starten und Stoppen des WS-Managers ebenfalls gestartet bzw. gestoppt.

Bei der Angabe von -d undefined wird der WebSphere MQ-Service im WS-Manager nicht definiert und der Broker wird beim Starten und Stoppen des WS-Managers nicht gestartet bzw. gestoppt. Dies ist die Standardeinstellung.

Beispiele

Einen Broker erstellen, der als sichere Anwendung ausgeführt werden soll:
mqsicreatebroker MB8BROKER 
	-q MB8QMGR -t
Einen Broker erstellen, der auf Benutzerexits verweist:
mqsicreatebroker MB8BROKER 
	-q MB8QMGR -x /opt/3rdparty/wmbexits
Einen Broker mit aktivierter Verwaltungssicherheit erstellen:
mqsicreatebroker MB8BROKER 
	-q MB8QMGR -s active
Broker unter Verwendung des Multi-Instanz-Warteschlangenmanagers MyQMGR und des gemeinsamen Arbeitspfads MyNetworkSharedWorkpath erstellen, der als WebSphere MQ-Service gestartet wird:
mqsicreatebroker MB8BROKER 
	-q MyQmgr -e MyNetworkSharedWorkpath -d defined
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2011Copyright IBM Corporation 1999, 2011.

        
        Letzte Aktualisierung
        
        Letzte Aktualisierung : 2012-01-20 09:49:37


ReferenzthemaReferenzthema | Version 8.0.0.0 | an28135_