Befehl "createSIBWMQServer"
Verwenden Sie den Befehl createSIBWMQServer, um einen neuen IBM MQ-Server auf Zellenebene zu erstellen.
Sie können einen neuen IBM MQ-Server, wie in diesem Artikel beschrieben, mit dem Tool "wsadmin" erstellen, oder Sie können, wie im Artikel IBM MQ-Serverdefinition erstellen 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
Zielobjekt
Eine Zelle von WebSphere Application Server.
Erforderliche Parameter
- -name
- Der Name des IBM MQ-Servers. Dieser Wert wird nur für Verwaltungszwecke verwendet und kann vom Administrator festgelegt werden. Der Name ist nur in der Verwaltung von WebSphere Application Server von Bedeutung und muss auf Zellenebene eindeutig sein. Es gibt keinen Standardwert. Dieser Parameter kann nicht geändert werden.
- -serverName
- Der Name des Warteschlangenmanagers oder der Gruppe mit gemeinsamer Warteschlange. Dieser Wert ist der Name, anhand dessen der Warteschlangenmanager oder die Gruppe mit gemeinsamer Warteschlange identifiziert wird. Er wird diesem IBM MQ-Objekt von der IBM MQ-Verwaltung zugewiesen. Der WebSphere Application Server-Administrator muss immer den Namen verwenden, der von der IBM MQ-Verwaltung zugewiesen wird.
- -host
- Der Host, zu dem für die Kommunikation mit einem
Warteschlangenmanager oder einer Gruppe mit gemeinsamer Warteschlange eine Verbindung hergestellt wird.
Dieser Wert ist der Hostname oder die IP-Adresse des Warteschlangenmanagers oder der
Gruppe mit gemeinsamer Warteschlange, den bzw. die dieser
IBM MQ-Server darstellt.
Der Wert muss eine Zeichenfolge sein, die Folgendes angibt:
- einen symbolischen Hostnamen
- eine IPv4-Adresse,
- eine IPv6-Adresse.
- -transportChain
- Die abgehende Transportkette des Kanalframeworks, die verwendet werden soll, wenn eine Verbindung mit IBM MQ hergestellt wird. Wenn Sie diese Option nicht angeben, wird der Standardwert OutboundBasicWMQClient angenommen.
Vorgegebene Parameter
Ohne
Optionale Parameter
Für Messaging-Anwendungen, die in Service Integration ausgeführt werden, geben die optionalen Attribute "host", "port", "channel" und die Attribute für die Authentifizierungsaliasnamen zusammen den Zugriffspfad zu diesem IBM MQ-Server an. Weitere Informationen finden Sie im Artikel IBM MQ-Server: Verbindung und Authentifizierung.
- -port
- Die TCP/IP-Portnummer, an der der Warteschlangenmanager oder die Gruppe mit gemeinsamer Warteschlange, den bzw. die dieser IBM MQ-Server darstellt, Anforderungen empfängt. Der Standardwert ist 1414.
- -channel
- Der Clientkanalname des IBM MQ-Servers, der verwendet werden muss, wenn eine Verbindung zum Warteschlangenmanager oder zur Gruppe mit gemeinsamer Warteschlange, der bzw. die von diesem IBM MQ-Server dargestellt wird, aufgebaut wird. Dieser Wert ist der dem IBM MQ-Objekt von der IBM MQ-Verwaltung zugewiesene Name und muss immer von der WebSphere Application Server-Verwaltung verwendet werden. Der Standardwert ist SYSTEM.DEF.SVRCONN.
- -description
- Eine Kurzbeschreibung des IBM MQ-Servers. Dieser Name wird nur für Verwaltungszwecke verwendet.
- -securityAuthAlias
- Der Authentifizierungsaliasname, der verwendet werden soll, wenn eine Verbindung zu einem Warteschlangenmanager oder einer Gruppe mit gemeinsamer Warteschlange hergestellt wird. Dieser Parameter darf nicht verwechselt werden mit dem Authentifizierungsalias für Ressourcenerkennung.
- -trustUserIds
- Bestimmt, ob Benutzer-IDs, die in Nachrichten vom IBM MQ
empfangen werden, vom Service Integration Bus zusammen mit den Nachrichten übergeben 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.
Wird der Wert für dieses Feld auf FALSE gesetzt, wird die Benutzer-ID durch den Namen des
IBM MQ-Servers überschrieben.
Dieser Parameter hat zwei gültige Werte:
- TRUE
- Benutzer-IDs werden in Nachrichten weitergegeben.
- FALSE
- Benutzer-IDs werden nicht in Nachrichten weitergegeben.
- -allowDiscovery
- Dieser Wert legt fest, ob eine automatische Erkennung
der IBM MQ-Ressourcen ausgeführt wird oder nicht.
Dieser Parameter hat zwei gültige Werte:
- TRUE
- Die automatische Erkennung wird verwendet.
- FALSE
- Die automatische Erkennung wird nicht verwendet.
- -discoveryAuthAlias
- Der Authentifizierungsaliasname, der verwendet werden soll, wenn eine Verbindung für Ressourcenerkennung zu einem Warteschlangenmanager oder einer Gruppe mit gemeinsamer Warteschlange hergestellt wird. Dieser Wert darf nicht verwechselt werden mit dem Sicherheitsauthentifizierungsalias.
- -replyToQueue
- Die Empfangswarteschlange für Antworten, die für die Ressourcenerkennung verwendet werden soll. Dieser Wert ist der Name, der dem IBM MQ-Objekt von der IBM MQ-Verwaltung zugewiesen wurde. Es muss sich um den Namen einer Modellwarteschlange für eine temporäre dynamische Warteschlange handeln. Der WebSphere Application Server-Administrator muss immer den Namen verwenden, der von der IBM MQ-Verwaltung zugewiesen wird. Der Standardwert ist SYSTEM.DEFAULT.MODEL.QUEUE.
- -type
- Gibt an, ob das Objekt vom Typ "IBM MQ-Server"
ein Warteschlangenmanager oder eine Gruppe mit gemeinsamer Warteschlange ist, so wie dies
in der Verwaltung von WebSphere Application Server festgelegt wurde. Dieser Parameter hat zwei gültige Werte:
- MQ_QUEUE_MANAGER
- Der IBM MQ-Server stellt einen Warteschlangenmanager dar. Bei Auswahl dieses Werts ruft der Prozess zur Ressourcenerkennung die Namen der Warteschlangen ab, die den Warteschlangenmanagern gehören.
- MQ_QUEUE_SHARING_GROUP
- Der IBM MQ-Server stellt eine Gruppe mit gemeinsamer Warteschlange dar. Bei Auswahl dieses Werts ruft der Prozess zur Ressourcenerkennung die Namen der Warteschlangen ab, die zu den Gruppen mit gemeinsamer Warteschlange gehören.
- -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 verfügbar, wenn sich der Anwendungsserver und der Warteschlangenmanager
auf demselben Knoten befinden.
Im Transportmodus "Bindungen" darf nur
eine Verbindung 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.
Beispiel
- Mit Jython:
wsadmin>AdminTask.createSIBWMQServer(["-name", "Finance dept QM", "-serverName", "FDQM", "-type", "MQ_QUEUE_MANAGER", "-bindingsMode", "true", "-host", "findep01.ibm.com", "-port", 1414, "-transportChain", "OutboundSecureWMQClient"])
- Mit Jacl:
wsadmin>$AdminTask createSIBWMQServer {-name "Finance dept QM" -serverName FDQM -type MQ_QUEUE_MANAGER -bindingsMode true -host findep01.ibm.com -port 1414 -transportChain OutboundSecureWMQClient}