mqsichangeproperties-Befehl

Mit dem Befehl mqsichangeproperties können Brokereigenschaften und Eigenschaften von Brokerressourcen geändert werden.

Unterstützte Plattformen

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

Zweck

Verwenden Sie den Befehl mqsichangeproperties zum Ändern von Eigenschaften, die sich auf den Broker und die konfigurierbaren Services, die mitgeliefert wurden oder die Sie erstellt haben, beziehen. Zu diesen Services gehören:
  • Kommunikation zwischen Brokern
  • Sicherheitscache (securitycache)
  • HTTP-Empfangsprogramm (httplistener), einschließlich Unterstützung von HTTP und HTTPS (SSL) für die HTTPInput- und HTTPReply-Knoten
  • HTTP-Connector (httpConnector), einschließlich Unterstützung von HTTP und HTTPS (SSL) für die SOAPInput- und SOAPReply-Knoten
  • JMSProviders
  • JDBCProviders
Die Eigenschaften können auch über die Proxy-API des Konfigurationsmanagers geändert werden.

Hinweise zur Nutzung

  • Stellen Sie vor Ausführung dieses Befehls sicher, dass der Broker aktiv ist.
  • Wenn Sie einen Wert ändern, müssen Sie den Broker stoppen und erneut starten, damit die Änderung wirksam wird.

Syntax

Parameter

Brokername
(Erforderlich) Der Name des zu ändernden Brokers. Dieser Parameter muss zuerst angegeben werden.
-b Komponentenname
(Optional) Der Name der Komponente. Gültige Werte sind httplistener und securitycache.
-e Ausführungsgruppenbezeichnung
(Optional) Die Bezeichnung der Ausführungsgruppe, deren Einstellungen angezeigt oder geändert werden sollen.

Der Sondername AllExecutionGroups ist zulässig und wird zum Anzeigen von Einstellungen für den Objektnamen Connector verwendet; auf diese Weise können brokerübergreifende Einstellungen, die alle Ausführungsgruppen betreffen, angezeigt werden.

-c KonfigurierbarerService
(Optional) Der Typ des konfigurierbaren Service, z. B. JMSProviders, JDBCProviders, EISProviders, SecurityProfiles, PolicySets, PolicySetBindings und FtpServer. Die gültigen Werte werden mit dem Befehl mqsireportproperties angezeigt.
-o Objektname
(Erforderlich) Der Name des Objekts, dessen Eigenschaften Sie ändern möchten.
Die Werte
  • SAP, Siebel und PeopleSoft werden als WebSphere-Adapterkomponenten akzeptiert.
  • HTTPConnector und HTTPSConnector werden für alle Ausführungsgruppen akzeptiert und sind zulässig, wenn für Komponentenname der Wert httplistener ausgewählt wird.
  • SecurityCache
  • BrokerRegistry wird verwendet, ohne dass Komponentenname, Ausführungsgruppenbezeichnung oder KonfigurierbarerService angegeben werden müssen.
  • Die zu ändernde Angabe für SecurityProfileName.
-n Eigenschaftsname
(Erforderlich) Der Name der zu ändernden Eigenschaft.
Für eine JMSProviders- oder EISProviders-Ressource sind folgende Eigenschaftsnamen zulässig:
  • jarsURL
  • nativeLibs
Für eine JDBCProviders-Ressource sind folgende Eigenschaftsnamen zulässig:
  • databaseType
  • databaseVersion
  • type4DriverClassName
  • connectionUrlFormat
  • connectionUrlFormat Attr1-5
  • databaseName
  • description
  • jarsURL
  • portNumber
  • serverName
  • securityIdentity
Für eine SecurityProfiles-Ressource sind folgende Eigenschaftsnamen zulässig:
  • authentication = {NONE, LDAP,TFIM}
  • authenticationConfig = string
  • mapping = {NONE, TFIM}
  • mappingConfig = string
  • authorization = {NONE, LDAP, TFIM}
  • authorizationConfig = string
  • propagation = {TRUE, FALSE}
  • passwordValue = {PLAIN, MASK, OBFUSCATE}
Für eine FtpServer-Ressource sind folgende Eigenschaftsnamen zulässig:
  • serverName
  • securityIdentity
  • accountInfo
  • remoteDirectory
  • connectionType
  • scanDelay
  • transferMode
Für eine BrokerRegistry-Ressource sind folgende Eigenschaftsnamen zulässig:
  • brokerKeystoreType
  • brokerKeystoreFile
  • brokerKeystorePass
  • brokerTruststoreType
  • brokerTruststoreFile
  • brokerTruststorePass
  • httpConnectorPortRange
  • httpsConnectorPortRange
-v Eigenschaftswert
(Erforderlich) Der Wert, der der Eigenschaft zugewiesen ist, die über den Parameter -n angegeben wird. Sie können mehrere Eigenschaftsnamen und die zugehörigen Werte angeben, indem Sie diese durch Kommas voneinander trennen; Beispiel: -n Name1, Name2 -v Wert1, Wert2.
UNIX platform Unter UNIX: Wenn der Parameter -v ein Semikolon (;) enthält, setzen Sie die gesamte Zeichenfolgen in Anführungszeichen, so wie im folgenden Beispiel gezeigt:
mqsichangeproperties WBRK_BROKER -c JDBCProviders -o DB2EXTRA -n connectionUrlFormat 
-v "jdbc:db2://[Servername]:[Portnummer]/[Datenbankname]:user=[Benutzer];password=[Kennwort];"

Wenn Sie den Parameter -c auf 'JMS-Providers' oder 'EISProviders' und den Parameter -n auf 'jarsURL' setzen, wird eine URL erwartet, die die Dateiadresse der JAR-Dateien des JMS- oder EIS-Providers angibt, wobei 'file://' in der URL übergangen wird.

Wenn Sie den Parameter -c auf 'SecurityProfiles' und den Parameter -n auf 'authentication' setzen, kann der Eigenschaftswert NONE, LDAP oder TFIM lauten oder ein benutzerdefinierter Wert zur Angabe einer Alternative sein.

Wenn Sie den Parameter -c auf 'SecurityProfiles' und den Parameter -n auf 'authenticationConfig' setzen, wird als Eigenschaftswert eine providerspezifische Konfigurationszeichenfolge erwartet.

Wenn Sie den Parameter -c auf 'SecurityProfiles' und den Parameter -n auf 'mapping' setzen, kann der Eigenschaftswert NONE oder TFIM lauten oder ein benutzerdefinierter Wert zur Angabe einer Alternative sein.

Wenn Sie den Parameter -c auf 'SecurityProfiles' und den Parameter -n auf 'mappingConfig' setzen, wird als Eigenschaftswert eine providerspezifische Konfigurationszeichenfolge erwartet.

Wenn Sie den Parameter -c auf 'SecurityProfiles' und den Parameter -n auf 'authorization' setzen, kann der Eigenschaftswert NONE, LDAP oder TFIM lauten oder ein benutzerdefinierter Wert zur Angabe einer Alternative sein.

Wenn Sie den Parameter -c auf 'SecurityProfiles' und den Parameter -n auf 'authorizationConfig' setzen, wird als Eigenschaftswert eine providerspezifische Konfigurationszeichenfolge erwartet.

Wenn Sie den Parameter -c auf 'SecurityProfiles' und den Parameter -n auf 'propagation' setzen, kann der Eigenschaftswert entweder TRUE oder FALSE lauten.

Wenn Sie den Parameter -c auf 'SecurityProfiles' und den Parameter -n auf 'passwordValue' setzen, kann der Eigenschaftswert entweder PLAIN, MASK oder OBFUSCATE lauten.

Für Broker-übergreifende Übertragungen steht der folgende Wert für Objektname zur Verfügung:
  • DynamicSubscriptionEngine
Für die Komponente 'httplistener' ist bei Verwendung der HTTPInput- und HTTPReply-Knoten folgender Wert für Objektname verfügbar:
  • HTTPListener zur Steuerung des HTTPListener-Prozesses.
Für die Komponente 'httplistener' sind bei Verwendung der SOAPInput- und SOAPReply-Knoten folgende Werte für Objektname verfügbar:
  • HTTPConnector zur Steuerung der HTTP-Kommunikation.
  • HTTPSConnector zur Steuerung der HTTPS-Kommunikation.
Für den Kompatibilitätsmodus mit vorherigen Versionen ist der folgende Wert Objektname verfügbar:
  • ComIbmXmlParserFactory
Für die securitycache-Komponente steht der folgende Wert für Objektname zur Verfügung:
  • SecurityCache

Parameterwerte für die Komponente 'httplistener'

Gültige Eigenschaftennamen für die Komponente 'httplistener':
maxKeepAliveRequests
Der Wert steht für die maximale Anzahl an HTTP-Anforderungen, die im Pipelinesystem verarbeitet werden können, bis die Verbindung vom Server geschlossen wird. Wird das Attribut auf 1 gesetzt, werden das HTTP/1.0 Keepalive-Paket sowie das HTTP/1.1 Keepalive-Paket und die Pipeline-Verarbeitung inaktiviert. Durch Festlegen des Werts -1 wird eine unbegrenzte Anzahl an im Pipelinesystem verarbeiteten Anforderungen oder Keepalive-HTTP-Anforderungen ermöglicht.
  • Wertetyp - Ganzzahl
  • Anfangswert -100
maxThreads
Der Wert steht für die maximale Anzahl an Anforderungsverarbeitungsthreads, die von diesem Connector erstellt werden sollen. Er bestimmt somit die maximale Anzahl an simultanen Anforderungen, die bearbeitet werden können.
  • Wertetyp - Ganzzahl
  • Anfangswert - 200
Gültige Eigenschaftsnamen für den HTTPConnector-Objektname (Empfangsprogramm):
address
Für Server mit mehreren IP-Adressen gibt dieser Wert die Adresse an, unter der er an einem bestimmten Port empfangsbereit ist. Standardmäßig wird dieser Port für alle IP-Adressen verwendet, die dem Server zugeordnet sind. Wenn die Option angegeben wurde, kann nur eine Adresse verwendet werden.
  • Wertetyp - Zeichenfolge
  • Anfangswert - null
port
Der TCP-Port, an dem dieser Connector ein Server-Socket erstellt und auf eingehende Verbindungen wartet.
  • Wertetyp - Integer
  • Anfangswert - 7800
Gültige Eigenschaftsnamen für den HTTPConnector-Objektname (Ausführungsgruppen):
address
Für Server mit mehreren IP-Adressen gibt dieser Wert die Adresse an, unter der er an einem bestimmten Port empfangsbereit ist. Standardmäßig wird dieser Port für alle IP-Adressen verwendet, die dem Server zugeordnet sind. Wenn die Option angegeben wurde, kann nur eine Adresse verwendet werden.
  • Wertetyp - Zeichenfolge
  • Anfangswert - null
explicitlySetPortNumber
Der TCP-Port, an dem dieser Connector ein Server-Socket erstellt und auf eingehende Verbindungen wartet.

Dieser Wert kann im Bereich von 0 bis 65 536 liegen.

  • Wertetyp - Integer
  • Anfangswert - 7800
Entsprechend für HTTPSConnector Objektname:
  • Port gilt bei Verwendung des Empfangsprogramms
  • explicitlySetPortNumber gilt bei Verwendung von Ausführungsgruppen
Gültige Eigenschaftsnamen für den HTTPSConnector-Objektnamen:
address
Für Server mit mehreren IP-Adressen gibt dieser Wert die Adresse an, unter der er an einem bestimmten Port empfangsbereit ist. Standardmäßig wird dieser Port für alle IP-Adressen verwendet, die dem Server zugeordnet sind. Wenn die Option angegeben wurde, kann nur eine Adresse verwendet werden.
  • Wertetyp - Zeichenfolge
  • Anfangswert - null
port
Der TCP-Port, an dem dieser Connector ein Server-Socket erstellt und auf eingehende Verbindungen wartet.
  • Wertetyp - Integer
  • Anfangswert - 7800
explicitlySetPortNumber
Der TCP-Port, an dem dieser Connector ein Server-Socket erstellt und auf eingehende Verbindungen wartet.

Dieser Wert kann im Bereich von 0 bis 65 536 liegen.

  • Wertetyp - Integer
  • Anfangswert - 7800
algorithm
Der für die Zertifikatverschlüsselung verwendete Algorithmus
  • Wertetyp - Zeichenfolge
  • Anfangswert -
    • Solaris platform HP-UX platform SunX509 unter Solaris und HPUX
    • AIX platform z/OS platform Linux platform Windows platform IbmX509 und andere Plattformen (AIX, z/OS, Linux, Windows)
clientAuth
Setzen Sie diesen Wert auf 'true', wenn für den SSL-Stack ein gültige Zertifikatkette vom Client benötigt wird, bevor eine Verbindung akzeptiert wird. Wenn Sie den Wert 'false' (Standardwert) angeben, ist keine Zertifikatkette erforderlich, es sei denn, der Client fordert eine Ressource an, die durch eine Integritätsbedingung geschützt ist, die CLIENT-CERT-Authentifizierung verwendet.
  • Wertetyp - Zeichenfolge
  • Anfangswert - false
keystoreFile
Der Pfad zur Schlüsselspeicherdatei mit dem Zertifikat, das geladen werden soll. Standardmäßig erwartet das HTTP-Empfangsprogramm eine Datei namens .keystore im Ausgangsverzeichnis des Benutzers, der den Broker gestartet hat.
  • Wertetyp - Zeichenfolge
  • Anfangswert - Standardwert (siehe oben)
keystorePass
Das Kennwort, das für den Zugriff auf das Serverzertifikat von der angegebenen Schlüsselspeicherdatei verwendet wird.
  • Wertetyp - Zeichenfolge
  • Anfangswert - changeit
keystoreType
Der Schlüsselspeicherdateityp, der für das Serverzertifikat verwendet werden soll.
  • Wertetyp - Zeichenfolge
  • Anfangswert - JKS
sslProtocol
Die Version des zu verwendenden SSL-Protokolls.
  • Wertetyp - Zeichenfolge
  • Anfangswert - SSLv3
ciphers
Eine durch Kommas getrennte Liste mit den Verschlüsselungen, die verwendet werden können. Wenn keine Option angegeben wurde (Standardauswahl), können alle verfügbaren Verschlüsselungen verwendet werden.
  • Wertetyp - Zeichenfolge
  • Anfangswert - null
Die gültigen Werte für keystoreType, sslProtocol und ciphers sind von der JSSE-Implementierung abhängig. Sie finden diese Werte in der Dokumentation, die vom JSSE-Provider zur Verfügung gestellt wurde.

Parameter für Broker-übergreifende Übertragungen

Es folgt eine Liste mit gültigen Eigenschaftennamen für Broker-übergreifende Übertragungen:
brokerInputQueues
Gibt die maximale Anzahl von Dispatchwarteschlangen an, die bei der Verarbeitung von Nachrichten, die über eine brokerübergreifende Verbindung empfangen werden, verwendet werden sollen. Durch Erhöhen des Wertes kann die Rate, mit der Nachrichten über eine brokerübergreifende Verbindung übertragen werden, erhöht werden:
  • Wertetyp - Integer
  • Anfangswert - 1
brokerInputQueueLength
Legt die maximale Anzahl Nachrichten fest, die in jeder Eingabewarteschlange gespeichert werden können. Je höher der Wert, desto größer die Anzahl der Eingabenachrichten, die in jeder Eingabewarteschlange gespeichert werden können. Je höher der Wert, desto größer ist aber auch der Speicherbereich, den der Broker für jede Warteschlange benötigt.
  • Wertetyp - Ganzzahl
  • Anfangswert - 99
brokerPingInterval
Zeit in Millisekunden zwischen den vom Broker abgesetzten Pingsignale auf Broker-Broker-Verbindungen. Pingsignale stellen sicher, dass der Übertragungsweg zwischen beiden Seiten der Verbindung weiterhin geöffnet ist, und werden intern generiert. Ist der Wert 0, leitet der Broker keine Pingsignale ein.
  • Wertetyp - Ganzzahl
  • Anfangswert - 5000
clientPingInterval
Zeit in Millisekunden zwischen den vom Broker abgesetzten Pingsignalen auf Broker-Client-Verbindungen. Pingsignale stellen sicher, dass der Übertragungsweg zwischen beiden Seiten der Verbindung weiterhin geöffnet ist, und werden intern generiert. Der Wert 0 bedeutet, dass der Broker keine Pingsignale absetzt.
  • Wertetyp - Ganzzahl
  • Anfangswert - 30000
clonedPubSubBrokerList
Die Liste der Broker, in denen der <Brokername> als Klon registriert ist.
Diese Liste hat das Format Brokername1,BrokerQMName1,Brokername2,BrokerQMName2. Wenn Sie also die drei Broker BRKA, BRKBund BRKC klonen möchten, müssen Sie die folgenden Befehle ausführen:
mqsichangeproperties BRKA -e default -o DynamicSubscriptionEngine
 -n clonedPubSubBrokerList -v \"BRKB,BRKBQM,BRKC,BRKCQM\"
mqsichangeproperties BRKB -e default -o DynamicSubscriptionEngine
 -n clonedPubSubBrokerList -v \"BRKA,BRKAQM,BRKC,BRKCQM\"
mqsichangeproperties BRKC -e default -o DynamicSubscriptionEngine
 -n clonedPubSubBrokerList -v \"BRKA,BRKAQM,BRKB,BRKBQM\"
Sie können auch Broker aus einer geklonten Umgebung entfernen. Beispiel: Sie entfernen BRKC mit folgenden Befehlen aus dem Klon:
mqsichangeproperties BRKA -e default -o DynamicSubscriptionEngine
 -n clonedPubSubBrokerList -v \"-BRKC\"
mqsichangeproperties BRKB -e default -o DynamicSubscriptionEngine
 -n clonedPubSubBrokerList -v \"-BRKC\"
mqsichangeproperties BRKC -e default -o DynamicSubscriptionEngine
 -n clonedPubSubBrokerList -v \"\"

Beachten Sie das Minuszeichen in der Liste für BRKA und BRKB. BRKC gibt keine Broker an und ist daher auch kein Klon. BRKA und BRKB bleiben jedoch weiterhin als gegenseitige Klons bestehen.

  • Wertetyp - Zeichenfolge
  • Anfangswert - keine
enableClientDiscOnQueueOverflow
Wird diese Eigenschaft auf 'true' (wahr) gesetzt, unterbricht der Broker die Verbindung zum Client, wenn nach dem Löschen aller möglichen Nachrichten der Wert für 'maxClientQueueSize' weiterhin überschritten wird.
  • Wertetyp - Boolescher Wert
  • Anfangswert - false
enableQopSecurity
Aktiviert den Grad des Datenschutzniveaus für Nachrichten.

Das Datenschutzniveau ist standardmäßig aktiviert, wenn entweder für isysQopLevel oder für sysQopLevel ein anderer Wert als der Standardwert 'none' angegeben wurde.

  • Wertetyp - Zeichenfolge
  • Anfangswert - keine
interbrokerHost
Gibt den IP-Hostnamen des Brokers an. Bei einer Einzelbrokerkonfiguration kann der Standardwert (null) beibehalten werden.

mqsichangeproperties <Broker> -o DynamicSubscriptionEngine -n interbrokerHost -v <IP-Hostname>

  • Wertetyp - Zeichenfolge
  • Anfangswert - null

Wenn Sie den Wert ändern, muss der Broker gestoppt und erneut gestartet werden. Anschließend müssen Sie die vollständige Topologie erneut implementieren.

interbrokerPort
Die Portnummer, an der der Broker für eingehende, brokerübergreifende Verbindungen empfangsbereit ist. Wenn auf demselben System mehrere Broker aktiv sein sollen, setzen Sie die Eigenschaft interbrokerPort für jeden Broker auf einen anderen Wert. Beispiel:

mqsichangeproperties <Broker> -o DynamicSubscriptionEngine -n interbrokerPort -v <Portnummer>

Wenn Sie den Wert für interbrokerPort nicht festlegen, bevor die Topologie implementiert wird, starten Sie den Broker erneut.

  • Wertetyp - Ganzzahl
  • Anfangswert -1507

Wenn Sie den Wert ändern, muss der Broker gestoppt und erneut gestartet werden. Anschließend müssen Sie die vollständige Topologie erneut implementieren.

isysQopLevel
Betrifft das System und erlaubt Brokern nur das Veröffentlichen und Subskribieren.
  • Wertetyp - Zeichenfolge
  • Anfangswert - keine
jvmMaxHeapSize
Gibt die Größe des Java Virtual Machine (JVM)-Heapspeichers an, der mit dem JVM-Manager für Java-Plug-in-Knoten verwendet wird.

Dieser Wert muss im Bereich 16 777 216 bis 8 589 934 592 liegen.

  • Wertetyp - Ganzzahl
  • Anfangswert - 134 217 728
maxBrokerQueueSize
Gibt die maximale Anzahl Bytes an, die der Broker zur Übertragung an einen anderen Broker in die Warteschlange stellen kann. Wird der Maximalwert überschritten, löscht der Broker alle an den betreffenden Broker gerichteten Nachrichten, außer der letzten Nachricht, Nachrichten mit hoher Priorität und Antworten. Der Wert 0 bedeutet, dass der Broker die Anzahl Bytes, die für einen anderen Broker in die Warteschlange gestellt werden, nicht begrenzt.
  • Wertetyp - Ganzzahl
  • Anfangswert - 1000000
maxClientQueueSize
Gibt die maximale Anzahl Bytes an, die der Broker zur Übertragung an einen Client in die Warteschlange stellen kann. Wird der Maximalwert überschritten, löscht der Broker alle an den betreffenden Client gerichteten Nachrichten, außer der letzten Nachricht, Nachrichten mit hoher Priorität und Antwortnachrichten. Der Wert 0 bedeutet, dass der Broker die Anzahl Bytes, die für einen Client in die Warteschlange gestellt werden, nicht begrenzt.
  • Wertetyp - Ganzzahl
  • Anfangswert - 100000

Der Wert für diese Eigenschaft muss größer als oder gleich dem Wert für maxMessageSize sein.

maxConnections
Gibt die maximale Anzahl gleichzeitig verbundener Clients an, die der Broker zulässt. Wird dieser Grenzwert erreicht, lehnt der Broker neue Verbindungsanforderungen von Clients ab. Wenn dieser Wert kleiner als 0 ist, ist die Anzahl der Clients nicht begrenzt.
  • Wertetyp - Ganzzahl
  • Anfangswert - 100
maxHopCount
Gibt die maximale Anzahl Multibroker-Links an, über die eine Nachricht gesendet wird, um sicherzustellen, dass Nachrichten in einem Multibroker-Netz nie in eine Schleife laufen. Der Wert muss groß genug sein, um sicherzustellen, dass Nachrichten das gesamte Multibroker-Netz durchlaufen können.
  • Wertetyp - Ganzzahl
  • Anfangswert - 20
maxMessageSize
Gibt die maximal zulässige Nachrichtenlänge in Bytes an. Wird von einem Client eine Nachricht empfangen, die diese maximale Länge überschreitet, wird die Verbindung mit dem Client getrennt.
  • Wertetyp - Ganzzahl
  • Anfangswert - 100000

Der Wert für diese Eigenschaft muss kleiner als oder gleich dem Wert für maxClientQueueSize sein.

multicastMaximumIPv4Address
Dies ist die höchste IPv4-Adresse, die der Broker für seine Multicasting-Übertragungen verwenden kann.
Diese Adresse muss im Bereich 224.0.0.2 bis 239.255.255.255 liegen
  • Wertetyp - Zeichenfolge
  • Anfangswert - 239.255.255.255
multicastMaximumIPv6Address
Dies ist die höchste IPv6-Adresse, die der Broker für seine Multicasting-Übertragungen verwenden kann.
Diese Adresse muss im Bereich ff02:0:0:0:0:0:0:1 bis ff02:ffff:ffff:ffff:ffff:ffff:ffff:ffff liegen
  • Wertetyp - Zeichenfolge
  • Anfangswert - ff02:ffff:ffff:ffff:ffff:ffff:ffff:ffff
multicastMinimumIPv4Address
Dies ist die niedrigste IPv4-Adresse, die der Broker für seine Multicasting-Übertragungen verwenden kann.
Diese Adresse muss im Bereich 224.0.0.2 bis 239.255.255.255 liegen
  • Wertetyp - Zeichenfolge
  • Anfangswert - 224.0.0.2
multicastMinimumIPv6Address
Dies ist die niedrigste IPv6-Adresse, die der Broker für seine Multicasting-Übertragungen verwenden kann.
Diese Adresse muss im Bereich ff02:0:0:0:0:0:0:1 bis ff02:ffff:ffff:ffff:ffff:ffff:ffff:ffff liegen.
  • Wertetyp - Zeichenfolge
  • Anfangswert - ff02:0:0:0:0:0:0:1
multicastBackoffTimeMillis
Gibt die maximale Zeit in Millisekunden an, die ein Client auf NACK-Signale von einem anderen Client wartet, bevor er selbst ein NACK-Signal sendet. Dieser Wert kann im Bereich 0 bis 1000 liegen.
  • Wertetyp - Ganzzahl
  • Anfangswert - 100
multicastDataPort
Dies ist der UDP-Datenport, über den Multicasting-Pakete gesendet und empfangen werden.
  • Wertetyp - Ganzzahl
  • Anfangswert - 34343
multicastEnabled
Gibt an, ob die Themen, die in der Konfigurationsdatei 'multicastTopicsConfigFile' definiert sind, als Multicasting-Übertragung geliefert werden. Wird der Wert auf 'true' (wahr) gesetzt, werden die in 'multicastTopicsConfigFile' definierten Themen als Multicasting-Übertragung geliefert.
  • Wertetyp - Boolescher Wert
  • Anfangswert - false
multicastHeartbeatTimeoutSec
Gibt die Zeit in Sekunden zwischen dem Eingang von Steuerpaketen bei jedem Client an. Wenn ein Steuerpaket nicht innerhalb der doppelten für diese Eigenschaft angegebenen Zeit nach Eingang des vorherigen Steuerpakets eingeht, kann ein Fehler vermutet werden.
  • Wertetyp - Ganzzahl
  • Anfangswert - 20
multicastLimitTransRate
Diese Eigenschaft kann in Verbindung mit der Eigenschaft multicastTransRateLimitKbps zur Überwachung der Netzüberlastung verwendet werden. Gültige Werte sind:
Disabled (Inaktiviert)
Multicasting-Daten werden so schnell wie möglich übertragen.
Static (Statisch)
Die Übertragungsrate wird durch den in multicastTransRateLimitKbps angegebenen Wert begrenzt.
Dynamic (Dynamisch)
Die Übertragungsrate kann während der Verarbeitung variieren, darf den in multicastTransRateLimitKbps angegebenen Wert aber nie überschreiten.
  • Wertetyp - Zeichenfolge
  • Anfangswert - Disabled
multicastMaxKeyAge
Maximales Alter eines Verschlüsselungsschlüssels in Minuten, bevor dieser erneut definiert werden muss.
  • Wertetyp - Zeichenfolge
  • Anfangswert - 360
multicastMaxMemoryAllowedKBytes
Maximale Speicherbelegung (in KB) durch die Clientempfangspuffer.
  • Wertetyp - Ganzzahl
  • Anfangswert - 262144

Dieser Parameter steht nur dann zur Verfügung, wenn das PGM-Protokoll (Pragmatic General Multicast) ausgewählt wurde.

multicastMCastSocketTTL
Gibt die maximale Anzahl Hops an, die ein Multicasting-Paket zwischen dem Client und dem Broker durchlaufen darf. Dieser Wert liegt um eins höher als die maximale Anzahl Router, die zwischen dem Client und dem Broker liegen können.
Der Wert 1 bedeutet, dass das Paket alle lokalen Knoten erreicht, aber nicht von Routern weitergeleitet werden kann. Der Maximalwert ist 255
  • Wertetyp - Ganzzahl
  • Anfangswert - 1
multicastMinimalHistoryKBytes
Dies ist die Mindestgröße in KB eines Puffers, der als Archiv für alle übertragenen Pakete angelegt wird. Dieser Puffer wird von allen zuverlässigen Themen gemeinsam genutzt. Mit seiner Hilfe können verloren gegangene Pakete wiederhergestellt werden. Dieser Wert muss im Bereich 1000 bis 1000000 liegen.
  • Wertetyp - Ganzzahl
  • Anfangswert - 60000
multicastMulticastInterface
Gibt an, welche Schnittstelle für Multicasting-Übertragungen verwendet werden soll. Sie können einen Hostnamen oder eine IP-Adresse angeben. Der Wert None bewirkt, dass die Netzschnittstelle betriebssystemabhängig ist. IPv4-Brokernetzschnittstelle und IPv6-Brokernetzschnittstelle verwenden denselben Befehl; trennen Sie die IPv4- und IPv6-Adressen durch ein Semikolon (;).
  • Wertetyp - Zeichenfolge
  • Anfangswert - None
Anmerkung: Wenn nur eine Netzkarte vorhanden ist, muss der Standardwert 'none' nicht geändert werden, weil das Betriebssystem den Wert localhost verwendet. Sind jedoch mehrere Netzkarten vorhanden, müssen Sie diesen Parameter angeben, um sicherzustellen, dass die richtige Karte verwendet wird.
multicastNACKAccumulationTimeMillis
Gibt die Zeit in Millisekunden an, in der NACK-Signale im Broker zusammengefasst werden, bevor wiederhergestellte Pakete gesendet werden. Dieser Wert muss im Bereich 50 bis 1000 liegen.
  • Wertetyp - Ganzzahl
  • Anfangswert - 300
multicastNACKCheckPeriodMillis
Gibt die Zeit in Millisekunden zwischen periodischen Überprüfungen von Empfangsstatus und Folgeabstandserkennung für die NACK-Erstellung an. Dieser Wert muss im Bereich 10 bis 1000 liegen.
  • Wertetyp - Ganzzahl
  • Anfangswert - 500
multicastOverlappingTopicBehavior
Über diese Eigenschaft wird das Verhalten des Brokers gesteuert, wenn ein Client eine Multicasting-Subskription für ein Thema anfordert, das Teil einer Themenhierarchie mit Themen ist, die explizit für Multicasting-Übertragungen ausgeschlossen sind. Gültige Werte sind:
Accept (Akzeptieren)
Eine entsprechende Multicasting-Subskription wird akzeptiert und alle Veröffentlichungen zum gewünschten Thema werden im Multicasting-Betrieb übertragen, mit Ausnahme der Themen, die explizit davon ausgeschlossen sind.
Reject (Zurückweisen)
Eine Multicasting-Subskription zu einem Thema mit untergeordneten Themen, die nicht für Multicasting aktiviert sind, wird vom Broker zurückgewiesen.
Revert (Zurücksetzen)
Subskriptionen zu einem Thema (oder diesem Thema untergeordneten Thema), die nicht für Multicasting aktiviert sind, haben Unicastübertragungen zur Folge.
  • Wertetyp - Zeichenfolge
  • Anfangswert - Accept
multicastPacketBuffers
Gibt die Anzahl Speicherpuffer an, die beim Start für den Paketempfang erstellt werden. Sind sehr viele Puffer verfügbar, erhöht dies die Empfangsleistung und reduziert die Paketverluste bei hohen Zustellraten, allerdings mit dem Nachteil einer erhöhten Speicherauslastung. Jeder Puffer ist 33 KB groß, und der Wert kann im Bereich 1 bis 5000 liegen.
  • Wertetyp - Ganzzahl
  • Anfangswert - 500
multicastPacketSizeBytes
Gibt die Größe von Multicasting-Paketen in Bytes an. Dieser Wert muss im Bereich 500 bis 32000 liegen.
  • Wertetyp - Ganzzahl
  • Anfangswert - 7000
multicastProtocolType
Gibt den Protokolltyp an. Gültige Werte sind:
  • PTL
  • PGM/IP
  • PGM/UDP
  • Wertetyp - Zeichenfolge
  • Anfangswert - PTL
multicastSocketBufferSizeKbytes
Gibt die Größe in KB des Socket-Empfangspuffers des Clients an. Ein höherer Wert hat geringere Verlustraten zur Folge. Dieser Wert kann im Bereich 65 bis 10000 liegen.
  • Wertetyp - Ganzzahl
  • Anfangswert - 3000
multicastTransRateLimitKbps
Dieser Wert begrenzt die allgemeine Übertragungsrate in KB (Kilobits) pro Sekunde.
Diese Eigenschaft ist nur wirksam, wenn die Eigenschaft multicastLimitTransRate nicht auf 'Disabled' gesetzt ist. Der Wert für diese Eigenschaft darf nicht über der maximalen Datenübertragungsrate des Systems oder Netzes liegen und muss im Bereich 10 bis 1000000 liegen.
  • Wertetyp - Ganzzahl
  • Anfangswert - 9500
nonDurableSubscriptionEvents
Gibt an, ob der Benutzer Ereignisnachrichten anfordert, wenn ein nicht permanenter Subskribent erstellt oder gelöscht wird. Der Wert 'true' (wahr) bedeutet, dass eine Ereignisveröffentlichung erstellt wird, 'false' (falsch) bedeutet, dass keine Ereignisveröffentlichungen erfolgen.
  • Wertetyp - Boolescher Wert
  • Anfangswert - false
pingTimeoutMultiple
Gibt die Anzahl der aufeinander folgenden Client-Ping-Intervalle (clientPngInterval) bzw. Broker-Ping-Intervalle (brokerPngInterval) ohne Antwort an, die der Broker abwartet, bevor er die Verbindung mit einem Client oder Broker trennt.
  • Wertetyp - Ganzzahl
  • Anfangswert - 3
statsInterval
Der Wert gibt die Anzahl Millisekunden zwischen Veröffentlichungen von statistischen Daten an. Der Wert 0 bedeutet, dass keine Veröffentlichungen von statistischen Daten generiert werden. Nach einer Änderung dieser Eigenschaft muss der Broker zwar nicht erneut gestartet werden, es kann jedoch bis zu einer Minute vergehen, bis der Broker wieder damit beginnt, statistische Daten zu erstellen.
Dieser Wert muss im Bereich 0 bis 1000 liegen.
  • Wertetyp - Ganzzahl
  • Anfangswert - 0
Anmerkung: Dieser Wert bezieht sich nur auf das Publish/Subscribe-Statistikintervall.
sysQopLevel
Betrifft das System und erlaubt Brokern nur das Veröffentlichen.
  • Wertetyp - Zeichenfolge
  • Anfangswert - keine

Parameterwerte für die Publish/Subscribe-Komponente

Gültige Eigenschaftsnamen für die Publish/Subscribe-Komponente:
httpDispatchThreads
Der Wert gibt die Anzahl Threads an, die der Broker zum Verwalten von HTTP-Tunnelung-Clients reserviert.
  • Wertetyp - Ganzzahl
  • Anfangswert -32
httpProtocolTimeout
Der Wert gibt die Anzahl Millisekunden im Zeitlimitintervall des HTTP-Protokolls an. Sie können diesen Wert ändern, um die Zeit, die ein Broker während jeder Phase des HTTP-Tunnelung-Protokolls auf das nächste Ereignis warten soll. Der Wert 0 hat zur Folge, dass der Broker unbegrenzte Zeit wartet.
  • Wertetyp - Ganzzahl
  • Anfangswert -10000

Parameterwerte für die Komponente 'securitycache'

Gültige Eigenschaftennamen für die Komponente 'securitycache':
cacheSweepInterval
Das Intervall zwischen den einzelnen Sicherheitscache-Translationen zur Entfernung inaktivierter Einträge. Die Zeitangabe erfolgt in Sekunden.
  • Wertetyp - Integer
  • Anfangswert - 300
cacheTimeout
Der Zeitlimitwert, mit dem Einträge im Cache als ungültig markiert werden. Die Zeitangabe erfolgt in Sekunden.
  • Wertetyp - Integer
  • Anfangswert - 60

Parameterwerte für die Komponente 'brokerregistry'

Gültige Eigenschaftsnamen für die Komponente 'brokerregistry':
brokerKeystorePass
Das Kennwort, das für den Zugriff auf das Serverzertifikat von der angegebenen Schlüsselspeicherdatei verwendet wird.

Legen Sie das Kennwort mit dem Befehl mqsisetdbparms fest, wenn der Broker gestoppt ist.

  • Wertetyp - Zeichenfolge
  • Anfangswert - brokerKeystore::password
brokerKeystoreFile
Der Pfad zur Schlüsselspeicherdatei mit dem Zertifikat, das geladen werden soll. Standardmäßig erwartet das HTTP-Empfangsprogramm eine Datei mit dem Namen .keystore im Ausgangsverzeichnis des Benutzers, der den Broker gestartet hat.
  • Wertetyp - Zeichenfolge
  • Anfangswert - Standardwert (siehe oben)
brokerKeystoreType
Der Schlüsselspeicherdateityp, der für das Serverzertifikat verwendet werden soll.
  • Wertetyp - Zeichenfolge
  • Anfangswert - JKS
brokerTruststorePass
Das Kennwort, das für den Zugriff auf das Serverzertifikat von der angegebenen Schlüsselspeicherdatei verwendet wird.

Legen Sie das Kennwort mit dem Befehl mqsisetdbparms fest, wenn der Broker gestoppt ist.

  • Wertetyp - Zeichenfolge
  • Anfangswert - brokerKeystore::password
brokerTruststoreFile
Der Pfad zur Schlüsselspeicherdatei mit dem Zertifikat, das geladen werden soll. Standardmäßig erwartet das HTTP-Empfangsprogramm eine Datei mit dem Namen .keystore im Ausgangsverzeichnis des Benutzers, der den Broker gestartet hat.
  • Wertetyp - Zeichenfolge
  • Anfangswert - Standardwert (siehe oben)
brokerTruststoreType
Der Schlüsselspeicherdateityp, der für das Serverzertifikat verwendet werden soll.
  • Wertetyp - Zeichenfolge
  • Anfangswert - JKS
httpConnectorPortRange
Der numerische Bereich für die für den HTTP-Connector verfügbaren Ports.
  • Wertetyp - Integer
  • Anfangswert - 7800,7842
httpsConnectorPortRange
Der numerische Bereich für die für den HTTPS-Connector verfügbaren Ports.
  • Wertetyp - Integer
  • Anfangswert - 7800,7842

Berechtigung

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

UNIX platform Auf UNIX-Systemen muss die Benutzer-ID, mit der dieser Befehl aufgerufen wird, zur Gruppe mqbrkrs gehören.

Darüber hinaus muss der Broker für die verschiedenen Protokolle noch über die folgenden Berechtigungen verfügten:
PGM/IP
Der Broker benötigt folgende Berechtigungen:
  • Linux platform UNIX platform Root (auf Linux- und UNIX-Systemen)
  • Windows platform Administrator (auf Windows-Systemen)
  • z/OS platform Root (nur UNIX System Services unter z/OS)
PGM/UDP
Der Broker benötigt auf allen unterstützten Plattformen die Berechtigung User.
PTL
Der Broker benötigt auf allen unterstützten Plattformen die Berechtigung User.

Beispiele

Den Wert 200 für das Client-Ping-Intervall angeben
mqsichangeproperties TEST -o DynamicSubscriptionEngine -n clientPingInterval -v 200 
Multicasting aktivieren
mqsichangeproperties TEST -o DynamicSubScriptionEngine -n multicastEnabled -v true
Das SSL-Standardprotokoll von SSLv3 in TLS ändern
mqsichangeproperties TEST -b httplistener -o HTTPSConnector -n sslProtocol -v TLS 
Portnummer beim Ändern von Eigenschaften über Ausführungsgruppen festlegen
mqsichangeproperties TEST -e exgroup1 -o HTTPSConnector -n explicitlySetPortNumber -v 7777 
Portbereich für den HTTP-Connector im Brokerregister festlegen
mqsichangeproperties -o Brokerregistry -n HTTPConnectorPortRange -v 7777,8888 
HTTPS-Connector aktivieren
mqsichangeproperties TEST -b httplistener -o HTTPListener -n enableSSLConnector -v true
Speicherposition der JAR-Dateien für den IBM SIB JMS-Client festlegen
mqsichangeproperties WBRK6_DEFAULT_BROKER -c JMSProviders -o JMS_Default_IBM_SIB -n jarsURL -v file://D:\SIBClient\Java
Geben Sie den Befehl in einer einzigen Zeile ein. Der Zeilenumbruch wurde hier lediglich zur besseren Lesbarkeit eingefügt.
TFIM-Identitätsabgleich aktivieren
mqsichangeproperties WBRK6_DEFAULT_BROKER -c SecurityProfiles -o MyFirstSecurityProfile -n mapping,mappingConfig -v TFIM,http://tfimhost1.ibm.com
Geben Sie den Befehl in einer einzigen Zeile ein. Der Zeilenumbruch wurde hier lediglich zur besseren Lesbarkeit eingefügt.
Importieren Sie einen Richtliniensatz aus einer Datei auf einen Broker:
mqsichangeproperties WBRK_BROKER -c PolicySets -o Policy_2 -n ws-security -p policyset.xml
Dieser Befehl liest die Datei 'policyset.xml' und legt deren Inhalt als Policy_2 im Broker WBRK_BROKER fest. Mit dem Befehl werden Richtliniensätze zwischen Brokern festgelegt, oder es erfolgt eine Wiederherstellung auf Basis einer Sicherung. Geben Sie den Befehl in einer einzigen Zeile ein. Der Zeilenumbruch wurde hier lediglich zur besseren Lesbarkeit eingefügt.
Importieren Sie eine Richtliniensatzbindung aus einer Datei auf einen Broker:
mqsichangeproperties WBRK_BROKER -c PolicySetBindings -o Bindings_2 -n ws-security -p bindings.xml
Dieser Befehl liest die Datei bindings.xml und legt deren Inhalt als Bindings_2 im Broker WBRK_BROKER fest. Mit dem Befehl werden Richtliniensatzbindungen zwischen Brokern festgelegt, oder es erfolgt eine Wiederherstellung auf Basis einer Sicherung. Geben Sie den Befehl in einer einzigen Zeile ein. Der Zeilenumbruch wurde hier lediglich zur besseren Lesbarkeit eingefügt.
Stellen Sie die JAR-Dateien und gemeinsam genutzten Bibliotheken dem WebSphere Adapter for SAP zur Verfügung:
mqsichangeproperties WBRK6_DEFAULT_BROKER -c EISProviders -o SAP -n jarsURL,nativeLibs 
      -v c:\sapjco\jars,c:\sapjco\bin
Geben Sie den Befehl in einer einzigen Zeile ein. Der Zeilenumbruch wurde hier lediglich zur besseren Lesbarkeit eingefügt.
Aktualisieren Sie die Sicherheitsidentität für den JDBCProvider-Service für Oracle:
mqsichangeproperties WBRK6_DEFAULT_BROKER -c JDBCProviders -o Oracle -n securityIdentity 
      -v OracleDSN
OracleDSN ist der DSN, dem Sie mit dem Befehl mqsisetdbparms eine Benutzer-ID und ein Kennwort zugeordnet haben. Geben Sie den Befehl in einer einzigen Zeile ein. Der Zeilenumbruch wurde hier lediglich zur besseren Lesbarkeit eingefügt.
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
an09140_