- brokerName
- (Erforderlich) Der Name des Brokers, den Sie erstellen. Dieser Parameter muss der erste Parameter sein. Unter Linux- und UNIX-Systemen muss für ihn Groß-/Kleinschreibung beachtet werden.
Informationen zu Einschränkungen bei Zeichensatz, den Sie verwenden können, finden Sie unter Zulässige Zeichen in Befehlen.
- -i Servicebenutzer-ID
-
Die Benutzer-ID, unter der Komponenten ausgeführt werden. Die Servicebenutzer-ID kann mit jeder gültigen Benutzernamenssyntax angegeben werden. Auf Windows-Systemen sind folgende Formate gültig:
- Domäne\Benutzername
- \\Server\Benutzername
- .\Benutzername
- Benutzername
Auf Linux- und
UNIX-Systemen ist nur das letztere Format
(Benutzername) zulässig.
Wenn Sie auf Windows-Systemen das unqualifizierte Format dieser Benutzer-ID (Benutzername) verwenden, durchsucht das Betriebssystem seine Domänen nach dieser Benutzer-ID und beginnt dabei auf dem lokalen System. Dieser Suchvorgang kann einige Zeit in Anspruch nehmen.
Die angegebene Benutzerservice-ID muss zur lokalen Gruppe mqbrkrs gehören. Auf Windows-Systemen kann die ID ein direktes oder indirektes Mitglied der Gruppe sein. Die Servicebenutzer-ID muss außerdem Zugriff auf das Ausgangsverzeichnis (in dem WebSphere Message Broker installiert ist) und auf das Arbeitsverzeichnis (wenn der Parameter -w angegeben wurde) haben.
Wenn Sie auf Windows-Systemen angeben, dass der Broker als gesicherte WebSphere MQ-Anwendung ausgeführt werden soll (Parameter -t), muss die Servicebenutzer-ID auch der Gruppe mqm hinzugefügt werden. Geben Sie auf Linux- und UNIX-Systemen als Servicebenutzer-ID mqm an, wenn Sie den Parameter -t festlegen.
Weitere Informationen zu den Sicherheitsanforderungen für die Servicebenutzer-ID finden Sie in den Abschnitten Sicherheitsanforderungen für Windows-Plattformen und Sicherheitsanforderungen für Linux- und UNIX-Plattformen.
- -a Servicekennwort
- (Erforderlich) Kennwort für die Servicebenutzer-ID.
Um die Kompatibilität mit vorhandenen Systemen sicherzustellen, können Sie <Kennwort> angeben.
Wird jedoch bei Ausführung des Befehls kein Kennwort für diesen Parameter angegeben, werden Sie beim Aufrufen des Befehls aufgefordert, ein Kennwort anzugeben und dieses anschließend noch ein zweites Mal einzugeben, um sicherzustellen, dass es korrekt eingegeben wurde.
Auf Linux- und UNIX-Systemen ist -a für die Kompatibilität mit Windows-Systemen erforderlich, wird aber nicht in Relation mit ServiceUserID verwendet; -a wird nur als Standard verwendet, wenn -p nicht angegeben wird. (Weitere Informationen hierzu finden Sie in der Beschreibung des Parameters -p.)
- -q Warteschlangenmanager
- (Erforderlich) Der Name des Warteschlangenmanagers, der diesem Broker 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.
Für jeden Broker ist ein eigener Warteschlangenmanager unbedingt erforderlich. Ein Broker kann keinen Warteschlangenmanager gemeinsam mit anderen Brokern nutzen.
Falls der Warteschlangenmanager nicht bereits vorhanden ist, wird er durch diesen Befehl erstellt. Er wird nicht als Standard-Warteschlangenmanager erstellt; ist dieser Warteschlangenmanager auf diesem System als Standard-Warteschlangenmanager vorgesehen, erstellen Sie entweder den Warteschlangenmanager, bevor Sie diesen Befehl eingeben, oder ändern Sie die Einstellungen dieses Warteschlangenmanagers, so dass er als Standard-Warteschlangenmanager eingerichtet wird, nachdem er erstellt wurde. Verwenden Sie je nach WebSphere MQ-Version den WebSphere MQ Explorer oder das WebSphere MQ Services-Snap-in.
Das WS-Manager-Attribut MAXMSGLN (max. Länge der Nachrichten, die in Warteschlangen eingereiht werden können) 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.
- -n Datenquelle
- (Erforderlich) Der ODBC-Datenquellenname (DSN) der Datenbank, in der die Brokertabellen erstellt werden. Wenn Sie für den DSN und die Datenbank unterschiedliche Namen verwendet haben, muss über diesen Parameter der DSN und nicht der Name der Datenbank angegeben werden.
Diese Datenbank muss bereits vorhanden sein. Für diesen DSN muss eine System-DSN-ODBC-Verbindung hergestellt werden, falls dies noch nicht geschehen ist.
Wenn Sie eine DB2-Datenbank unter Linux verwenden, geben Sie den entsprechenden Aliasnamen der DB-Datenbank an; die Angabe eines ODBC-DSN ist nicht erforderlich.
- -u Datenquellenbenutzer-ID
- (Optional) Die Benutzer-ID, mit der auf Datenbanken, die Brokertabellen und
Benutzerdaten enthalten, zugegriffen wird. Wird keine ID angegeben, wird standardmäßig der
über -i angegebene Wert übernommen.
Diese Benutzer-ID muss die Berechtigung
haben, Tabellen in der Datenbank zu erstellen, und sie muss Lese- und Schreibzugriff auf diese
Tabellen haben.
Wenn auf
Windows-Systemen Ihre Brokerdatenbank in
DB2 vorhanden und diese Benutzer-ID
DB2 aber nicht bekannt ist, wird sie für Sie in
DB2 erstellt.
Auf
Linux- und
UNIX-Systemen muss dem Servicebenutzer vor Ausführung dieses
Befehls das korrekte Zugriffsrecht erteilt werden. Wenn es sich bei Ihrer Datenbank um einen
SQL-Server handelt, müssen Sie vor dem Erstellen des Brokers diese Benutzer-ID als Anmelde-ID des
SQL-Servers erstellen und der Benutzer-ID die richtigen Zugriffsrechte erteilen.
Wenn eine Anwendungsdatenbank in
DB2
vorhanden ist, die mit dieser Benutzer-ID erstellt wurde oder auf die diese Benutzer-ID Lese-,
Schreib- und Erstellungszugriff hat, können die in diesem Broker ausgeführten Nachrichtenflüsse
ohne Angabe eines expliziten Schemanamens auf die Anwendungsdaten in dieser Datenbank zugreifen. Weitere Informationen finden Sie unter:
- -p Datenquellenkennwort
- (Optional) Dass Kennwort der Benutzer-ID, mit der auf
Datenbanken zugegriffen wird, die Brokertabellen und Benutzerdaten enthalten. Wird kein Kennwort angegeben, wird für diesen Parameter standardmäßig das über -a angegebene Servicekennwort verwendet.
Um die Kompatibilität mit vorhandenen Systemen sicherzustellen, kann <Kennwort> angegeben werden. Wird jedoch bei Ausführung des Befehls kein Kennwort für diesen Parameter angegeben, werden Sie beim Aufrufen des Befehls aufgefordert, ein Kennwort anzugeben und dieses anschließend noch ein zweites Mal einzugeben, um sicherzustellen, dass es korrekt eingegeben wurde.
Für DB2 auf Linux- und UNIX-Systemen können -u und -p als leere Zeichenfolgen (zwei Anführungszeichen "") angegeben werden. In diesem Fall erteilt DB2 WebSphere Message Broker die Zugriffsrechte der Servicebenutzer-ID; daraus ergibt sich eine "bereits bestätigte" Datenbankverbindung. Wenn Sie für -a, -u und -p leere Zeichenfolgen angeben, speichert WebSphere Message Broker keine Kennwörter.
- -s Warteschlangenmanager_des_Benutzernamensservers
- (Optional) Name des WebSphere MQ-Warteschlangenmanagers, der dem Benutzernamensserver zugeordnet ist.
Geben Sie diesen Parameter an, wenn Sie entweder Authentifizierungsservices oder Publish/Subscribe-Zugriffssteuerung benötigen. Wenn Sie diesen Parameter nicht angeben, setzt der Broker voraus, dass kein Benutzernamensserver definiert ist. Um Publish/Subscribe-Zugriffssteuerung zu aktivieren, geben Sie die Parameter -s und -j an.
- -j
- (Optional) Wenn Sie Publish/Subscribe-Zugriffssteuerung benötigen, geben Sie diesen Parameter an. Sie müssen auch den Parameter -s angeben.
- -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. Auf Windows-Systemen kann sich dieses Verzeichnis nicht auf einem Netzlaufwerk befinden.
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. Auf Windows-Systemen wird über diesen Parameter ein Verzeichnis auf einem anderen Laufwerk angegeben als dem, auf dem das Produkt installiert ist.
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.
Um den Arbeitspfad anzugeben oder zu ändern, löschen Sie den Broker, und erstellen Sie ihn erneut.
- -t
- (Optional) Der Broker wird als WebSphere MQ-gesicherte Anwendung ausgeführt.
Bei Angabe dieses Parameters auf Windows-Systemen fügen Sie die Servicebenutzer-ID (wird über den Parameter -i angegeben) der Gruppe mqm hinzu.
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 Handbuch WebSphere MQ Intercommunication.
- -m
- (Optional) Migrieren eines vorhandenen WebSphere MQ Publish/Subscribe-Brokers.
Bei Angabe dieses Parameters muss der über -q angegebene Warteschlangenmanager der vom WebSphere MQ Publish/Subscribe-Broker verwendete Warteschlangenmanager sein.
- -l LIL-Pfad_des_Benutzers
- (Optional) Eine Liste mit Pfaden (Verzeichnissen) an, aus denen der Broker LILs (Loadable Implementation Libraries) für benutzerdefinierte Knoten für die Nachrichtenverarbeitung lädt.
Auf Linux- und UNIX-Systemen muss bei Verzeichnisnamen die Groß-/Kleinschreibung beachtet werden; wenn die Namen Groß- und Kleinbuchstaben enthalten, müssen sie außerdem in einfache Anführungszeichen gesetzt werden.
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.
Wenn Sie mehr als ein Verzeichnis angeben, trennen Sie die Verzeichnisse auf Windows-Systemen durch ein Semikolon (;) und auf Linux- und UNIX-Systemen durch einen Doppelpunkt (:).
- -g Konfigurationszeitlimit
- (Optional) Dieser Parameter gibt an (in Sekunden), wie viel Zeit eine Ausführungsgruppe im Broker für Änderungen an der Konfiguration hat (beispielsweise für eine Aktualisierung, die Sie über die Workbench implementiert haben).
Ein Nachrichtenfluss kann nicht auf eine Konfigurationsänderung antworten, während er eine Anwendungsnachricht verarbeitet. Eine Ausführungsgruppe, die die aufgefordert wurde, ihre Konfiguration zu ändern, 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.
Der Wert, den Sie für dieses Zeitlimit angeben, hängt von der Systembelastung (einschließlich der CPU-Auslastung) sowie der Auslastung der einzelnen Ausführungsgruppen ab. Sie können einen Eingangswert ermitteln, indem Sie die gesamte Brokerkonfiguration einsetzen. Die bis zur erfolgreichen Beendigung erforderliche Zeit ist ein Richtwert dafür, welchen Wert Sie mindestens festlegen müssen.
Geben Sie den Wert in Sekunden in einem Bereich von 10 bis 3600 an. Der Standardwert ist 300.
Die Summe von Konfigurationszeitlimit und
Konfigurationszeitlimitverzögerung stellt die maximale Dauer dar, in der ein Broker die Verarbeitung einer implementierten Konfigurationsnachricht durchführen kann, bevor eine negative Antwort generiert wird.
- -k Konfigurationszeitlimitverzögerung
- (Optional) Gibt an (in Sekunden), wie viel Zeit der Broker für die Verarbeiter minimaler Änderungen an der Konfiguration hat (beispielsweise für eine Aktualisierung, die Sie über die Workbench eingesetzt haben).
Dieser Parameter repräsentiert die Zeit, die ein Broker und seine Ausführungsgruppen benötigen, um eine Konfigurationsnachricht mit Minimalimplementierung zu verarbeiten; sie hängt von den den Verzögerungen im Netz der Warteschlangenmanager, von der Auslastung des Broker-Warteschlangenmanagers und von der Systemauslastung ab.
Sie können einen Eingangswert ermitteln, indem Sie einen Befehl eingeben, mit dem eine einfache Konfigurationsänderung angefordert wird.
mqsireporttrace brokerName -e "Name der Ausführungsgruppe" -u
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.
Wenn sich der Broker auf einem Produktionssystem befindet, wird empfohlen, den Wert für Konfigurationszeitlimit und Konfigurationsverzögerungszeitlimit zu erhöhen, damit Anwendungsnachrichten, die aktuell von Nachrichtenflüssen verarbeitet werden, vor der Anwendung der Konfigurationsänderungen beendet werden können.
Wenn sich der Broker auf einem Entwicklungs- oder Testsystem befindet, möchten Sie die Zeitlimitwerte (insbesondere das Konfigurationszeitlimit) möglicherweise verringern, um die erkannten Reaktionszeiten zu verbessern und um eine Reaktionszeit von einem Broker zu erhalten, der sich nicht wie erwartet verhält. Ein niedriges Zeitlimit erhöht allerdings die Wahrscheinlichkeit, dass eine Konfigurationsänderung erfolgreich implementiert wird.
- -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 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) Gibt das Intervall (in Minuten) an, in dem die Abrechnungs- und Statistikfunktion von WebSphere Message Broker Archivierungsdatensätze ausgeben muss. Der gültige Bereich liegt zwischen 10 und 14400 Minuten.
Ein Intervall von null Minuten gibt an, dass das Betriebssystem über ein externes Benachrichtigungsverfahren verfügt und den internen Zeitgeber von WebSphere Message Broker nicht verwendet.
- -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 JDNI 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 mit Begrenzern für die Suche nach zusätzlichen Codepageumsetzern. Auf Windows-Systemen wird als Begrenzer ein Semikolon (;) verwendet. Auf UNIX- und Linux-Systemen werden Doppelpunkte (:) als Begrenzer verwendet.
- 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 32-Bit-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.