Befehl mqsicreatebroker

Mit dem Befehl mqsicreatebroker können ein Broker und die zugehörigen Ressourcen erstellt werden.

Unterstützte Plattformen

  • Windows
  • Linux- und UNIX-Systeme
  • z/OS. Führen Sie diesen Befehl aus, indem Sie BIPCRBK anpassen und übergeben; weitere Informationen erhalten Sie unter Inhalt der Broker-PDSE

Zweck

Der Befehl mqsicreatebroker für die folgenden Aufgaben aus.
  1. Der Befehl überprüft ob, der angegebene WebSphere MQ-Warteschlangenmanager vorhanden ist:
    • Wenn der Warteschlangenmanager nicht vorhanden ist, tritt das folgende Verhalten auf.
      • Wird der Befehl unter z/OS ausgeführt wird, schlägt die Aktion fehl und es wird ein Fehler ausgegeben.
      • Wird der Befehl unter Linux, UNIX oder Windows ausgeführt, wird ein Warteschlangenmanager erstellt.

        Beginn der ÄnderungWenn WebSphere MQ Version 7.1 als Warteschlangenmanager ausgewählt wurde, ist die Kanalauthentifizierungssicherheit automatisch inaktiviert.Ende der Änderung

        Es wird unter anderem eine Warteschlange für nicht zustellbare Nachrichten (Dead Letter Queue - DLQ) SYSTEM.DEAD.LETTER.QUEUE erstellt. Die Sicherheitseinstellungen sind dieselben wie die anderer brokerspezifischer WebSphere MQ-Warteschlangen.

        Wenn eine von einem Nachrichtenfluss empfangene Nachricht nicht verarbeitet werden kann, wird sie in der Regel in die Eingabewarteschlange zurückgesetzt. Ist dies nicht möglich bzw. ist der Nachrichtenfluss nicht für ein Zurücksetzen von Nachrichten oder eine andere Art der Fehlerbehandlung konfiguriert, stellt der Broker die Nachricht in die Warteschlangen für nicht zustellbare Nachrichten.

        Der Befehl mqsideletebroker löscht die standardmäßige Warteschlange für nicht zustellbare Nachrichten nicht (es sei denn, der Warteschlangenmanager wird gelöscht).

    • Wenn der Warteschlangenmanager vorhanden ist, überprüfen Sie, ob für ihn eine Warteschlange für nicht zustellbare Nachrichten definiert ist. Auf einem vorhandenen Warteschlangenmanager wird die Warteschlange mit diesem Befehl nicht erstellt, was jedoch erforderlich ist, da Nachrichten, die nicht verarbeitet werden können, vom Broker in die Warteschlange für nicht zustellbare Nachrichten gestellt werden.

      Falls Sie in Ihrer Domäne WebSphere MQ-Cluster verwenden, muss der Warteschlangenmanager vor Ausführung dieses Befehls definiert und im Cluster konfiguriert werden, um den Verwaltungsaufwand reduzieren und gleichzeitig die Verfügbarkeit erhöhen zu können.

      Beginn der Änderung
      • Wird dieser Befehl unter Linux, UNIX oder Windows ausgeführt und handelt es sich bei dem vorhandenen Warteschlangenmanager um WebSphere MQ Version 7.1, wird vorausgesetzt, dass der Benutzer die geeignete Sicherheitskonfiguration zur Erfüllung der entsprechenden Anforderungen anwendet und die Kanalauthentifizierungssicherheit deshalb nicht inaktiviert ist.
      Ende der Änderung
  2. Der Befehl startet den WebSphere MQ-Warteschlangenmanager, falls er noch nicht aktiv ist. Dies gilt jedoch nicht für z/OS.

    Wenn der Befehl den Warteschlangenmanager unter Windows erstellt, wird der Warteschlangenmanager nicht als Dienst gestartet. Wenn Sie sich abmelden, wird der Warteschlangenmanager gestoppt. Bleiben Sie also angemeldet oder ändern Sie den Startstatus des Warteschlangenmanagerservice. Beim Sperren der Workstation wird der WebSphere MQ-Warteschlangenmanager nicht gestoppt.

  3. Der Befehl stellt eine Verbindung zum zugeordneten Warteschlangenmanager her.
  4. Falls noch nicht vorhanden, erstellt der Befehl die für den Broker erforderlichen WebSphere MQ-Warteschlangen.

    Wenn Sie Verwaltungssicherheit aktivieren, werden von diesem Befehl auch die für diese Sicherheit erforderlichen Warteschlangen erstellt.

  5. Nur unter Windows erstellt der Befehl einen Dienst, unter dem der Broker ausgeführt wird.
  6. Der Befehl erstellt den Broker in einem der verfügbaren Modi. Wenn das vollständige Paket installiert wird, lautet der standardmäßige Modus advanced. Bei Installation des Testpakets lautet der Modus standardmäßig trial. Der Abschnitt Betriebsmodi enthält weitere Informationen hierzu.
  7. Der Befehl erstellt einen Datensatz für die Komponente in der Registry.
  8. Auf Windows-Systemen sowie unter Linux und UNIX-Systeme können Sie mit dem Befehl bei der Erstellung des Brokers angeben, ob der Broker als WebSphere MQ-Service gestartet und gestoppt werden kann.

Broker können nur auf lokale Warteschlangenmanager zugreifen, deshalb können Sie einen Broker nicht auf einem Warteschlangenmanager erstellen, der sich auf einem fernen System befindet.

Hinweise zur Nutzung

Es wurde eine Migration von Version 6.1 durchgeführt.

In früheren Versionen von WebSphere Message Broker wurden die von Ihnen in diesem Befehl angegebenen Parameter vom Broker für die Bereitstellung der Standardberechtigung für den Datenbankzugriff genutzt: entweder die Datenbankbenutzer-ID und das Kennwort (falls angegeben) oder die Servicebenutzer-ID und das Kennwort. Da der Broker der Version 8.0 Datenbanken nicht für eigene Zwecke nutzt, sind die Parameter für Datenbankbenutzer-ID und Kennwort veraltet. Die Parameter für die Broker-Service-ID und das zugehörige Kennwort sind ebenfalls veraltet (außer unter Windows).

Wenn Sie einen Broker aus einem früheren Release migrieren, werden die zugeordneten Werte gespeichert und für den standardmäßigen Datenbankzugriff durch den Benutzer so verwendet, als ob Sie diese Werte mit dem Befehl mqsisetdbparms eingegeben hätten.

Wenn Sie einen Broker der Version 8.0 erstellen, müssen Sie mit dem Befehl mqsisetdbparms die Berechtigung für den Datenbankzugriff einrichten.

Details zur Verwendung dieses Befehls unter dem Betriebssystem Ihres Unternehmens finden Sie im entsprechenden Abschnitt.

Berechtigung

Auf Systemen unter Windows XP und Windows Server 2003 muss die Benutzer-ID, unter der dieser Befehl ausgeführt wird, Mitglied der Gruppe Administratoren auf dem lokalen System sein.

Auf Systemen unter Windows 7 und Windows Server 2008 muss die Benutzer-ID, unter der dieser Befehl ausgeführt wird, auf dem lokalen System über höhere Rechte verfügen:
  • Die Benutzer-ID muss Mitglied der Gruppe Administratoren sein.
  • Der Befehl muss über eine Eingabeaufforderung mit erhöhten Rechten ausgeführt werden. Um eine Eingabeaufforderung mit erhöhten Rechten zu erhalten, führen Sie den Befehl 'mqsicommandconsole' aus und befolgen Sie die Windows-Eingabeaufforderung, um eine neue Befehlskonsole mit erhöhten Rechten zu starten.

    Diese Konsole wird mit der richtigen mqsiprofile-Umgebung gestartet, von der aus Befehle ausgeführt werden können, die erhöhte Rechte erfordern.

Wenn Sie den Befehl nicht von einer entsprechend berechtigten Befehlskonsole aus ausführen, wird der Befehl nicht erfolgreich verarbeitet.

Auf Linux- und UNIX-Systemen muss dieser Befehl mit einer Benutzer-ID ausgeführt werden, die der Gruppe mqbrkrs angehört.

Auf z/OS-Systemen muss der Befehl mit einer Benutzer-ID ausgeführt werden, die einer Gruppe angehört, die über Lese- und Schreibzugriff (READ und WRITE) auf das Komponentenverzeichnis verfügt. Darüber hinaus muss die Benutzer-ID Zugriff auf WebSphere MQ-Ressourcen und auf DB2 haben.

Die für die Ausführung dieses Befehls verwendete Benutzer-ID muss auf allen Systemen ein Mitglied der Gruppe mqm sein, da für den Broker mehrere Warteschlangen erstellt werden.

Bei Verwendung von LDAP: Stellen Sie sicher, dass die Registry ausreichend gegen unbefugte Zugriffe geschützt ist. Ein korrekter Betrieb des Brokers ist nicht davon abhängig, ob die Parameter LDAP-Principal und LDAP-Berechtigungsweise im Befehl mqsicreatebroker gesetzt werden. Das Kennwort wird im Dateisystem nicht als Klartext abgespeichert.

WebSphere MQ-Warteschlangen, die erstellt werden

  • SYSTEM.BROKER.ADAPTER.FAILED
  • SYSTEM.BROKER.ADAPTER.INPROGRESS
  • SYSTEM.BROKER.ADAPTER.NEW
  • SYSTEM.BROKER.ADAPTER.PROCESSED
  • SYSTEM.BROKER.ADAPTER.UNKNOWN
  • SYSTEM.BROKER.ADMIN.QUEUE
  • SYSTEM.BROKER.ADMIN.REPLYTODM
  • SYSTEM.BROKER.AGGR.CONTROL
  • SYSTEM.BROKER.AGGR.REPLY
  • SYSTEM.BROKER.AGGR.REQUEST
  • SYSTEM.BROKER.AGGR.TIMEOUT
  • SYSTEM.BROKER.AGGR.UNKNOWN
  • SYSTEM.BROKER.AUTH
  • SYSTEM.BROKER.CONTROL.QUEUE
  • SYSTEM.BROKER.DEPLOY.QUEUE
  • SYSTEM.BROKER.DEPLOY.REPLY
  • SYSTEM.BROKER.EDA.COLLECTIONS
  • SYSTEM.BROKER.EDA.EVENTS
  • SYSTEM.BROKER.EXECUTIONGROUP.QUEUE
  • SYSTEM.BROKER.EXECUTIONGROUP.REPLY
  • SYSTEM.BROKER.INTER.BROKER.COMMUNICATIONS
  • SYSTEM.BROKER.MODEL.QUEUE
  • SYSTEM.BROKER.TIMEOUT.QUEUE
  • SYSTEM.BROKER.WS.ACK
  • SYSTEM.BROKER.WS.INPUT
  • SYSTEM.BROKER.WS.REPLY

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, hat sie dieselbe Berechtigung.

Antworten

Wenn Sie den Befehl mqsicreatebroker ausführen und er fehlschlägt, beheben Sie die Fehlerursache:
  • Überprüfen Sie Antworten (siehe Antworten auf Befehle).
  • Überprüfen Sie Fehlerprotokolle (siehe Lokale Fehlerprotokolle).
  • Überprüfen Sie die Fehlernachrichten im Fehlerprotokoll; außerdem können Sie im Information Center nach Fehlernachrichten suchen.
Wenn Sie den gleichen Befehl erneut ausführen, empfangen Sie möglicherweise eine Reihe von Nachrichten, in denen Elemente angegeben werden, die nicht erstellt werden können. Der Erhalt dieser Nachrichten bedeutet nicht, dass ein Problem mit dem mqsicreatebroker-Befehl selbst vorliegt.
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Letzte Aktualisierung
        
        Letzte Aktualisierung : 2012-07-16 12:20:51


ReferenzthemaReferenzthema | Version 8.0.0.1 | an07080_