Befehl 'mqsichangebroker' - Windows-, Linux- und UNIX-Systeme

Syntax

Parameter

Brokername
(Erforderlich) Dieser Parameter muss zuerst angegeben werden. Geben Sie den Namen des Brokers an, der geändert werden soll.
-a Servicekennwort
(Optional) Das 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 muss -a aus Kompatibilitätsgründen mit Windows-Systemen angegeben werden, wird aber nicht in Relation mit Servicebenutzer-ID verwendet. -a wird nur als Standard verwendet, wenn -p nicht angegeben ist. Weitere Informationen hierzu finden Sie in der Beschreibung des Parameters -p.

Wenn Sie Ihren Broker erstellt haben, um Servicebenutzer-ID und Servicekennwort für den Datenbankzugriff zu verwenden, stellen Sie sicher, dass Sie beide Instanzen des Kennworts in diesem Befehl aktualisiert haben, indem Sie auch den Parameter -p Datenquellenkennwort angeben. Geben Sie den Parameter -p Datenquellenkennwort unter folgenden Umständen an:
  • Sie haben die Parameter -u Benutzer-ID_Datenquelle und -p Datenquellenkennwort ausgeschlossen.
  • Sie haben die Parameter -u Benutzer-ID_Datenquelle und -p Datenquellenkennwort eingeschlossen, aber die gleiche Benutzer-ID und das gleiche Kennwort für die Servicebenutzer-ID mit -a Servicekennwort und -i Servicebenutzer-ID angegeben.

So ändern Sie ein Kennwort erfolgreich:

  • Stoppen Sie den Broker.
  • Ändern Sie das Kennwort mithilfe der entsprechenden Funktion des Betriebssystems.
  • Aktualisieren Sie mit dem Befehl mqsichangebroker alle Parameter, die auf dasselbe Kennwort verweisen.
  • Starten Sie den Broker erneut.
-i Servicebenutzer-ID
(Optional) Die Benutzer-ID, unter der der Broker ausgeführt wird. Wenn Sie diesen Wert ändern, muss auch das Kennwort geändert werden (-a).

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:

Beginn der Änderung
  • \\Server\Benutzername
  • .\Benutzername
  • Benutzername
Ende der Änderung

Auf Linux- und UNIX-Systemen ist nur das letztere Format (Benutzername) zulässig.

Beginn der ÄnderungVerwenden Sie keinen Domänennamen als Teil des Parameters Servicebenutzer-ID.Ende der Änderung

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

-p Datenquellenkennwort
(Optional) Dass Kennwort der Benutzer-ID, mit der auf Datenbanken zugegriffen wird, die Brokertabellen und Benutzerdaten enthalten.

Um die Kompatibilität mit vorhandenen Systemen sicherzustellen, kann nach wie vor noch 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 kann -p als leere Zeichenfolge (mit zwei Anführungszeichen "") angegeben werden. In diesem Fall erteilt DB2 WebSphere Event Broker die Zugriffsrechte der Servicebenutzer-ID; daraus ergibt sich eine "bereits bestätigte" Datenbankverbindung. Wenn die Parameter -a und -p als leere Zeichenfolgen angegeben werden, werden von WebSphere Event Broker keine Kennwörter gespeichert. Damit wird die sicherste Konfiguration erstellt.

Stellen Sie sicher, dass Sie alle Instanzen ändern, für die dieses Kennwort verwendet wird. Wenn Sie den Broker so erstellt (oder entsprechend geändert) haben, dass für die Servicebenutzer-ID und den Datenbankzugriff dieselbe Benutzer-ID und dasselbe Kennwort verwendet werden, müssen beide gleichzeitig geändert werden. (Weitere Informationen dazu finden Sie in der Beschreibung des Parameters -a.)

-s WS-Managername_des_Benutzernamensservers
(Optional) Name des WebSphere MQ-Warteschlangenmanagers, der dem Benutzernamensserver zugeordnet ist.

Wenn die themenspezifische Sicherheit inaktiviert werden soll, müssen Sie eine leere Zeichenfolge angeben (zwei Anführungszeichen, "").

-j
(Optional) Publish/Subscribe-Zugriff ist für den Broker aktiviert. Dieser Parameter ist nur mit dem Parameter -s gültig.
-d
(Optional) Publish/Subscribe-Zugriff ist für den Broker nicht aktiviert.
-t
(Optional) Der Broker wird als WebSphere MQ-gesicherte Anwendung ausgeführt.

Weitere Informationen zur Verwendung gesicherter WebSphere MQ-Anwendungen finden Sie im Handbuch WebSphere MQ Intercommunication.

-n
(Optional) Gibt an, dass der Broker nicht mehr als sichere WebSphere MQ-Anwendung ausgeführt werden soll.
-l LIL-Pfad_des_Benutzers
(Optional) Eine Liste mit Pfaden (Verzeichnissen), aus denen der Broker 32-Bit-LILs (Loadable Implementation Libraries) für benutzerdefinierte Knoten für die Nachrichtenverarbeitung lädt. Verwenden Sie das Flag -l für 32-Bit-LILs.

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 Event Broker-Installationsverzeichnis gespeichert werden.

Wenn Sie mehrere zusätzliche Verzeichnisse angeben, muss jedes davon durch das plattformspezifische standardmäßige Pfadtrennzeichen getrennt werden.

-g Zeitlimit_der_Konfigurationsänderung
Beginn der Ä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 Workbench 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, 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.

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 Zeitlimits für die Konfiguration festlegen.

Ende der Änderung
-k Zeitlimit_der_internen_Konfiguration
Beginn der Änderung(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.Ende der Änderung

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 Zeitlimits für die Konfiguration festlegen.

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

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

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

-v Statistikhauptintervall
(Optional) Das Zeitintervall (in Minuten), in dem die Abrechnungs- und Statistikfunktion von WebSphere Event Broker Archivierungsdatensätze ausgeben muss. Für die interne Abrechnung liegen die zulässigen Werte 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 Event 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-Umsetzerpfad
(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.

Die Codepageumsetzer müssen entweder das Format icudt32_Name_der_Codepage.cnv haben oder in einem ICU-Datenpaket namens icudt32.dat enthalten sein.

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 bereitgestellt werden, und der Converter die lokale Codepage für den Broker ist. Verwenden Sie stattdessen die Umgebungsvariable ICU_DATA.

Sollen andere Brokereigenschaften geändert werden, löschen Sie zuerst den Broker, und erstellen Sie ihn erneut, um dann die Brokerkonfiguration über die Workbench erneut zu implementieren. Informationen zum Ändern der für den Datenbankzugriff erforderlichen Benutzer-ID finden Sie unter Brokerdomäne verwalten.

Beispiele

Windows-, Linux- und UNIX-Systeme:
mqsichangebroker WBRK_BROKER -s WBRK_UNS_QM
mqsichangebroker WBRK_BROKER -s ""
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009. Alle Rechte vorbehalten.
Letzte Aktualisierung : 2009-02-17 15:49:56

an28150_