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

Mit dem Befehl mqsichangeproperties können Eigenschaften geändert werden, die im Zusammenhang mit einem Broker stehen und sich auf die Kommunikation zwischen den Brokern, die Java Virtual Machine und das HTTP-Empfangsprogramm (einschließlich HTTP- und HTTPS (SSL)-Unterstützung für die HTTPInput- und HTTPReply-Knoten) beziehen. Eine Änderung der Eigenschaften ist auch über die Konfigurationsmanager-Proxy-API möglich.

Beginn der ÄnderungMit dem Befehl mqsireportproperties können Sie Eigenschaften anzeigen, die einem Broker zugeordnet sind.Ende der Änderung

Hinweise zur Nutzung

  • Vor Ausführung des Befehls mqsichangeproperties ist sicherzustellen, dass der Broker aktiv ist.
  • Wenn Sie einen Wert ändern, müssen Sie den Broker stoppen und erneut starten, damit die Änderung wirksam wird.
  • Beginn der ÄnderungBeim Start eines Nachrichtenflusses, der HTTP-Knoten umfasst, startet der Broker das HTTP-Empfangsprogramm.Ende der Änderung

Syntax

Parameter

Brokername
(Erforderlich) Der Name des zu ändernden Brokers. Dieser Parameter muss zuerst angegeben werden.

 

-b HTTP-Empfangsprogramm
(Optional) Der Name der Komponente.

Beginn der ÄnderungSie müssen -b HTTP-Empfangsprogramm oder -c KonfigurierbarerService angeben.Ende der Änderung

-c KonfigurierbarerService
(Optional) Der Typ des konfigurierbaren Service. Der Typ ist vordefiniert, z. B. 'JMSProviders'. Mit dem Befehl mqsicreateconfigurableservice können Sie zusätzliche Services eines beliebigen definierten Typs definieren.

Beginn der ÄnderungSie müssen -b HTTP-Empfangsprogramm oder -c KonfigurierbarerService angeben.Ende der Änderung

-o Objektname
(Erforderlich) Der Name des Objekts, dessen Eigenschaften Sie ändern möchten.

Um die Kompatibilität mit vorherigen Versionen zu gewährleisten, können Sie für ObjectName auch ComIbmXmlParserFactory angeben.

-n Eigenschaftsname
(Erforderlich) Der Name der zu ändernden Eigenschaft. Alle Eigenschaftsnamen starten mit einem Zeichen in Kleinschreibung.
-v Eigenschaftswert
(Erforderlich) Der Wert, der der Eigenschaft zugewiesen ist, die über den Parameter -n angegeben wird.

Beginn der ÄnderungSie können mehrere Eigenschaftsnamen mit einem entsprechenden Wert angeben, indem Sie diese durch Kommas voneinander trennen, vorausgesetzt, Sie verwenden einen gültigen Wert für die zugehörige Eigenschaft; Beispiel: -n Name1,Name2 -v Wert1,Wert2. Ende der Änderung

Beginn der ÄnderungVermeiden Sie in der Liste mit Namen und zugehörigen Werten ein Leerzeichen nach den Kommas.Ende der Änderung

Geben Sie mithilfe von "" eine Leere PropertyValue-Zeichenfolge an.

mqsichangeproperties WBRK_BROKER -c JDBCProviders -o DB2EXTRA -n connectionUrlFormat 
-v "jdbc:db2://[Servername]:[Portnummer]/[Datenbankname]:user=[Benutzer];password=[Kennwort];"

 

Beginn der ÄnderungAusführliche Informationen zu gültigen Komponenten, konfigurierbaren Services, Objektnamen, Eigenschaften und Werten finden Sie in den entsprechenden Abschnitten: Ende der Änderung

Berechtigung

Auf Windows-Systemen muss dieser Befehl mit einer Benutzer-ID ausgeführt werden, die auf dem lokalen Computer der Gruppe Administrators angehört.

Auf Linux- und UNIX-Systemen muss dieser Befehl mit einer Benutzer-ID ausgeführt werden, die zur Gruppe mqbrkrs gehört.

Außerdem benötigt der Broker die folgende Berechtigung für die unterstützten Multicasting-Protokolle:
PGM/IP
Der Broker benötigt folgende Berechtigungen:
  • Linux platformUNIX platform Rootberechtigung auf Linux- und UNIX-Systemen
  • Windows platform Administratorberechtigung auf Windows-Systemen
  • z/OS platform Rootberechtigung (nur UNIX System Services) unter z/OS
PGM/UDP
Der Broker benötigt auf allen unterstützten Plattformen Benutzerberechtigung (User).
PTL
Der Broker benötigt auf allen unterstützten Plattformen Benutzerberechtigung (User).

Beispiele

Geben Sie den Befehl immer in einer einzigen Zeile ein. In einigen Beispielen wurde der Zeilenumbruch lediglich zur besseren Lesbarkeit eingefügt.

Änderungen an Brokerkomponenten

In den folgenden Beispielen wird der Parameter -b zur Ermittlung einer bestimmten Brokerkomponente angegeben.

  • HTTPSConnector für die HTTP-Knoten aktivieren, die im angegebenen Broker implementiert sind:
     mqsichangeproperties TEST -b httplistener -o HTTPListener -n enableSSLConnector -v true
  • SSL-Standardprotokoll für die auf dem angegebenen Broker implementierten HTTP-Knoten von SSLv3 in TLS ändern:
    mqsichangeproperties TEST  -b httplistener -o HTTPSConnector -n sslProtocol -v TLS 

Änderungen an Eigenschaften, die Ausführungsgruppen zugeordnet sind

Die folgenden Beispiele enthalten den Parameter -e zur Angabe der Ausführungsgruppe, die geändert werden soll.

  • Den Wert 200 für das Client-Ping-Intervall eines geklonten Brokers angeben:
    mqsichangeproperties TEST -e default -o DynamicSubscriptionEngine -n clientPingInterval -v 200 
  • Multicast für einen geklonten Broker aktivieren:
    mqsichangeproperties TEST -e default -o DynamicSubScriptionEngine -n multicastEnabled -v true
  • Die JVM-Portnummer zur Aktivierung der Fehlerbehebung in Nachrichtenflüssen festlegen:
    mqsichangeproperties TEST -e exgroup1 -o ComIbmJVMManager -n jvmDebugPort -v 8018 
  • Art des Server-Schlüsselspeichers festlegen:
    mqsichangeproperties TEST -e AddressSampleProvider -o ComIbmJVMManager -n keystoreType -v JKS

Änderungen an konfigurierbaren Services

Die folgenden Beispiele enthalten den Parameter -c zur Angabe des Typ des konfigurierbaren Service, der geändert werden soll.

  • Speicherposition der JAR-Dateien für den IBM WebSphere MQ JMS-Client festlegen:
    mqsichangeproperties WBRK6_DEFAULT_BROKER -c JMSProviders -o WebSphere_MQ  
    -n jarsURL -v file://D:\SIBClient\Java
Zugehörige Konzepte
Brokerdomänen
Zugehörige Tasks
Brokerdomäne verwalten
Zugehörige Informationen
API des Konfigurationsmanager-Proxys
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009. Alle Rechte vorbehalten.
Letzte Aktualisierung : 2009-02-17 15:49:52

an09140_