Befehl 'mqsicreateusernameserver'

Unterstützte Plattformen

Zweck

Auf Windows-Plattformen sowie auf Linux- und UNIX-Systemen bewirkt dieser Befehl Folgendes:
  • Er erstellt einen WebSphere MQ-Warteschlangenmanager, falls noch keiner vorhanden ist.
    Anmerkung:
    1. (Nicht unter z/OS) Falls durch den Befehl mqsicreateusernameserver ein WebSphere MQ-Warteschlangenmanager erstellt wird, wird die standardmäßige Warteschlange für nicht zustellbare Nachrichten, die von WebSphere MQ (SYSTEM.DEAD.LETTER.QUEUE) bereitgestellt wird, automatisch aktiviert. Die Sicherheitseinstellungen sind dieselben wie die anderer brokerspezifischer WebSphere MQ-Warteschlangen.

      Wenn der Warteschlangenmanager separat erstellt werden soll, sollten Sie auch eine Warteschlange für nicht zustellbare Nachrichten definieren. Auf diese Warteschlange wird von WebSphere Message Broker verwiesen, wenn bei der Verarbeitung von Nachrichten in Nachrichtenflüssen Fehler auftreten.

      Wenn eine Nachricht in einem benutzerdefinierten Nachrichtenfluss oder im Publish/Subscribe-Modell nicht verarbeitet werden kann, wird sie schließlich an diese Warteschlange für nicht zustellbare Nachrichten weitergeleitet. Wenn Sie es vorziehen, dass die Nachricht in der Eingabewarteschlange zurückgesetzt und der Nachrichtenfluss bis zur Behebung des Problems angehalten wird, müssen Sie die Warteschlange für nicht zustellbare Nachrichten inaktivieren.

      Der Befehl mqsideleteusernameserver löscht diese Warteschlange nicht (es sei denn, der Warteschlangenmanager wird gelöscht).

    2. Wenn Sie einen WebSphere MQ-Warteschlangenmanager verwenden, der nicht mit dem Befehl mqsicreateusernameserver erstellt wurde, können Sie auch Cluster definieren. Dies vereinfacht die Konfiguration.

  • (Nicht unter z/OS) Startet den WebSphere MQ-Warteschlangenmanager, falls dieser noch nicht aktiv ist.

    Wird der Warteschlangenmanager mit diesem Befehl erstellt, wird er nicht als Windows-Dienst erstellt; er wird daher gestoppt, wenn Sie sich abmelden. Um dies zu vermeiden, müssen Sie entweder angemeldet bleiben oder den Startstatus des Warteschlangenmanagerservice ändern. (Wenn Sie die Workstation sperren, wird der WebSphere MQ-Warteschlangenmanager dadurch nicht gestoppt.)

  • Er erstellt die WebSphere MQ-Warteschlangen für den Benutzernamensserver, falls diese noch nicht vorhanden sind.
  • Unter Windows installiert er einen Dienst, unter dem der Benutzernamensserver ausgeführt wird.
  • Er erstellt in der Brokerregistrierung einen Eintrag für die Komponente.

Syntax

Windows-Plattformen, Linux- und UNIX-Systeme

z/OS-Konsolbefehl

Parameter

-i Servicebenutzer-ID
(Erforderlich - Windows-Plattformen, Linux- und UNIX-Systeme) Die Benutzer-ID, unter der der Broker ausgeführt wird.
Sie kann in einem beliebigen gültigen Format für Benutzernamen angegeben werden. Auf Windows-Plattformen sind Folgende möglich:
  • domain\username
  • \\server\username
  • .\username
  • username
Auf Linux- und UNIX-Systemen ist nur das letztere Format (Benutzername) zulässig.

Wenn Sie auf Windows-Plattformen das nicht qualifizierte Format (username) für diese Benutzer-ID wählen, durchsucht das Betriebssystem die gesamte Domäne nach der Benutzer-ID, angefangen mit dem lokalen System. Diese Suche kann einige Zeit in Anspruch nehmen.

Die ServiceUserID, die angegeben wird, muss zur lokalen Gruppe mqbrkrs gehören. Auf Windows-Plattformen kann sie direkt oder indirekt zu dieser Gruppe gehören. Die ServiceUserID muss außerdem Zugriff auf das Ausgangsverzeichnis haben (in dem WebSphere Message Broker installiert ist).

Ausführliche Informationen zu den Sicherheitsanforderungen für die Servicebenutzer-ID finden Sie für Windows-Plattformen unter Sicherheitsanforderungen für Windows-Plattformen sowie für Linux- und UNIX-Systeme unter Sicherheitsanforderungen für Linux- und UNIX-Plattformen.

-a ServicePassword
(Erforderlich - Windows-Plattformen sowie Linux- und UNIX-Systeme) Kennwort für die Servicebenutzer-ID.

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 dazu aufgefordert, eines anzugeben und dieses anschließend noch ein zweites Mal einzugeben, um sicherzustellen, dass es korrekt eingegeben wurde.

-q QueueManagerName
(Erforderlich) Der Name des Warteschlangenmanagers, der zum Benutzernamensserver gehört.

Auf Windows-Plattformen sowie auf Linux- und UNIX-Systemen erstellt dieser Befehl den WS-Manager, falls dieser noch nicht vorhanden ist. Er wird nicht als Standard-WS-Manager erstellt; soll er auf diesem System als Standard-WS-Manager definiert werden, müssen Sie den Warteschlangenmanager erstellen, bevor Sie diesen Befehl eingeben.

Das WS-Managerattribut MAXMSGL (max. Länge der Nachrichten, die in Warteschlangen eingereiht werden können) wird auf 100 MB erhöht. Dies geschieht unabhängig davon, ob der Warteschlangenmanager mit diesem Befehl erstellt wurde.

-d SecurityDomainName
(Optional - Windows-Plattformen) Name der Windows-Systemsicherheitsdomäne. Erfolgt keine Angabe, wird standardmäßig die lokale Windows-Systemsicherheitsdomäne des Systems verwendet. Weitere Informationen zur Implementierung von Sicherheitsfunktionen in WebSphere Message Broker finden Sie unter Sicherheit für die Brokerdomäne einrichten.
-r RefreshInterval
(Optional) Das Intervall (in Sekunden) in dem er Benutzernamensserver das Sicherheitssystem zu Änderungen an Benutzer- oder Gruppenattributen abfragt. Erfolgt keine Angabe, wird das Standardintervall (60 Sekunden) des Benutzernamensservers übernommen.
-w Workpath
(Optional - Windows-Plattformen, Linux- und UNIX-Systeme) Verzeichnis, in dem die Arbeitsdateien für den Benutzernamensserver gespeichert werden. Wird kein Verzeichnis angegeben, wird das bei der Produktinstallation angegebene Standardverzeichnis verwendet.
-g AuthProtocolDataSource
(Optional - Windows-Plattformen, Linux- und UNIX-Systeme) Über diesen Parameter können Sie Name und Pfad der Kennwortdatei angeben, aus der alle protokollspezifischen Informationen entnommen werden. Standardmäßig wird diese Datei im Ausgangsverzeichnis erwartet. Wenn Sie die Datei in einem anderen Verzeichnis speichern, müssen Sie den vollständigen Pfad, einschließlich des Dateinamens, angeben.

Im Verzeichnis examples/auth (unter dem Produktausgangsverzeichnis) stehen zwei Beispieldateien (password.dat und pwgroup.dat) zur Verfügung.

-j
(Optional - Windows-Plattformen sowie Linux- und UNIX-Systeme) Gibt an, dass Gruppen und Gruppenzugehörigkeiten in der Datenquelle des Authentifizierungsprotokolls definiert und nicht aus dem Betriebssystem entnommen wurden.
1
(Optional - nur z/OS) Der Registrierungsarbeitsgang, bei dem nur die Registrierung des Benutzernamensservers erstellt wird.
2
(Optional - nur z/OS) Der WebSphere MQ-Arbeitsgang, bei dem nur die Benutzernamensserver WebSphere MQ-Warteschlangen erstellt werden.

WebSphere MQ-Warteschlangen, die erstellt werden

  • SYSTEM.BROKER.SECURITY.QUEUE
  • SYSTEM.BROKER.MODEL.QUEUE

Alle Warteschlangen haben eine Zugriffsberechtigung auf die WebSphere Message Broker-Gruppe mqbrkrs.

Antworten

Dieser Befehl gibt die folgenden Antworten zurück:
  • BIP8011 Die Konfigurationsdaten konnten nicht erstellt werden
  • BIP8012 Es kann keine Verbindung zu Systemkomponenten hergestellt werden
  • BIP8014 Die Komponente konnte nicht erstellt werden
  • BIP8022 Ungültige Benutzer-ID/ungültiges Kennwort
  • BIP8030 Änderungen an den Berechtigungen der Benutzer-ID nicht möglich
  • BIP8048 Warteschlangenmanager konnte nicht gestartet werden
  • BIP8050 Warteschlangenmanager konnte nicht erstellt werden
  • BIP8051 Warteschlange konnte nicht erstellt werden
  • BIP8053 Sicherheit für Warteschlangenmanager konnte nicht gesetzt werden
  • BIP8054 Sicherheit für Warteschlange konnte nicht gesetzt werden
  • BIP8056 Unbekannter Warteschlangenmanager
  • BIP8068 Ganze Zahl als Argument erforderlich
  • BIP8084 Verzeichnis konnte nicht erstellt werden
  • BIP8087 Komponente ist bereits vorhanden
  • BIP8093 Warteschlangenmanager wird gerade erstellt
  • BIP8094 Warteschlangenmanager wird gestoppt

Beispiele

mqsicreateusernameserver -i wbrkuid -a wbrkpw
   -q WBRK_QM -r 1000
Zugehörige Konzepte
Benutzernamensserver
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
an07200_