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.
Der Scripting-Client wsadmin wird über die Qshell ausgeführt.
Weitere Informationen finden Sie unter Qshell für die Ausführung von WebSphere-Scripts mit wsadmin-Scripting konfigurieren.
- 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')
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.
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.
- -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.
- -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.
- -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}