Befehl 'mqsicreateconfigmgr'

Unterstützte Plattformen

Zweck

Mit diesem Befehl wurden folgende Aktionen ausgeführt:
  • Erstellen eines WebSphere MQ-Warteschlangenmanagers, falls dieser nicht bereits vorhanden ist.
    Hinweise:
    1. Falls durch den Befehl mqsicreateconfigmgr 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 entsprechen denen anderer brokerspezifischen WebSphere MQ-Warteschlangen.

      Wenn der Warteschlangenmanager separat erstellt wird, muss eine Warteschlange für nicht zustellbare Nachrichten (Dead Letter Queue, DLQ) definiert werden. WebSphere Message Broker verweist auf die DLQ, wenn bei der Verarbeitung von Nachrichten in Nachrichtenflüsse Fehler auftreten.

      Wenn eine Nachricht in einem benutzerdefinierten Nachrichtenfluss oder in einem Publish/Subscribe-Modell nicht verarbeitet werden kann, wird sie als letzte Maßnahme an diese Warteschlange für nicht zustellbare Nachrichten weitergeleitet. Inaktivieren Sie die DLQ, wenn die Nachricht in die Eingabewarteschlange zurückgesetzt werden soll, um den Nachrichtenfluss bis zur Behebung des Fehlers wirkungsvoll anzuhalten.

      Diese Warteschlange wird durch den Befehl mqsideleteconfigmgr nicht gelöscht (es sein denn, der Warteschlangenmanager wird gelöscht).

    2. Bei Verwendung eines WebSphere MQ-Warteschlangenmanagers, der unabhängig vom Befehl mqsicreateconfigmgr erstellt wurde, können Sie bei Bedarf Cluster definieren. Diese Option vereinfacht Ihre Konfiguration.
  • Starten des WebSphere MQ-Warteschlangenmanagers, falls dieser nicht bereits ausgeführt wird.
  • Erstellen der Konfigurationsmanager-spezifischen WebSphere MQ-Warteschlangen und -Kanäle, falls diese nicht bereits vorhanden sind.
  • Erstellen von Datenbanktabellen für den Konfigurationsmanager in dessen internem Repository. Wenn Daten aus dem Konfigurationsrepository einer älteren Version übertragen werden müssen, können Sie dazu die Parameter DB2-Datenbank_die_migriert_werden_soll, Benutzer-ID_der_Migrationsdatenbank und Kennwort_der_Migrationsdatenbank verwenden.
  • Wenn Sie diesen Befehl unter Verwendung des Parameters -n ausführen und dann den Konfigurationsmanager mit mqsideleteconfigmgr löschen, ohne bei diesem Befehl den Parameter -n anzugeben, wird die neue Datenbank, die das Konfigurationsrepository enthält, nicht gelöscht.

    Falls Sie diesen Befehl in dieser Situation erneut ausführen und dabei den Parameter -n angeben, wird er ignoriert, weil die neue Datenbank immer noch vorhanden ist.

  • (Nur Windows) - Installieren eines Windows-Dienstes, unter dem der Konfigurationsmanager ausgeführt werden kann.
  • Erstellen eines Eintrags für die Komponente in der Brokerregistry.

Wenn Sie VisualAge for Java installiert und den WebSphere MQ-Connector als Teil der Installation ausgewählt haben, stellen Sie sicher, dass der Eintrag CLASSPATH für VisualAge for Java nach den CLASSPATH-Einträgen für WebSphere MQ für die von Ihnen verwendeten Windows-Plattformen angezeigt wird (Server- oder Java-Client). Dadurch wird sichergestellt, dass der Konfigurationsmanager beim Starten von Befehl 'mqsistart' auf die richtigen WebSphere MQ-Klassen zugreift (nicht auf die VisualAge-Klassen). Wenn der Konfigurationsmanager in diesem Bereich einen Fehler entdeckt, wird die Nachricht BIP1004 in das Systemereignisprotokoll von Windows geschrieben.

Syntax

Windows

Linux und UNIX-Systeme

z/OS

Parameter

Konfigurationsmanager
(Optional - Windows. Erforderlich - Linux-, z/OS- und UNIX-Systeme) Der Name des Konfigurationsmanagers, der erstellt werden soll.

Unter Linux, UNIX-Systeme und z/OS muss dieser Parameter zuerst angegeben werden. Auf Linux-, UNIX-Systeme- und z/OSn muss die Groß-/Kleinschreibung beachtet werden.

Wenn unter Windows keine Angabe erfolgt, wird 'ConfigMgr' als Standardname übernommen.

-i Servicebenutzer-ID
(Erforderlich) Die Benutzer-ID, unter der der Service ausgeführt wird.

Dieser Parameter kann in einer beliebigen, für die jeweilige Plattform zulässigen Syntax angegeben werden.

Die angegebene Servicebenutzer-ID muss (direkt oder indirekt) zur lokalen Gruppe mqbrkrs gehören und außerdem Zugriff auf das Ausgangsverzeichnis (in dem WebSphere Message Broker installiert ist) und auf das Arbeitsverzeichnis (wenn das Attribut -w angegeben wurde) haben.

Beginn der ÄnderungWeitere Informationen zu den Sicherheitsanforderungen für die Servicebenutzer-ID finden Sie unter Sicherheitsanforderungen für Windows-Plattformen (für Windows), Sicherheitsanforderungen für Linux- und UNIX-Plattformen (für UNIX-Plattformen) und Sicherheitsanforderungen für z/OS für z/OS. Ende der Änderung

Wenn Sie Beginn der Änderungbei WindowsEnde der Änderung für die Servicebenutzer-ID das unqualifizierte Format (Benutzername) verwenden, durchsucht das Betriebssystem seine Domäne nach dieser Benutzer-ID und beginnt dabei auf dem lokalen System. Dieser Suchvorgang kann einige Zeit in Anspruch nehmen.

-a Servicekennwort
(Erforderlich) 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 Warteschlangenmanager
(Erforderlich) Name des Warteschlangenmanagers, der dem Konfigurationsmanager zugeordnet ist.

Falls der Warteschlangenmanager nicht bereits vorhanden ist, wird er durch diesen Befehl erstellt. Er wird nicht als Standardwarteschlangenmanager erstellt. Wenn der Warteschlangenmanager auf diesem System als Standardeinstellung verwendet werden soll, müssen Sie den Warteschlangenmanager vor dem Aufrufen dieses Befehls erstellen.

Das WS-Manager-Attribut MAXMSGL (maximale Länge der Nachrichten, die in Warteschlangen eingereiht werden können) wird auf 100 MB aktualisiert. Diese Aktualisierung geschieht unabhängig davon, ob der Warteschlangenmanager mit diesem Befehl erstellt wurde.

-n DB2-Datenbank_die_migriert_werden_soll
(Optional) Der Name der Datenbank, die in einer älteren Version zur Aufnahme der Tabellen des Konfigurationsrepositorys erstellt wurde.

Diese Datenbank muss bereits vorhanden sein. Für diese Datenbank muss keine ODBC-Verbindung erstellt werden, da der Zugriff von JDBC bereitgestellt wird.

-u Benutzer-ID_der_Migrationsdatenbank
(Optional) Die Benutzer-ID, mit der auf die (in einer älteren Version erstellten) Datenbank des Konfigurationsrepositorys zugegriffen wird.
-p Kennwort_der_Migrationsdatenbank
(Optional) Das Kennwort für die Benutzer-ID, mit der auf die (in einer älteren Version erstellten) Datenbank des Konfigurationsrepositorys zugegriffen wird. Wird kein Kennwort angegeben, wird für diesen Parameter standardmäßig das über -a angegebene 'ServicePassword' verwendet.

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.

-s Warteschlangenmanager_des_Benutzernamensservers
(Optional) Name des WebSphere MQ-Warteschlangenmanagers, der dem Benutzernamensserver zugeordnet ist. Erfolgt keine Angabe, geht der Konfigurationsmanager davon aus, dass kein Benutzernamensserver definiert ist und wird nicht versuchen, mit einem Benutzernamensserver zu kommunizieren.
-w Arbeitspfad
(Optional) Verzeichnis, in dem Arbeitsdaten für den Konfigurationsmanager gespeichert werden. Falls kein Verzeichnis angegeben wurde, wird das Standardverzeichnis verwendet, das bei der Installation des Produkts angegeben wurde.
1
(Optional - Nur z/OS) Der Registrydurchgang, bei dem nur das Registry des Konfigurationsmanagers erstellt wird.
2
(Optional - Nur z/OS) Der WebSphere MQ-Durchgang, bei dem nur die WebSphere MQ-Warteschlangen des Konfigurationsmanagers erstellt werden.
Anmerkung: Dieser Vorgang kann nur ausgeführt werden, wenn die Registry des Konfigurationsmanagers vorhanden ist.

Autorisierung

Durch diesen Befehl werden die Sicherheitszugriffsrechte für die Servicebenutzer-ID geändert; die Benutzer-ID, mit der dieser Befehl aufgerufen wird, muss der Gruppe Windows Administratoren auf dem lokalen System angehören.

Beginn der ÄnderungAuf UNIX-Systemen muss die Benutzer-ID, mit der dieser Befehl aufgerufen wird, zur Gruppe 'mqbrkrs' gehören. Ende der Änderung

Beginn der ÄnderungAuf z/OS-Systemen muss die Benutzer-ID, mit der dieser Befehl aufgerufen wird, zu einer Gruppe gehören, die über Lese- und Schreibzugriff (READ und WRITE) auf das Komponentenverzeichnis verfügt. Ende der Änderung

Erstellte Websphere MQ-Warteschlangen

  • SYSTEM.BROKER.CONFIG.QUEUE
  • SYSTEM.BROKER.CONFIG.REPLY
  • SYSTEM.BROKER.ADMIN.REPLY
  • SYSTEM.BROKER.SECURITY.REPLY
  • SYSTEM.BROKER.MODEL.QUEUE

Die WebSphere Message Broker-Gruppe mqbrkrs ist für den Zugriff auf alle diese Warteschlangen berechtigt. Wenn die Warteschlange für nicht zustellbare Nachrichten aktiviert ist, verfügt sie über die gleichen Berechtigungen.

Erstellte Websphere MQ-Kanäle

  • SYSTEM.BKR.CONFIG

Erstellte Datenbanktabellen

Die mit diesem Befehl erstellten Datenbanktabellen werden vom Konfigurationsmanager verwaltet.

Antworten

Dieser Befehl gibt die folgenden Antworten zurück:
  • BIP8011 Die Konfigurationsdaten konnten nicht erstellt werden
  • BIP8012 Verbindung zu Systemkomponenten konnte nicht hergestellt werden
  • BIP8014 Komponente kann nicht erstellt werden
  • BIP8022 Benutzer-ID und Kennwort sind ungültig
  • 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 den Warteschlangenmanager konnte nicht gesetzt werden
  • BIP8054 Sicherheit für Warteschlange konnte nicht gesetzt werden
  • BIP8055 Java-Klasse kann nicht geladen werden
  • BIP8056 Unbekannter Warteschlangenmanager
  • BIP8074 JVM konnte nicht erstellt werden
  • BIP8075 Java-Ausnahme
  • BIP8076 Aktuelles Verzeichnis konnte nicht gesetzt werden
  • BIP8077 Fehler beim Initialisieren der Konfigurationsdaten
  • BIP8078 Fehler beim Initialisieren der Konfigurationsdaten
  • BIP8084 Verzeichnis konnte nicht erstellt werden
  • BIP8087 Komponente ist bereits vorhanden
  • BIP8093 Warteschlangenmanager wird gerade erstellt
  • BIP8094 Warteschlangenmanager wird gerade gestoppt
  • BIP8097 Java-Objekt konnte nicht erstellt werden

Beispiele

mqsicreateconfigmgr CMGR01 -i wbrkuid -a wbrkpw -q WBRK_CONFIG_QM
Zugehörige Konzepte
Konfigurationsmanager
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
an23000_