Befehl 'mqsicreatebroker'

Unterstützte Plattformen

  • Windows platform Windows
  • Linux platform UNIX platform Linux- und UNIX-Systeme
  • z/OS platform 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:
  • Windows platform Linux platform UNIX platform Erstellt (außer unter z/OS) einen WebSphere MQ-Warteschlangenmanager, sofern noch keiner vorhanden ist.
    1. Falls durch den Befehl mqsicreatebroker ein WebSphere MQ-Warteschlangenmanager erstellt wird, wird die Warteschlange für nicht zustellbare Post (DLQ), die von WebSphere MQ (SYSTEM.DEAD.LETTER.QUEUE) bereitgestellt wird, automatisch aktiviert. Die Sicherheitseinstellungen sind dieselben wie die anderer brokerspezifischer WebSphere MQ-Warteschlangen.

      Wenn Sie den Warteschlangenmanager separat erstellen möchten, müssen Sie eine Warteschlange für nicht zustellbare Nachrichten einrichten. Auf diese Warteschlange wird vom WebSphere Message Broker verwiesen, wenn bei der Verarbeitung von Nachrichten in Nachrichtenflüssen Fehler auftreten.

      Wenn eine Nachricht, sei es 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 die Nachricht in die Eingabewarteschlange zurücksetzen möchten, um den Nachrichtenfluss bis zur Behebung des Problems anzuhalten, müssen Sie die Warteschlange für nicht zustellbare Nachrichten inaktivieren.

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

    2. Bei Verwendung eines WebSphere MQ-Warteschlangenmanagers, der unabhängig vom Befehl mqsicreatebroker erstellt wurde, haben Sie die Möglichkeit, Cluster zu definieren, was die Konfiguration in den meisten Fällen erleichtert.

  • Windows platform Linux platform UNIX platform Startet den WebSphere MQ-Warteschlangenmanager (außer unter z/OS), wenn der WebSphere MQ-Warteschlangenmanager noch nicht aktiv ist.

    Falls der Warteschlangenmanager mit diesem Befehl erstellt wurde, wird er nicht als Windows-Dienst gestartet; deshalb wird der Warteschlangenmanager gestoppt, sobald Sie sich abmelden. Aus diesem Grund müssen Sie entweder angemeldet bleiben oder den Startstatus des Warteschlangenmanagerdienstes ändern.

    Beim Sperren der Workstation wird der WebSphere MQ-Warteschlangenmanager nicht gestoppt.

  • Er erstellt die brokerspezifischen WebSphere MQ-Warteschlangen, falls diese noch nicht vorhanden sind.
  • Er erstellt Datenbanktabellen für den Broker, falls noch keine vorhanden sind, oder fügt vorhandenen Datenbanktabellen brokerspezifische Zeilen hinzu.
  • Windows platform Nur auf Windows-Plattformen installiert er einen Dienst, unter dem der Broker ausgeführt wird.
  • Er erstellt in der Brokerregistrierung einen Eintrag für die Komponente.
Wählen Sie den entsprechenden Link für Details zu diesem Befehl für die Plattform(en) aus, die in Ihrem Unternehmen verwendet wird (werden):

Berechtigung

Windows platform Auf Windows-Systemen muss die Benutzer-ID, mit der dieser Befehl gestartet wird, auf dem lokalen System über die Berechtigung Administrator verfügen.

Linux platform UNIX platform Auf Linux- und UNIX-Systemen muss die Benutzer-ID, mit der dieser Befehl gestartet wird, sowohl der Gruppe mqbrkrs als auch der Gruppe mqm angehören.

z/OS platform Auf z/OS-Systemen muss die Benutzer-ID, mit der dieser Befehl gestartet wird, zu einer Gruppe gehören, die sowohl über Lese- als auch Schreibzugriff (READ und WRITE) für das Komponentenverzeichnis verfügt. Darüber hinaus muss die Benutzer-ID Zugriff auf WebSphere MQ-Ressourcen und auf DB2 haben.

Bei Verwendung von LDAP: Stellen Sie sicher, dass die Registrierungsdatenbank ausreichend gegen unbefugte Zugriffe geschützt ist. Ein korrekter Betrieb des Brokers ist nicht davon abhängig, ob die Optionen 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.ADMIN.QUEUE
  • SYSTEM.BROKER.CONTROL.QUEUE
  • SYSTEM.BROKER.EXECUTIONGROUP.QUEUE
  • SYSTEM.BROKER.EXECUTIONGROUP.REPLY
  • SYSTEM.BROKER.INTERBROKER.QUEUE
  • SYSTEM.BROKER.INTERBROKER.MODEL.QUEUE
  • SYSTEM.BROKER.MODEL.QUEUE
  • SYSTEM.BROKER.WS.INPUT
  • SYSTEM.BROKER.WS.REPLY
  • SYSTEM.BROKER.WS.ACK

Alle Warteschlangen haben eine Zugriffsberechtigung auf die WebSphere Message Broker-Gruppe mqbrkrs. Wenn die Warteschlange für nicht zustellbare Nachrichten aktiviert ist, hat sie dieselbe Berechtigung.

Die Datenbanktabellen, die erstellt werden

Die durch diesen Befehl erstellten oder hinzugefügten Datenbanktabellen werden im Abschnitt Datenbankinhalt beschrieben.

Antworten

In einigen Fällen werden von DB2 unter Umständen die folgenden Fehlernachrichten ausgegeben:
    (51002)[IBM][CLI Driver][DB2/NT]SQL0805N
    Package "NULLID.SQLLF000" was not found. (Paket "NULLID.SQLLF000" wurde nicht gefunden)  SQLSTATE=51002.

Dieser Fehler tritt auf, wenn die Bindung an die Datenbank fehlgeschlagen ist.

  • Windows platform Auf Windows-Plattformen ist für Brokerdatenbanken kein Binden erforderlich; für Benutzerdatenbank allerdings ist es erforderlich. Wenn Sie die Datenbank über die DB2-Steuerzentrale erstellen, erfolgt das Binden automatisch. Bei Verwendung der Befehlsschnittstelle ist dies nicht der Fall. Geben Sie beispielsweise zum Erstellen oder erneuten Erstellen einer Bindung für die Datenbank MYDB folgende Befehle in der Eingabeaufforderung ein:
    db2 connect to MYDB user db2admin using db2admin
    db2 bind X:\sqllib\bnd\@db2cli.lst grant public
    db2 connect reset
    Hierbei steht X: für das Laufwerk, in dem DB2 installiert wurde.
  • Linux platform UNIX platform Auf Linux- und UNIX-Plattformen ist Binden für alle Datenbanken erforderlich. Um beispielsweise eine Bindung für die Datenbank WBRKBKDB zu erstellen, müssen Sie die folgenden Befehle in der Befehlszeile eingeben (wobei <Benutzername> für die Benutzer-ID steht, mit der die Datenbankinstanz erstellt wurde):
    db2 connect to WBRKBKDB user db2admin using db2admin
    db2 bind ~<Benutzername>/sqllib/bnd/@db2cli.lst grant public CLIPKG 5
    db2 connect reset

Wenn Sie nicht die standardmäßige Benutzer-ID und das Standardkennwort für DB2 verwenden (db2admin), müssen Sie die Werte im Befehl db2 connect durch die richtigen Werte ersetzen.

Wenn Sie den Befehl mqsicreatebroker ausführen und er fehlschlägt, beheben Sie die Fehlerursache: 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 | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
an07080_