Befehl "modifySIBMQLink"
Verwenden sie den Befehl modifySIBMQLink, um die Eigenschaften eines IBM MQ-Links zu ändern.
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
Der Befehl modifySIBMQLink ändert die Eigenschaften eines IBM MQ-Links.
Zielobjekt
Ein IBM MQ-Link.
Erforderliche Parameter
- -bus
- Der Name des Service Integration Bus, für den Sie den IBM MQ-Link erstellt haben. Mit dem Befehl listSIBuses können Sie die Namen vorhandener Busse auflisten.
- -messagingEngine
- Der Name der Messaging-Engine, für die Sie den IBM MQ-Link erstellt haben. Mit dem Befehl listSIBEngines können Sie die Namen der vorhandenen Messaging-Engines auflisten.
- -name
- Der Name des IBM MQ-Links.
Vorgegebene Parameter
Ohne.
Optionale Parameter
- -queueManagerName
- Der Name des der Messaging-Engine zugeordneten virtuellen Warteschlangenmanagers, unter dem die Messaging-Engine einem fernen IBM MQ-Netz bekannt ist.
Der Name des Warteschlangenmanagers muss den Namenskonventionen von IBM MQ entsprechen. Beispielsweise darf der Name maximal 48 Zeichen enthalten.
- -description
- Eine optionale Beschreibung des Busses für Verwaltungszwecke.
- e-exceptionDestination
- Das Ziel für eine eingehende Nachricht, wenn der IBM MQ-Link die Nachricht des
geplanten Busziels oder des Ausnahmeziels, der die für dieses geplante Ziel konfiguriert ist, nicht zustellen kann
oder wenn das geplante Ziel nicht vorhanden ist.
- System
- Der IBM MQ-Link verwendet das Standardausnahmeziel. Alle Nachrichten, die dem Busziel nicht zugestellt werden können, werden automatisch an das Systemstandardausnahmeziel für die Messaging-Engine umgeleitet, den dieser Link zugeordnet ist: _SYSTEM.Exception.DestinationName_der_Messaging-Engine.
- Ohne
- Der IBM MQ hat kein Ausnahmeziel. Nicht zustellbare Nachrichten werden nicht an ein Ausnahmeziel umgeleitet und können die Verarbeitung anderer Nachrichten, die auf eine Zustellung über den Link an denselben Bus warten, blockieren. Diese Option kann verwendet werden, um die Nachrichtenreihenfolge zu bewahren.
- Angeben
- Der IBM MQ verwendet das hier angegebene Ausnahmeziel. Falls dies nicht möglich ist, verwendet er das Systemausnahmeziel.
- -batchSize
Die Stapelgröße hat keinen Einfluss darauf, wie die Sender- und Empfängerkanäle für diesen Link Nachrichten übertragen. Die Nachrichten werden immer einzeln übertragen, aber als Stapel festgeschrieben bzw. zurückgesetzt.
Weitere Informationen zur Auswahl der Stapelgröße finden Sie in der Beschreibung der Eigenschaft für die Stapelgröße (BATCHSZ) im Abschnitt zur übergreifenden Kommunikation im Information Center von IBM MQ.
Information Wert Standardwert 50 Einstellmöglichkeiten 1 bis 9999 - -maxMsgSize
Informationen zur Auswahl eines angemessenen Werts finden Sie in der Beschreibung der Eigenschaft für die maximale Nachrichtenlänge (MAXMSGL) im Abschnitt zur übergreifenden Kommunikation im Information Center von IBM MQ.
Information Wert Standardwert 4194304 Bytes (4 MB) Einstellmöglichkeiten 0 bis 104857600 Geben Sie 0 an, wenn Sie den größten Wert verwenden möchten, den der Zielwarteschlangenmanager berücksichtigt.
- -heartBeat
Überwachungssignale geben dem empfangenden Kanal die Möglichkeit, die Kanalverbindung stillzulegen.
Weitere Informationen zur Auswahl des Werts für diese Eigenschaft finden Sie im Abschnitt zur übergreifenden Kommunikation im Information Center von IBM MQ.
Information Wert Standardwert 300 Sekunden Einstellmöglichkeiten 0 bis 999999 - -sequenceWrap
- Wenn Sie
beispielsweise den Wert 1000 angeben, wird sie bei 1 erneut gestartet, wenn die Nachrichtenfolgenummern
den Wert 1001 erreichen.
Weitere Informationen zur Auswahl des Werts für diese Eigenschaft finden Sie in der Beschreibung der Eigenschaft für Folgenummernumlauf (SEQWRAP) im Abschnitt zur übergreifenden Kommunikation im Information Center von IBM MQ.
Information Wert Standardwert 999999999 Einstellmöglichkeiten 100 bis 999999999 - -nonPersistentMessageSpeed Fast | Normal
Information Wert Standardwert Schnell Einstellmöglichkeiten - Schnell
- Nicht persistente Nachrichten können verloren gehen, wenn ein Fehler bei der Übertragung auftritt oder wenn der Kanal während der Übertragung der Nachrichten gestoppt wird.
- Normal
- Nicht persistente Nachrichten gehen nicht verloren, wenn ein Fehler bei der Übertragung auftritt oder wenn der Kanal während der Übertragung der Nachrichten gestoppt wird.
- -adoptable True | False
- Eine Eigenschaft
des IBM MQ-Links, die zeigt, ob eine aktive Instanz eines
IBM MQ-Link-Empfängerkanals (der diesem
IBM MQ-Link zugeordnet ist) übernommen werden soll.
Bei einem Kommunikationsfehler kann eine aktive Instanz eines IBM MQ-Link-Empfängerkanals
in einem Status
verbleiben, in dem er auf Nachrichten wartet.
Wenn die Kommunikation wiederhergestellt ist und der
IBM MQ-Partnersenderkanal
das nächste Mal versucht, eine Sitzung mit dem IBM MQ-Link-Empfängerkanal aufzubauen,
scheitert die Anforderung, weil es bereits eine aktive Instanz des IBM MQ-Link-Empfängerkanals gibt, die annimmt,
dass sie eine Sitzung mit dem IBM MQ-Link-Partnersenderkanal besitzt.
Sie können dieses Problem durch Auswahl dieser Option beheben. Dadurch wird die bereits aktive
Instanz des IBM MQ-Link-Empfängerkanals
gestoppt und eine neue Instanz wird gestartet.
Wird diese Option auf True gesetzt, stellen IBM MQ-Senderkanäle möglicherweise erneut eine Verbindung zu diesem IBM MQ-Link her, wenn ein Kommunikationsfehler auftritt und der Link die Fehlerbedingung noch nicht erkannt hat.
Information Wert Standardwert True - -initialState Started | Stopped
- Der Status des IBM MQ-Links,
der anzeigt, ob der Link gestartet oder gestoppt wird, wenn die zugehörige Messaging-Engine
zum ersten Mal gestartet wird. Bis zum Start
ist der IBM MQ-Link nicht verfügbar.
Information Wert Standardwert Gestartet Einstellmöglichkeiten - Gestoppt
- Wenn die zugeordnete Messaging-Engine gestartet wird, ist der IBM MQ-Link gestoppt und kann nicht mit dem IBM MQ-Netz kommunizieren.
- Gestartet
- Wenn die zugeordnete Messaging-Engine gestartet wird, wird der IBM MQ-Link automatisch gestartet und ist für die Kommunikation mit dem IBM MQ-Netz bereit.
- -senderChannelName
Dieser Name muss mit dem Namen des Empfängerkanals in IBM MQ identisch sein.
Weitere Informationen zur Auswahl von Kanalnamen finden Sie in der Beschreibung der Eigenschaft für den Kanalnamen (CHANNEL) im Abschnitt zur übergreifenden Kommunikation im Information Center von IBM MQ.
- -hostName
- Der Hostname oder die TCP/IP-Adresse für den Gateway-Warteschlangenmanager, der für die Verbindungsherstellung
zum IBM MQ-Netz verwendet wird.
Geben Sie den Hostnamen oder die IP-Adresse des Hosts wein, auf dem der Warteschlangenmanager des Gateway ausgeführt wird.
Wenn dieses Feld leer ist, wird angenommen, dass der Gateway-Warteschlangenmanager auf demselben Host ausgeführt wird wie die Messaging-Engine, in der der IBM MQ-Link definiert ist.
- -port
Information Wert Standardwert 1414 Einstellmöglichkeiten 0 bis 65535 - -connameList
- Die Verbindungsnamensliste für den Gateway-Warteschlangenmanager, der verwendet wird, um die Verbindung zum IBM MQ-Netz herzustellen.
Die Verbindungen werden nacheinander in der Reihenfolge ausprobiert, in der sie in der Verbindungsnamensliste angegeben sind, bis eine Verbindung hergestellt werden kann. Kann keine
Verbindung hergestellt werden, beginnt der Kanal mit den Wiederholungen.
Die Verbindungsnamen müssen in Form einer durch Kommas getrennten Liste im folgenden Format angegeben werden.
Dnsname1(portnumber1) , Dnsname2(portnumber2)
Geben Sie den DNS-Namen oder die IP-Adresse des Hosts an, auf dem der Gateway-Warteschlangenmanager ausgeführt wird. Geben Sie eine Portnummer zwischen 0 und 65535 ein.
Wenn Sie den Parameter für die Verbindungsnamensliste nicht angeben, wird angenommen, dass der Gateway-Warteschlangenmanager auf demselben Host wie die Messaging-Engine ausgeführt wird, in der der IBM MQ-Link definiert ist.
Wenn Sie den Parameter für die Verbindungsnamensliste angeben, muss bereits ein Wert für den Senderkanalnamen angegeben worden sein. Andernfalls wird der Wert, den Sie für die Verbindungsnamensliste angeben, ignoriert.
Wenn Sie einen Hostnamen und einen Port und die Verbindungsnamensliste angeben, hat die Verbindungsnamensliste zur Laufzeit Vorrang, und die Hostnamens- und Portwerte werden ignoriert.
- -discInterval
Der Standardwert definiert ein angemessenes Intervall. Ändern Sie diesen Wert nur, wenn Sie sich genau über die Auswirkungen auf die Leistung im Klaren sind und Sie einen anderen Wert benötigen, um die Anforderungen bezüglich des Datenverkehrs in Ihren Kanälen bewältigen zu können.
Die Leistung wird durch den für das Intervall für Verbindungstrennung angegebenen Wert beeinflusst. Die Verwendung eines sehr niedrigen Wertes (ein paar Sekunden) kann zu einem inakzeptablen Verarbeitungsaufwand führen, weil der Kanal ständig gestartet wird. Ein sehr hoher Wert (mehr als eine Stunde) könnte die Systemressourcen unnötig lange blockieren.
Wenn Ihre Kanäle nur dann aktiv sein sollen, wenn zu übertragende Nachrichten für sie vorhanden sind, legen Sie einen relativ niedrigen Wert für das Intervall für Verbindungstrennung fest. Der Standardwert ist relativ hoch und wird deshalb nicht für Kanäle empfohlen, die diese Stufe der Steuerung erfordern. Da die Unterbrechung eines Empfängerkanals schwierig ist, empfiehlt es sich, wenn die Kanalverbindungen automatisch getrennt und wiederhergestellt werden, wenn es die Arbeitslast erfordert. Für die meisten Kanäle kann die Einstellung für das Intervall für Verbindungstrennung mit heuristischen Verfahren bestimmt werden.
Information Wert Standardwert 900 Sekunden Einstellmöglichkeiten 0 bis 999999 Der Wert 0 (null) bedeutet, dass die Verbindungen nicht getrennt werden. Der Kanal wartet unbegrenzt auf Nachrichten.
- -shortRetryCount
Information Wert Standardwert 10 Einstellmöglichkeiten 0 bis 999999999 - -shortRetryInterval
Weitere Informationen zur Verwendung des Wiederholungsmechanismus mit IBM MQ finden Sie im Abschnitt zur übergreifenden Kommunikation im Information Center von IBM MQ.
Information Wert Standardwert 60 Sekunden Einstellmöglichkeiten 0 bis 999999 - -longRetryCount
Weitere Informationen zur Verwendung des Wiederholungsmechanismus mit IBM MQ finden Sie im Abschnitt zur übergreifenden Kommunikation im Information Center von IBM MQ.
Information Wert Standardwert 999999999 Einstellmöglichkeiten 0 bis 999999999 - -longRetryInterval
Weitere Informationen zur Verwendung des Wiederholungsmechanismus mit IBM MQ finden Sie im Abschnitt zur übergreifenden Kommunikation im Information Center von IBM MQ.
Information Wert Standardwert 1200 Sekunden Einstellmöglichkeiten 0 bis 999999 - -senderChannelInitialState Started | Stopped
- Der Status des IBM MQ-Links, der anzeigt, ob der Senderkanal gestartet oder gestoppt wird,
wenn der zugehörige IBM MQ-Link zum ersten Mal gestartet wird.
Der Kanal ist bis zum Start des Links nicht verfügbar.
Information Wert Standardwert Gestartet Einstellmöglichkeiten - Gestoppt
- Wenn die zugeordnete Messaging-Engine gestartet wird, ist der IBM MQ-Link gestoppt und kann nicht mit dem IBM MQ-Netz kommunizieren.
- Gestartet
- Wenn die zugeordnete Messaging-Engine gestartet wird, wird der IBM MQ-Link automatisch gestartet und ist für die Kommunikation mit dem IBM MQ-Netz bereit.
- -receiverChannelName
Dieser Name muss mit dem Namen des Senderkanals in IBM MQ identisch sein.
- -inboundNonPersistentReliability Best effort | Reliable
Die Zuverlässigkeitsoption für die Zustellung wird allen nicht persistenten IBM MQ-Nachrichten zugewiesen, die über diesen Empfängerkanal übermittelt werden.
Information Wert Standardwert Zuverlässig Einstellmöglichkeiten - Bestmöglich
- Nachrichten werden verworfen, wenn eine Messaging-Engine gestoppt wird oder ein Fehler auftritt. Nachrichten können auch verworfen werden, wenn die Verbindung, in der sie übertragen wurden, nicht mehr verfügbar ist oder wenn die Systemressourcen knapp werden.
- Express
- Zuverlässig
- Nachrichten werden verworfen, wenn eine Messaging-Engine gestoppt wird oder ein Fehler auftritt.
- -inboundPersistentReliability Reliable | Assured
Information Wert Standardwert Garantiert Einstellmöglichkeiten - Zuverlässig
- Nachrichten können verworfen werden, wenn eine Messaging-Engine ausfällt.
- Garantiert
- Nachrichten werden nicht verworfen.
- -receiverChannelInitialState Started | Stopped
- Der Status des IBM MQ-Links, der anzeigt, ob der Empfängerkanal gestartet oder gestoppt wird,
wenn der zugehörige IBM MQ-Link zum ersten Mal gestartet wird.
Der Kanal ist bis zum Start des Links nicht verfügbar.
Information Wert Standardwert Gestartet Einstellmöglichkeiten - Gestoppt
- Wenn die zugeordnete Messaging-Engine gestartet wird, ist der IBM MQ-Link gestoppt und kann nicht mit dem IBM MQ-Netz kommunizieren.
- Gestartet
- Wenn die zugeordnete Messaging-Engine gestartet wird, wird der IBM MQ-Link automatisch gestartet und ist für die Kommunikation mit dem IBM MQ-Netz bereit.
- -preferLocal TRUE | FALSE
- Diese Option gibt an, dass der Link es bevorzugt, eingehende Nachrichten an den Warteschlangenpunkt des geplanten Ziels
zu senden, das sich, sofern verfügbar, in derselben Messaging-Engine
wie der Link befindet.
Eigner des Links muss eine Messaging-Engine sein, die in einem Server der
WebSphere Application Server Version 7.0 oder höher ausgeführt wird.
Diese Option wird nur unterstützt, wenn sie von einer JMS-Anwendung verwendet wird, die mit einem Server oder Client von WebSphere Application ServerVersion 7.0 oder höher ausgeführt wird und die mit einer Messaging-Engine verbunden ist, die in einem Server von WebSphere Application ServerVersion 7.0 oder höher ausgeführt wird. Die Verwendung dieser Option in früheren Versionen von WebSphere Application Server führt zu einer Ausnahme in der Anwendung.
Information Wert Standardwert TRUE Einstellmöglichkeiten - TRUE
- Jede eingehende Nachricht wird an den Warteschlangenpunkt des geplanten Ziels gesendet, das sich, sofern verfügbar, in derselben Messaging-Engine wie der Link befindet.
- FALSE
- Eingehende Nachrichten werden an einen beliebigen Warteschlangenpunkt des geplanten Ziels gesendet.
Beispiele
Eigenschaften eines IBM MQ-Links anzeigen, den Link modifizieren, um die Stapelgröße zu ändern, und anschließend die Eigenschaften des Links erneut anzeigen:
wsadmin>AdminTask.showSIBMQLink('[-bus myBus -messagingEngine myHostNode01.server1-myBus
-mqLink myMQLink]')
'{nonPersistentMessageSpeed=FAST, qmName=myBus, adoptable=false, sequenceWrap=999999999,
name=myMQLink, targetUuid=738AE126B908E5451A3D4691, initialState=STARTED,
senderChannel=null, brokerProfile=[], receiverChannel=null, preferLocalQueuePoints=true,
batchSize=50, uuid=6B89C4F08AB072C5, heartBeat=300, description=null, maxMsgSize=4194304,
exceptionDestination=_SYSTEM.Exception.Destination.myHostNode01.server1-myBus}'
wsadmin>
wsadmin>AdminTask.modifySIBMQLink('[-bus myBus -messagingEngine myHostNode01.server1-myBus
-name myMQLink -batchSize 100]')
'myMQLink(cells/cell01/nodes/node01/servers/server1|sib-engines.xml#SIBMQLink_1132608724468)'
wsadmin>AdminTask.showSIBMQLink('[-bus myBus -messagingEngine myHostNode01.server1-myBus
-mqLink myMQLink]')
'{nonPersistentMessageSpeed=FAST, qmName=myBus, adoptable=false, sequenceWrap=999999999,
name=myMQLink, targetUuid=738AE126B908E5451A3D4691, initialState=STARTED,
senderChannel=null, brokerProfile=[], receiverChannel=null, preferLocalQueuePoints=true,
batchSize=100, uuid=6B89C4F08AB072C5, heartBeat=300, description=null, maxMsgSize=4194304,
exceptionDestination=_SYSTEM.Exception.Destination.myHostNode01.server1-myBus}'
wsadmin>
Einen IBM MQ-Link so ändern, dass der Link keine Vorgabe für die zu verwendenden Warteschlangenpunkte besitzt:
wsadmin>AdminTask.modifySIBMQLink('[-bus Bus1 -messagingEngine
node1.node1server1-Bus1 -name MQLink -queueManagerName QM2 -preferLocal FALSE]')
wsadmin>