Befehl 'mqsicreatebroker' - z/OS

Syntax

z/OS-Befehl - BIPCRBK

Parameter

Brokername
(Erforderlich) Der Name des Brokers, den Sie erstellen. Dieser Parameter muss der erste sein, und wenn Sie einen Broker mit einem Namen in Großbuchstaben erstellen, muss dieser in der Workbench in Großbuchstaben angegeben werden.

Informationen zu Einschränkungen bei Zeichensatz, den Sie verwenden können, finden Sie unter Zulässige Zeichen in Befehlen.

-q Warteschlangenmanager
(Erforderlich) Der Name des Warteschlangenmanagers, der diesem Broker zugeordnet ist. Verwenden Sie für Broker und Warteschlangenmanager denselben Namen, um die Netzverwaltung zu erleichtern. Namen von Warteschlangenmanagern können aus maximal 48 Zeichen bestehen; die Groß-/Kleinschreibung muss beachtet werden.

Für jeden Broker ist ein eigener Warteschlangenmanager unbedingt erforderlich. Ein Broker kann keinen Warteschlangenmanager gemeinsam mit anderen Brokern nutzen.

Falls der Warteschlangenmanager nicht bereits vorhanden ist, wird er durch diesen Befehl erstellt. Er wird nicht als Standard-Warteschlangenmanager erstellt; ist dieser Warteschlangenmanager auf diesem System als Standard-Warteschlangenmanager vorgesehen, erstellen Sie entweder den Warteschlangenmanager, bevor Sie diesen Befehl eingeben, oder ändern Sie die Einstellungen dieses Warteschlangenmanagers, so dass er als Standard-Warteschlangenmanager eingerichtet wird, nachdem er erstellt wurde. Verwenden Sie je nach WebSphere MQ-Version den WebSphere MQ Explorer oder das WebSphere MQ Services-Snap-in.

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

Informationen zu Einschränkungen bei Zeichensatz, den Sie verwenden können, finden Sie unter Zulässige Zeichen in Befehlen.

-n DB2-Position
(Erforderlich) Die Position der Datenbank, in der die Brokertabellen erstellt werden.
-u DB2-Tabelleneigner
(Erforderlich) Die Benutzer-ID, mit der auf Datenbanken, die Brokertabellen und Benutzerdaten enthalten, zugegriffen wird.

Diese Benutzer-ID muss die Berechtigung haben, Tabellen in der Datenbank zu erstellen, und sie muss Lese- und Schreibzugriff auf diese Tabellen haben.

Wenn eine Anwendungsdatenbank in DB2 vorhanden ist, die mit dieser Benutzer-ID erstellt wurde oder auf die diese Benutzer-ID Lese-, Schreib- und Erstellungszugriff hat, können die in diesem Broker ausgeführten Nachrichtenflüsse ohne Angabe eines expliziten Schemanamens auf die Anwendungsdaten in dieser Datenbank zugreifen.

-s Warteschlangenmanager_des_Benutzernamensservers
(Optional) Name des WebSphere MQ-Warteschlangenmanagers, der dem Benutzernamensserver zugeordnet ist.

Geben Sie diesen Parameter an, wenn Sie entweder Authentifizierungsservices oder Publish/Subscribe-Zugriffssteuerung benötigen. Wenn Sie diesen Parameter nicht angeben, setzt der Broker voraus, dass kein Benutzernamensserver definiert ist. Um Publish/Subscribe-Zugriffssteuerung zu aktivieren, geben Sie die Parameter -s und -j an.

-j
(Optional) Wenn Sie Publish/Subscribe-Zugriffssteuerung benötigen, geben Sie diesen Parameter an. Sie müssen auch den Parameter -s angeben.
-l Pfad_der_Benutzer-LIL
(Optional) Eine Liste mit Pfaden (Verzeichnissen) an, aus denen der Broker LILs (Loadable Implementation Libraries) für benutzerdefinierte Knoten für die Nachrichtenverarbeitung lädt.

Die Groß-/Kleinschreibung muss bei diesem Namen beachtet werden; schließen Sie Namen in einfache Anführungszeichen ein, wenn sie in gemischter Groß-/Kleinschreibung vorkommen.

Schließen Sie keine Umgebungsvariablen in diesen Pfad ein; WebSphere Message Broker ignoriert sie.

Sie müssen ein eigenes Verzeichnis zum Speichern der LIL- bzw. JAR-Dateien erstellen. Speichern Sie diese Dateien nicht im WebSphere Message Broker-Installationsverzeichnis.
-P Port_des_HTTP-Empfangsprogramms
(Optional) Geben Sie die Nummer des Ports an, an dem die Web-Serviceunterstützung empfangsbereit ist.

Der Broker startet dieses Empfangsprogramm, wenn ein Nachrichtenfluss, der Web-Service-Unterstützung enthält, gestartet wurde; der Standardwert ist 7080.

Stellen Sie sicher, dass der Port, den Sie angeben, nicht bereits für andere Zwecke eingesetzt ist.

-g Konfigurationszeitlimit
(Optional) Dieser Parameter gibt an (in Sekunden), wie viel Zeit eine Ausführungsgruppe im Broker für Änderungen an der Konfiguration hat (beispielsweise für eine Aktualisierung, die Sie über die Workbench implementiert haben).

Ein Nachrichtenfluss kann nicht auf eine Konfigurationsänderung antworten, während er eine Anwendungsnachricht verarbeitet. Eine Ausführungsgruppe, die die aufgefordert wurde, ihre Konfiguration zu ändern, gibt der implementierten Konfigurationsnachricht eine negative Antwort zurück, wenn einer ihrer Nachrichtenflüsse die Verarbeitung einer Anwendungsnachricht nicht abschließt und die Konfigurationsänderung innerhalb dieses Zeitlimits anwendet.

Der Wert, den Sie für dieses Zeitlimit angeben, hängt von der Systembelastung (einschließlich der CPU-Auslastung) sowie der Auslastung der einzelnen Ausführungsgruppen ab. Sie können einen Eingangswert ermitteln, indem Sie die gesamte Brokerkonfiguration einsetzen. Die bis zur erfolgreichen Beendigung erforderliche Zeit ist ein Richtwert dafür, welchen Wert Sie mindestens festlegen müssen.

Geben Sie den Wert in Sekunden in einem Bereich von 10 bis 3600 an. Der Standardwert ist 300.

Die Summe von Konfigurationszeitlimit und Konfigurationszeitlimitverzögerung stellt die maximale Dauer dar, in der ein Broker die Verarbeitung einer implementierten Konfigurationsnachricht durchführen kann, bevor eine negative Antwort generiert wird.

-k Konfigurationsverzögerungszeitlimit
(Optional) Gibt an (in Sekunden), wie viel Zeit der Broker für die Verarbeiter minimaler Änderungen an der Konfiguration hat (beispielsweise für eine Aktualisierung, die Sie über die Workbench eingesetzt haben).

Dieser Parameter repräsentiert die Zeit, die ein Broker und seine Ausführungsgruppen benötigen, um eine Konfigurationsnachricht mit Minimalimplementierung zu verarbeiten; sie hängt von den den Verzögerungen im Netz der Warteschlangenmanager, von der Auslastung des Broker-Warteschlangenmanagers und von der Systemauslastung ab.

Sie können einen Eingangswert ermitteln, indem Sie einen Befehl eingeben, mit dem eine einfache Konfigurationsänderung angefordert wird.
F MQP1BRK,reporttrace u=yes,e='exgrp1'

Die Groß-/Kleinschreibung muss bei dem Namen beachtet werden; schließen Sie Namen in einfache Anführungszeichen ein, wenn sie in gemischter Groß-/Kleinschreibung vorkommen.

Die Reaktionszeit der einzelnen Ausführungsgruppen hängt von der Systembelastung und von ihrer Prozesslast ab. Der Wert muss die maximale Reaktionszeit einer Ausführungsgruppe wiedergeben. Wenn dabei ein zu niedriger Wert angegeben wird, gibt der Broker eine negative Antwort zurück und schreibt möglicherweise Fehlernachrichten in das lokale Fehlerprotokoll.

Geben Sie den Wert in Sekunden in einem Bereich von 10 bis 3600 an. Der Standardwert ist 60.

Wenn sich der Broker auf einem Produktionssystem befindet, wird empfohlen, den Wert für Konfigurationszeitlimit und Konfigurationsverzögerungszeitlimit zu erhöhen, damit Anwendungsnachrichten, die aktuell von Nachrichtenflüssen verarbeitet werden, vor der Anwendung der Konfigurationsänderungen beendet werden können.

Wenn sich der Broker auf einem Entwicklungs- oder Testsystem befindet, möchten Sie die Zeitlimitwerte (insbesondere das Konfigurationszeitlimit) möglicherweise verringern, um die erkannten Reaktionszeiten zu verbessern und um eine Reaktionszeit von einem Broker zu erhalten, der sich nicht wie erwartet verhält. Ein niedriges Zeitlimit erhöht allerdings die Wahrscheinlichkeit, dass eine Konfigurationsänderung erfolgreich implementiert wird.

-v Statistikhauptintervall
(Optional) Gibt das Intervall (in Minuten) an, in dem die Abrechnungs- und Statistikfunktion von WebSphere Message Broker Archivierungsdatensätze ausgeben muss. Der gültige Bereich liegt zwischen 10 und 14400 Minuten.

Ein Intervall von null Minuten gibt an, dass das Betriebssystem über ein externes Benachrichtigungsverfahren verfügt und den internen Zeitgeber von WebSphere Message Broker nicht verwendet.

-1
(Optional) Der Registrierungsarbeitsgang, bei dem nur die Brokerregistry erstellt wird.
-2
(Optional) Der WebSphere MQ-Arbeitsgang, bei dem nur die WebSphere MQ-Warteschlangen für den Broker erstellt werden.
-3
(Optional) Der DB2-Arbeitsgang, bei dem nur die DB2-Tabellen und Indizes für den Broker erstellt werden.
-y LDAP-Principal
(Optional, aber obligatorisch, wenn LdapCredentials angegeben wird.) Der Benutzer-Principal für den Zugriff auf ein optionales LDAP-Verzeichnis, das den vom JDNI verwalteten Ausgangskontext für den JMS-Provider enthält.
-z LDAP-Berechtigungsnachweise
(Optional, aber obligatorisch, wenn LdapPrincipal angegeben wird.) Das Benutzerkennwort für den LDAP-Zugriff.
-c Pfad_des_ICU-Umsetzers
(Optional) Eine Verzeichnisgruppe mit Begrenzern für die Suche nach zusätzlichen Codepageumsetzern.

Die Codepageumsetzer müssen entweder das Format icudt32_Name_der_Codepage.cnv haben oder in einem ICU-Datenpaket namens icudt32.dat enthalten sein.

Verwenden Sie diesen Parameter nicht zum Festlegen des Converter-Pfads, wenn Sie einen Converter verwenden, der einem der integrierten Converter entspricht, die bei Version 6.0 bereitgestellt werden, und der Converter die lokale Codepage für den Broker ist. Verwenden Sie stattdessen die Umgebungsvariable ICU_DATA.
-x Benutzerexitpfad
(Optional) Der Pfad, der die Verzeichnisse aller Benutzerexits enthält, die für die 32-Bit-Ausführungsgruppen in diesem Broker geladen werden sollen. Dieser Pfad wird nur für den Prozess der Ausführungsgruppe dem Suchpfad für Systembibliotheken (PATH,LIBPATH,LD_LIBRARY_PATH,SHLIBPATH) hinzugefügt.

Beispiele

So erstellen Sie einen vollständigen Broker unter z/OS:
mqsicreatebroker CSQ1BRK -q CSQ1 -u BRKUSER -n DBA0
So erstellen Sie nur die DB2-Tabellen und Indizes unter z/OS:
mqsicreatebroker CSQ1BRK -q CSQ1 -u BRKUSER -n DBA0 -2
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
an28120_