mqsicreatebroker-Befehl

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:
  1. Prüft ob, der angegebene WebSphere MQ-Warteschlangenmanager vorhanden ist:
    • Falls er nicht vorhanden ist:
      • Wird bei Ausführung dieses Befehls unter z/OS ein Fehler ausgegeben und der Befehl schlägt fehl.
      • Wird mit diesem Befehl bei Ausführung unter Linux, UNIX oder Windows ein Warteschlangenmanager erstellt.

        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).

    • Ist der Warteschlangenmanager vorhanden, ist zu prüfen, ob eine Warteschlange für nicht zustellbare Nachrichten definiert ist. Auf einem vorhandenen Warteschlangenmanager wird diese Warteschlange mit diesem Befehl nicht erstellt, dies ist jedoch erforderlich, 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.

  2. Startet den WebSphere MQ-Warteschlangenmanager, falls er noch nicht aktiv ist. Dies gilt allerdings nicht für z/OS.

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

  3. Stellt eine Verbindung zum zugeordneten Warteschlangenmanager her.
  4. Erstellt gegebenenfalls 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. Installiert nur unter Windows einen Dienst, unter dem der Broker ausgeführt wird.
  6. 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. Erstellt einen Datensatz für die Komponente in der Registry.
  8. Auf Windows-Plattformen, unter Linux und UNIX-Systeme können Sie bei der Erstellung des Brokers festlegen, 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

Wenn Sie eine Migration aus Version 6.1 vorgenommen haben:

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.

Wählen Sie den entsprechenden Link aus, um Details zu diesem Befehl unter dem oder den in Ihrem Unternehmen verwendeten Betriebssystemen zu erhalten:

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, die sich auf Elemente beziehen, die nicht erstellt werden können. Der Erhalt dieser Nachrichten bedeutet nicht, dass ein Problem mit dem mqsicreatebroker-Befehl selbst vorliegt.
Bemerkungen | Marken | Dieser Link öffnet ein neues Fenster Downloads | Dieser Link öffnet ein neues Fenster Bibliothek | Dieser Link öffnet ein neues Fenster Support | Feedback

Copyright IBM Corporation 1999, 2011Copyright IBM Corporation 1999, 2011.

        
        Letzte Aktualisierung
        
        Letzte Aktualisierung : 2011-11-04 19:54:40


ReferenzthemaReferenzthema | Version 8.0.0.0 | an07080_