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, sodass er als Standard-Warteschlangenmanager eingerichtet wird, nachdem er erstellt wurde. Beginn der ÄnderungVerwenden Sie je nach WebSphere MQVersion den WebSphere MQ Explorer oder das WebSphere MQ Services-Snap-in.Ende der Änderung

Das WS-Manager-Attribut MAXMSGLEN (max. Länge der Nachrichten, die in Warteschlangen eingereiht werden) 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), aus denen der Broker 32-Bit-LILs (Loadable Implementation Libraries) für benutzerdefinierte Knoten für die Nachrichtenverarbeitung lädt. Verwenden Sie das Flag -l für 32-Bit-LILs.

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.

Beginn der ÄnderungDer Broker startet dieses Empfangsprogramm, wenn ein Nachrichtenfluss, der HTTP-Knoten oder Web-Service-Unterstützung enthält, gestartet wurde; der Standardwert ist 7080. Ende der Änderung

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

-g Zeitlimit_für_Konfigurationsänderungen
Beginn der Änderung(Optional) Die maximale Zeit (in Sekunden), die für die Verarbeitung einer Benutzerkonfigurationsanforderung zulässig ist. Dabei wird die Länge der Zeit definiert, die der Broker zur Anwendung einer von Ihnen initiierten Konfigurationsänderung für eine Ausführungsgruppe benötigt. Wenn Sie beispielsweise eine Konfiguration von der Workbench implementieren, muss der Broker innerhalb dieser Zeit auf den Konfigurationsmanager antworten.

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.

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

Weitere Informationen zum Festlegen des Werts für dieses Zeitlimit finden Sie unter Zeitlimits für die Konfiguration festlegen.

Ende der Änderung
-k Internes_Konfigurationszeitlimit
Beginn der Änderung(Optional) Die maximale Zeit (in Sekunden), die für die Verarbeitung einer internen Konfigurationsänderung zulässig ist. Dabei wird beispielsweise die Länge der Zeit definiert, die der Broker zum Starten einer Ausführungsgruppe benötigt.Ende der Änderung

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.

Weitere Informationen zum Festlegen des Werts für dieses Zeitlimit finden Sie unter Zeitlimits für die Konfiguration festlegen.

-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 | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Letzte Aktualisierung : 2009-02-17 15:29:42

an28120_