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.

[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

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

IBM MQ-Link-Konfigurationsparameter:
-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.
Parameter des IBM MQ-Link-Senderkanals:
-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.
Parameter des IBM MQ-Link-Empfängerkanals:
-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>

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=rjj_mqlink_modify
Dateiname:rjj_mqlink_modify.html