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.

[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 erstellt einen neuen IBM MQ-Server auf Zellenebene und verwendet die angegebenen Werte für seine Parameter.
Anmerkung: Wenn Sie einen IBM MQ-Server erstellen, müssen Sie unbedingt die Bedeutung der Parameter -name und -serverName kennen. Wenn in der Verwaltung von WebSphere Application Server beispielsweise ein Objekt vom Typ "IBM MQ-Server" mit dem Namen "Mein Server für Europa" erstellt wurde, das einen IBM MQ-Warteschlangenmanager mit dem Wert QM1 für serverName darstellt. Anschließend könnte in der Verwaltung von WebSphere Application Server ein zweites Objekt vom Typ "IBM MQ-Server" mit dem Namen "Mein Server für Deutschland" erstellt werden, das denselben IBM MQ-Warteschlangenmanager mit dem Wert QM1 für serverName darstellt.

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.
Der Standardwert ist TRUE.
-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.
Der Standardwert ist TRUE.
-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}

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_create
Dateiname:rjfp_cli_mqserver_create.html