Befehl 'mqsicreateconfigmgr'

Unterstützte Plattformen

  • Windows
  • Linux und UNIX-Systeme
  • z/OS

Zweck

Durch diesen Befehl werden folgende Aktionen durchgeführt:
  • Erstellen eines WebSphere MQ-Warteschlangenmanagers, falls dieser nicht bereits vorhanden ist.
    Anmerkung:
    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. Dadurch wird Ihre Konfiguration vereinfacht.
  • Starten des WebSphere MQ-Warteschlangenmanagers, falls dieser nicht bereits ausgeführt wird. Beachten Sie, dass der Konfigurationsmanager immer als eine gesicherte WebSphere MQ-Anwendung ausgeführt wird.
  • Falls noch nicht vorhanden, Erstellen von WebSphere MQ-Warteschlangen und -Kanälen, wie sie für Konfigurationsmanager spezifisch 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.
  • 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.

Auf Linux-, z/OS- und UNIX-Systemen muss dieser Parameter zuerst angegeben werden. Auf Linux- und UNIX-Systemen 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.

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

Die angegebene Servicebenutzer-ID muss auch ein direktes oder indirektes Mitglied der lokalen Gruppe mqbrkrs sein. Außerdem muss diese ID Zugriff auf das Ausgangsverzeichnis (in dem WebSphere Message Broker installiert wurde) und auf das Arbeitsverzeichnis (falls über den Parameter -w angegeben) haben. Je nachdem muss diese Benutzer-ID außerdem (direkt oder indirekt) zur lokalen Gruppe mqm oder zur lokalen Windows-Gruppe Administratoren gehören.

Weitere Informationen zu den Sicherheitsanforderungen für die Servicebenutzer-ID finden Sie unter Sicherheitsanforderungen für Windows-Plattformen (für Windows) und Sicherheitsanforderungen für Linux- und UNIX-Plattformen (für UNIX-Plattformen).

Wenn Sie für diese Benutzer-ID das unqualifizierte Format (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.

-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. Dies 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. Falls kein Kennwort angegeben wurde, wird standardmäßig das in -a angegebene Servicekennwort 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. Falls der Warteschlangenmanager nicht angegeben wurde, geht der Konfigurationsmanager davon aus, dass kein Benutzernamensserver definiert wurde, und stellt keine Verbindung her.
-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.

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.

Zugriffsberechtigung wird den WebSphere Message Broker-Gruppen mqbrdevt, mqbrasgn, mqbrops und mqbrtpic für die Warteschlangen SYSTEM.BROKER.CONFIG.QUEUE und SYSTEM.BROKER.CONFIG.REPLY erteilt.

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
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2005 Letzte Aktualisierung: Nov 17, 2005
an23000_