Befehl "modifySIBWMQServer"

Verwenden Sie den Befehl modifySIBWMQServer, um einen IBM MQ-Server zu ändern.

Sie können einen IBM MQ-Server wie in diesem Artikel beschrieben mit dem Tool "wsadmin" ändern oder Sie können wie im Artikel IBM MQ-Serverdefinition ändern beschrieben die Administrationskonsole verwenden.

Verwenden Sie zum Ausführen des Befehls das Objekt AdminTask des Scripting-Clients wsadmin.

[IBM i][IBM i]Der Scripting-Client wsadmin wird über die Qshell ausgeführt. [IBM i]Weitere Informationen finden Sie unter Qshell für die Ausführung von WebSphere-Scripts mit wsadmin-Scripting konfigurieren.

Für die SIB-Befehle wird jeweils eine Befehlszeilenhilfe bereitgestellt:
  • Geben Sie den folgenden Befehl an der wsadmin-Eingabeaufforderung ein, um eine Liste der verfügbaren SIB-Befehle in Jython und eine Kurzbeschreibung jedes einzelnen Befehls anzuzeigen:

    print AdminTask.help('SIBAdminCommands')

  • Zum Anzeigen einer übersichtlichen Hilfe zu einem bestimmten Befehl geben Sie an der wsadmin-Eingabeaufforderung den folgenden Befehl ein:

    print AdminTask.help('Befehlsname')

Speichern Sie Ihre Änderungen nach der Ausführung des Befehls in der Masterkonfiguration. Verwenden Sie hierfür beispielsweise den folgenden Befehl:

AdminConfig.save()

Zweck

Ein IBM MQ-Server stellt einen IBM MQ-Warteschlangenmanager bzw. (für IBM MQ for z/OS) eine Gruppe mit gemeinsamer Warteschlange dar. Dieser Befehl ändert einen IBM MQ-Server. Name und Attribute können mit diesem Befehl jedoch nicht geändert werden.

Anmerkung: Wenn Sie einen IBM MQ-Server ändern, ist es wichtig, dass Sie die Bedeutung der Attribute name und serverName kennen. Wenn ein WebSphere Application Server-Administrator beispielsweise einen IBM MQ-Server mit dem Namen "My European Area Server" erstellt, der einen IBM MQ-Warteschlangenmanager mit dem Servernamen (serverName) QM1 darstellt, kann der Administrator einen zweiten IBM MQ-Server mit dem Namen "My UK Country Server" erstellen, der denselben Warteschlangenmanager darstellt.

Zielobjekt

Ein ausgewähltes Busmember des Typs IBM MQ-Server.

Erforderliche Parameter

-name
Der Name des IBM MQ-Servers. Der Name wird angegeben, wenn die IBM MQ-Serverdefinition erstellt wird.

Vorgegebene Parameter

Ohne

Optionale Parameter

-serverName
Der Name des Warteschlangenmanagers oder der Gruppe mit gemeinsamer Warteschlange. Dies ist der Name, über den der Warteschlangenmanager bzw. die Gruppe mit gemeinsamer Warteschlange identifiziert wird. Der Wert wird der betreffenden IBM MQ-Ressource von der IBM MQ-Verwaltung zugewiesen. Der Administrator verwendet immer den Namen, der von der IBM MQ-Verwaltung zugewiesen wurde.
-host
Ein neuer Wert für das Attribut host. Dieser Wert ist der Name oder die IP-Adresse des Hosts, zu dem eine Verbindung hergestellt wird, um die die Kommunikation mit einem Warteschlangenmanager oder einer Gruppe mit gemeinsamer Warteschlange, den oder die dieser IBM MQ-Server darstellt, zu ermöglichen. Der Wert muss eine Zeichenfolge sein, die Folgendes angibt:
  • einen symbolischen Hostnamen,
  • eine IPv4-Adresse,
  • eine IPv6-Adresse.
-bindingsMode
Ein neuer Wert für das Attribut bindingsMode. Dieser Wert legt fest, ob Verbindungen mit dem Transportmodus "Bindungen" verwendet werden, wenn Verbindungen zu einem Warteschlangenmanager oder zu einer Gruppe mit gemeinsamer Warteschlange aufgebaut werden. Der Transportmodus "Bindungen" ist dann möglich, wenn sich der Anwendungsserver und der Warteschlangenmanager auf demselben Knoten befinden. Eine Verbindung darf aber nur zu einem einzigen Warteschlangenmanager hergestellt werden, selbst wenn mehrere Warteschlangenmanager auf demselben Knoten existieren. Dieser Parameter hat zwei gültige Werte:
TRUE
Der Transportmodus "Bindungen" wird verwendet, falls er verfügbar ist. Wird diese Option ausgewählt und ist der Transportmodus "Bindungen" nicht verfügbar, dann wird für die Verbindungen standardmäßig der Transportmodus "Client" verwendet.
FALSE
Der Transportmodus "Client" wird immer verwendet.
Der Standardwert ist TRUE.
-port
Neuer Wert für das IBM MQ-Attribut port. Dieser Wert ist die Nummer des TCP/IP-Ports, an dem der Warteschlangenmanager oder die Gruppe mit gemeinsamer Warteschlange, der oder die von diesem IBM MQ-Server dargestellt wird, empfangsbereit ist. Der Standardwert ist 1414.
-channel
Neuer Wert für das IBM MQ-Attribut channel. Dieser Wert ist der Name des IBM MQ-Client-Kanals, der verwendet werden soll, wenn eine Verbindung zum Warteschlangenmanager oder zur Gruppe mit gemeinsamer Warteschlange hergestellt wird, der oder die von diesem IBM MQ-Server dargestellt wird. Dieser Name wird dem IBM MQ-Objekt von der IBM MQ-Verwaltung zugewiesen und muss immer vom WebSphere Application Server-Administrator verwendet werden. Der Standardwert ist SYSTEM.DEF.SVRCONN.
-description
Ein neuer Wert für das Attribut description. Dieser Wert ist eine Kurzbeschreibung des IBM MQ-Servers und wird ausschließlich für Verwaltungszwecke verwendet.
-securityAuthAlias
Ein neuer Wert für das Attribut securityAuthorizationAlias. Dieser Wert ist der Authentifizierungsaliasname, der verwendet werden soll, wenn eine Verbindung zu einem Warteschlangenmanager oder einer Gruppe mit gemeinsamer Warteschlange hergestellt wird. Dies ist nicht derselbe Parameter wie der Authentifizierungsalias für Ressourcenerkennung.
-transportChain
Ein neuer Wert für das Attribut transportChain. Dieser Wert ist die abgehende Transportkette, die verwendet werden soll, wenn eine Verbindung mit IBM MQ hergestellt wird. Der Standardwert ist OutboundBasicWMQClient.
-trustUserIds
Ein neuer Wert für das Attribut trustUserIds. Legt fest, ob Benutzer-IDs, die in Nachrichten von IBM MQ empfangen wurden, in der Nachricht weitergegeben werden oder nicht (d. h., ob die Benutzer-IDs, die als Teil der Nachrichtendaten empfangen wurden, im Service Integration Bus verwendet werden). Die Anwendungsbenutzer-ID wird immer auf der Basis des RFH2-Werts jsAppUserId festgelegt. Ist dieser Wert nicht vorhanden (weil das Schlüssel/Wert-Paar im RFH2-Header nicht existiert oder weil die Nachricht keinen RFH2-Header hat), dann wird dieses Feld nicht festgelegt. Wenn Sie diesen Wert auf FALSE setzen, wird die Benutzer-ID mit dem IBM MQ-Servernamen überschrieben. Dieser Parameter hat zwei gültige Werte:
TRUE
Benutzer-IDs werden in Nachrichten weitergegeben.
FALSE
Benutzer-IDs werden nicht in Nachrichten weitergegeben.
Der Standardwert ist TRUE.
-allowDiscovery
Ein neuer Wert für das Attribut allowDiscovery. Dieser Wert legt fest, ob die automatisierte Erkennung von IBM MQ-Ressourcen ausgeführt wird. Dieser Parameter hat zwei gültige Werte:
TRUE
Die automatische Erkennung von Ressourcen ist aktiviert.
FALSE
Die automatische Erkennung von Ressourcen ist inaktiviert.
Der Standardwert ist TRUE.
-discoveryAuthAlias
Ein neuer Wert für das Attribut discoveryAuthAlias. Dieser Wert ist der Authentifizierungsaliasname, der verwendet werden soll, wenn eine Verbindung für Ressourcenerkennung zu einem Warteschlangenmanager oder einer Gruppe mit gemeinsamer Warteschlange hergestellt wird. Dies ist nicht dasselbe wie der Parameter für den Sicherheitsauthentifizierungsalias securityAuthAlias (security authentication alias).
-replyToQueue
Ein neuer Wert für das Attribut replyToQueue. Dieser Wert ist die für die Ressourcenerkennung zu verwendende Antwortwarteschlange (Warteschlange für zu beantwortende Nachrichten), der dem IBM MQ-Objekt von der IBM MQ-Verwaltung zugewiesene Name und es muss sich dabei um den Namen einer Modellwarteschlange für eine temporäre dynamische Warteschlange handeln. Die WebSphere Application Server-Verwaltung muss immer den mit der IBM MQ-Verwaltung vereinbarten Namen verwenden. Der Standardwert ist SYSTEM.DEFAULT.MODEL.QUEUE.

Beispiel

  • Mit Jython:
    wsadmin>AdminTask.modifySIBWMQServer(["-name", "Finance dept QM",
     "-allowDiscovery", "false"] )
  • Mit Jacl:
    wsadmin>$AdminTask modifySIBWMQServer {-name "Finance dept QM"
     -allowDiscovery false}

Symbol, das den Typ des Artikels anzeigt. Referenzartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjfp_cli_mqserver_mod
Dateiname:rjfp_cli_mqserver_mod.html