WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

Befehl mqsicreatebroker - z/OS

Verwenden Sie den Befehl mqsicreatebroker zur Erstellung eines Brokers auf einem z/OS-System.

Syntax

z/OS-Befehl - BIPCRBK

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

>-- -q --Warteschlangenmanager--+------+--+------+-------------->
                                '- -1 -'  '- -2 -'   

>--+-----------------------------+------------------------------>
   '- -l --Pfad_der_Benutzer-LIL-'   

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

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

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

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

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

>--+------------------------------+----------------------------->
   '- -c --Pfad_des_ICU-Umsetzers-'   

>--+------------------------------+--+--------------------+----->
   '- -x --Pfad_für_Benutzerexits-'  '- -s --+-active---+-'   
                                             '-inactive-'     

>--+-----------------------+--+------------------------+-------><
   '- -b --Cacherichtlinie-'  '- -r --Cacheportbereich-'   

Parameter

BrokerName
(Erforderlich) Der Name des Brokers, den Sie erstellen. Dieser Parameter muss der erste Parameter sein. Wenn Sie einen Broker mit einem Namen in Großbuchstaben erstellen, muss dieser im WebSphere Message Broker Toolkit in Großbuchstaben angegeben 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 Warteschlangenmanager mit dem Standardpfad mqm erstellt, wenn dieser Warteschlangenmanager 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

Ist dieser gemeinsam genutzte WS-Managerpfad nicht der richtige ist, müssen Sie den Warteschlangenmanager mit mehreren Instanzen vor Ausführung dieses Befehls auf dem Server erstellen.

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.

-l Pfad_der_Benutzer-LIL
(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.

Die Groß-/Kleinschreibung muss bei diesem Namen beachtet werden; schließen Sie Namen in einfache Anführungszeichen ein, wenn sie in gemischter Groß-/Kleinschreibung vorkommen.

Schließen Sie keine Umgebungsvariablen in diesen Pfad ein; WebSphere Message Broker ignoriert sie.

Sie müssen ein eigenes Verzeichnis zum Speichern der LIL- bzw. JAR-Dateien erstellen. Speichern Sie diese Dateien nicht im WebSphere Message Broker-Installationsverzeichnis.
-P Port_des_HTTP_Empfangsprogramms
(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.

-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 vom 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.

-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.

Ein Intervall von 0 Minuten gibt an, dass das Betriebssystem eine externe Benachrichtigungsmethode (den ENF-Zeitgeber) verwendet und den internen Zeitgeber von WebSphere Message Broker nicht benötigt.

-1
(Optional) Der Registrierungsarbeitsgang, bei dem nur die Brokerregistry erstellt wird.

Sie müssen den Befehl mit Option 1 vor dem Befehl mit Option 2 ausführen, da er sonst fehlschlägt.

-2
(Optional) Der WebSphere MQ-Arbeitsgang, bei dem nur die WebSphere MQ-Warteschlangen für den Broker erstellt werden.
-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 Pfad_des_ICU-Umsetzers
(Optional) Eine Verzeichnisgruppe mit Begrenzern für die Suche nach zusätzlichen Codepageumsetzern.
Die Codepageumsetzer müssen entweder das Format Name_der_Codepage.cnv haben oder in einem ICU-Datenpaket namens icudt48.dat enthalten sein. Sie müssen sich in einem Unterverzeichnis icudt48_<Plattformsuffix> des angegebenen Verzeichnisses befinden. Für <Plattformsuffix> kommen dabei folgende Werte in Frage:
  • l für ASCII-Plattformen mit Little Endian
  • b für ASCII-Plattformen mit Big Endian
  • e für EBCDIC-Plattformen
Verwenden Sie diesen Parameter nicht zum Festlegen des Converter-Pfads, wenn Sie einen Converter verwenden, der einem der integrierten Converter entspricht, die bei Version 6.0 und höher bereitgestellt werden, 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.
-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.

Wenn die Verwaltungssicherheit für den Broker inaktiviert ist, können Webbenutzer als Standardbenutzer mit unbeschränktem Zugriff auf die Daten und die Brokerressourcen auf die Webbenutzerschnittstelle zugreifen.

Weitere Informationen zur Verwendung der Sicherheitsfunktionen finden Sie in den Abschnitten Übersicht über die Verwaltungssicherheit und Benutzer für Verwaltung autorisieren.
-b Cacherichtlinie
(Optional) Die für den Cache-Manager zu verwendende Richtlinie. Setzen Sie diesen Parameter auf default, disabled, none oder den vollständig qualifizierten Namen einer XML-Richtliniendatei.
  • Wenn Sie default angeben, wird die standardmäßige Cacherichtlinie verwendet.
  • Wenn Sie disabled angeben, werden die globalen Cachekomponenten im Broker inaktiviert. Der Cache ist standardmäßig inaktiviert.
  • Wenn Sie none angeben, verwendet der Cache-Manager in jeder Ausführungsgruppe die von Ihnen festgelegten Werte. Die Ausführungsgruppeneigenschaften, die zuletzt von der Richtlinie auf Brokerebene festgelegt wurden, werden als Ausgangspunkt für die Anpassung beibehalten.
  • Wenn Sie den vollständig qualifizierten Namen einer Richtliniendatei angeben, werden die in der Richtliniendatei aufgelisteten Broker für eine gemeinsame Nutzung der Daten im globalen Cache konfiguriert. Es muss ein absoluter Pfad sein, kein relativer.
-r Cacheportbereich
(Optional) Der vom Cache-Manager zu verwendende Portbereich. Setzen Sie diesen Parameter auf generate oder einen bestimmten Portbereich.
  • Wenn Sie einen Portbereich angeben, muss der Wert dieses Parameters das Format xxxx-yyyy haben und der Bereich muss mindestens 20 Ports enthalten.
  • Wenn Sie generate angeben, generiert der Broker einen Portbereich, dessen Ports von keinem anderen Broker auf dem Computer verwendet werden. Der Broker wählt einen Bereich aus, der mit 2800 beginnt. Wenn beispielsweise ein anderer Broker die Ports 2800 bis 2819 verwendet, generiert der Broker einen Bereich von 2820 bis 2839.

Beispiele

Unter z/OS einen Broker mit einem einzigen Befehl erstellen:
mqsicreatebroker CSQ1BRK -q CSQ1 
Einen Broker mit aktivierter Verwaltungssicherheit erstellen:
mqsicreatebroker MB8BROKER -q MB8QMGR -s active
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:21:48


ReferenzthemaReferenzthema | Version 8.0.0.5 | an28120_