Befehl "modifySIBDestination"

Verwenden Sie den Befehl modifySIBDestination, um die Eigenschaften eines Busziels für einen Service Integration Bus 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 modifySIBDestination ändert die Eigenschaften eines Busziels für einen Service Integration Bus.

Zielobjekt

Ein Busziel.

Erforderliche Parameter

-bus
Der Name des Service Integration Bus, in dem das Busziel konfiguriert ist. Mit dem Befehl listSIBuses können Sie die Namen vorhandener Busse auflisten.
-name
Die ID, unter der dieses Ziel für Verwaltungszwecke geführt wird.

Vorgegebene Parameter

Ohne.

Optionale Parameter

-description
Geben Sie eine Beschreibung des Busziels für Verwaltungszwecke an.
-reliability
Geben Sie die Standardzuverlässigkeitsstufe an, die einer für dieses Ziel erzeugten Nachricht zugeordnet werden soll, wenn keine explizite Zuverlässigkeit von der Erzeugeranwendung definiert wurde. Die Serviceintegration unterstützt fünf Zuverlässigkeitsstufen (die auch als Zustelloptionen oder Servicequalitäten bezeichnet werden):
BEST_EFFORT_NONPERSISTENT
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_NONPERSISTENT
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.
RELIABLE_NONPERSISTENT
Nachrichten werden verworfen, wenn eine Messaging-Engine gestoppt wird oder ein Fehler auftritt.
RELIABLE_PERSISTENT
Nachrichten können verworfen werden, wenn eine Messaging-Engine ausfällt.
ASSURED_PERSISTENT
Nachrichten werden nicht verworfen.
Anmerkung: Eine höhere Zuverlässigkeitsstufe hat einen höheren Einfluss auf die Leistung.

Weitere Informationen zu den Zuverlässigkeitsstufen der Serviceintegration finden Sie im Artikel Nachrichtenzuverlässigkeitsstufen - JMS-Zustellmodus und Servicequalität der Serviceintegration.

-overrideOfQOSByProducerAllowed TRUE | FALSE
Steuert die Servicequalität für Nachrichtenfolgen zwischen Erzeugern und dem Ziel. Wählen Sie diese Option aus, um die von Erzeugern angegebene Servicequalität anstelle der für das Ziel definierten Qualität zu verwenden.
-defaultPriority Zahl
-maxFailedDeliveries Zahl
Geben Sie einen Wert zwischen 0 und 2147483647 an. Wenn Sie den Wert 0 (null) verwenden, wird eine Nachricht, die nicht beim ersten Versuch zugestellt werden kann, gemäß der mit dem Parameter -exceptionDestination festgelegten Einstellung entweder an das Ausnahmeziel weitergeleitet oder verworfen.
-exceptionDestination Wert
Standardmäßig werden alle Nachrichten, die diesem Ziel nicht zugestellt werden können, an das Standardausnahmeziel des Systems für die Messaging-Engine umgeleitet, der dieses Ziel zugeordnet ist (_SYSTEM.Exception.Destination.Name_der_Messaging-Engine). Verwenden Sie diesen Parameter, um den Standardwert zu überschreiben. Sie können ein bestimmtes Ausnahmeziel für dieses Ziel angeben, oder Sie können festlegen, dass nicht zustellbare Nachrichten nicht an ein Ausnahmeziel umgeleitet werden, indem Sie eine leere Zeichenfolge ("") angeben, die bewirkt, dass die Einstellung für die maximale Anzahl fehlgeschlagener Zustellungen nicht angewendet wird.
Anmerkung: Eine nicht zustellbare Nachricht kann die Verarbeitung anderer Nachrichten, die auf Zustellung an dasselbe Ziel warten, blockieren.
Sie können diese Option verwenden und angeben, dass kein Ausnahmeziel für die Einhaltung der Nachrichtenreihenfolge verwendet wird.
-sendAllowed TRUE | FALSE
Wählen Sie diese Option ab (indem Sie sie auf FALSE setzen), um zu verhindern, dass Erzeuger Nachrichten an dieses Ziel senden.
  • Die neuen Nachrichten (von verbundenen Erzeugern oder von einem anderen Ziel weitergeleitet) für einen Warteschlangenpunkt eines nicht vermittelten Ziels oder einen Mediationspunkt eines vermittelten Ziels werden an die verfügbaren Nachrichtenpunkte weitergeleitet. Wenn keine Nachrichtenpunkte verfügbar sind, werden Nachrichten, die bereits im Bus angenommen wurden, und neue Nachrichten von verbundenen Erzeugern vom Bus so lange aufgewahrt, bis wieder ein Nachrichtenpunkt verfügbar ist. Ausgenommen hiervon sind Ziele mit nur einem Nachrichtenpunkt (Warteschlangenpunkt bzw. Mediationspunkt, je nachdem, ob das Ziel vermittelt oder nicht vermittelt ist), bei denen der Erzeuger mit derselben Messaging-Engine verbunden ist. In diesem Fall wird bei jedem Sendeaufruf eine Ausnahmenachricht generiert. Die Ausnahmenachricht zeigt an, dass die einzige vorhandene Lokalisierung für Sendevorgänge inaktiviert wurde. Der Erzeuger bleibt geöffnet, und alle weiteren Sendeaufrufe werden ordnungsgemäß durchgeführt, wenn die Eigenschaft Senden zulässig der Lokalisierung erneut ausgewählt (auf TRUE gesetzt) wird.
  • Wenn Sie diese Option für einen Warteschlangenpunkt eines vermittelten Ziels abwählen, werden Nachrichten von Mediationsinsanzen an einen verfügbaren Nachrichtenpunkt umgleitet. Sind keine Nachrichtenpunkte verfügbar, werden die Nachrichten vom Bus so lange aufbewahrt, bis wieder ein Nachrichtenpunkt verfügbar ist. Für alle Mediationsinsanzen (d. h. in allen Servern, die einen Mediationspunkt haben) gilt Folgendes: Wenn sich im selben Server ein Warteschlangenpunkt befindet und dieser Warteschlangenpunkt der einzige für das Ziel ist, wechselt die Mediation in den Status "Gestoppt wegen Fehler".
-receiveAllowed TRUE | FALSE
Wenn Sie diese Option für den Nachrichtenpunkt abwählen, können offene Konsumenten den Status ändern, und es wird eine Ausnahme generiert, wenn der Konsument eine Nachricht anfordert. Es können weiterhin Nachrichten gesendet werden und sich am Nachrichtenpunkt ansammeln.
-receiveExclusive TRUE | FALSE
Wählen Sie diese Option aus (indem Sie sie auf "true" setzen), wenn einem Ziel nur ein einziger Konsument zugeordnet werden soll. Wenn Sie diese Option auswählen, kann jedem Warteschlangenpunkt eines Warteschlangenziels immer nur ein einziger Konsument zugeordnet werden. Nachfolgende Konsumenten, die versuchen, eine Verbindung zu einem Warteschlangenpunkt herzustellen, denen bereits ein Konsument zugeordnet ist, werden zurückgewiesen.
-maintainStrictMessageOrder TRUE | FALSE
Wählen Sie diese Option aus (indem Sie sie auf TRUE setzen), um die Reihenfolge zu bewahren, in der ein Erzeuger Nachrichten an das Ziel sendet.
Zur Laufzeit hat diese Eigenschaft Vorrang vor anderen Konfigurationseigenschaftenwerten. Weitere Informationen zu den Konfigurationseigenschaften, die zur Laufzeit überschrieben werden, finden Sie im Artikel Strikte Nachrichtenreihenfolge für Busziele.
Anmerkung: Wenn die strikte Einhaltung der Nachrichtenreihenfolge für ein vorhandenes Topicziel aktiviert ist, werden alle vorhandenen permanenten Subskriptionen und die zugehörigen Nachrichten ungültig. Wenn die strikte Einhaltung der Nachrichtenreihenfolge aktiviert ist und die Umgebung erneut gestartet wird, werden die vorhandenen permanenten Subskriptionen gelöscht und erneut erstellt. Die Nachrichten, die zu den permanenten Subskriptionen gehören, werden ebenfalls gelöscht.
-topicAccessCheckRequired
Schließen Sie diese Option ein, wenn Berechtigungsprüfungen für den Zugriff auf Topics erforderlich sind.
-replyDestination
Diese Eigenschaft ist für Mediationen von Antwortnachrichten bestimmt. Nähere Informationen zur Verwendung dieser Eigenschaft finden Sie im Artikel Einen Reverse-Routing-Pfad für ein Ziel konfigurieren.
-replyDestinationBus
Der Name des Busses, in dem das Antwortziel konfiguriert ist. Diese Eigenschaft ist für Mediations von Antwortnachrichten bestimmt. Nähere Informationen zur Verwendung dieser Eigenschaft finden Sie im Artikel Einen Reverse-Routing-Pfad für ein Ziel konfigurieren.
-delegateAuthorizationCheckToTarget
Schließen Sie diese Option ein, wenn die Berechtigungsprüfung am geplanten Ziel durchgeführt werden soll.
-auditAllowed TRUE | FALSE
Wählen Sie diese Option ab (indem Sie sie auf FALSE setzen), um den Bus an der Durchführung von Berechtigungsprüfungen auf Topicebene durchzuführen, wenn im Bus und im Anwendungsserver die Prüfung aktiviert ist. Der Standardwert ist TRUE. Zur Verwendung dieses Parameters benötigen Sie die Berechtigungen eines Prüfadministrators. Der Parameter wird ignoriert, wenn er beim Erstellen anderer Zieltypen verwendet wird.
-defaultForwardRoutingPath
Der Wert, auf den der Routing-Pfad einer Nachricht gesetzt wird, wenn die Nachricht keinen Routing-Pfad enthält. Er definiert eine sortierte Liste zwischengeschalteter Busziele, die Nachrichten durchlaufen müssen, um ein endgültiges Busziel zu erreichen. Das Format des Feld ist eine Liste mit Buszielen, die mit Busname:Zielname angegeben werden.
-queuePoints
Eine Liste der Warteschlangenpunkte, die von Benutzern des Aliasziels verwendet werden. Wenn keine Warteschlangenpunkte angegeben sind, können alle Warteschlangenpunkte verwendet werden. Das geplante Ziel muss ein Warteschlangenziel in demselben Bus wie die Aliaszieldefinition sein. Außerdem muss das geplante Ziel ein Warteschlangenziel mit mehreren Warteschlangenpunkten sein.

Ein Warteschlangenpunkt wird im Format Zielname@Name_der_Messaging-Engine angegeben.

-useAllQueuePoints TRUE | FALSE
Wenn Sie diese Option auf TRUE setzen, werden alle verfügbaren Warteschlangenpunkte verwendet. Wenn Sie diese Option auf FALSE setzen, werden nur die Warteschlangenpunkte in der Liste verwendet, die mit der Option -queuePoints angegeben wurde.
-mediationPoints
Eine Liste der Mediationspunkte, die von Benutzern des Aliasziels verwendet werden. Wenn keine bestimmten Mediationspunkte angegeben sind, können alle Mediationspunkte verwendet werden. Das geplante Ziel muss ein vermitteltes Warteschlangenziel in demselben Bus wie die Aliaszieldefinition sein. Außerdem muss das geplante Ziel ein Warteschlangenziel mit mehreren Mediationspunkten sein.

Ein Mediationspunkt wird im Format Zielname@Name_der_Messaging-Engine angegeben.

-useAllMediationPoints TRUE | FALSE
Wenn Sie diese Option auf TRUE setzen, werden alle verfügbaren Warteschlangenpunkte verwendet. Wenn Sie diese Option auf FALSE setzen, werden nur die Warteschlangenpunkte in der Liste verwendet, die mit der Option -mediationPoints angegeben wurde.
-persistRedeliveryCount TRUE | FALSE
Wählen Sie diese Option aus (indem Sie sie auf TRUE setzen), um die Anzahl der fehlgeschlagenen Zustellungen von JMS-Nachrichten im Nachrichtenspeicher persistent zu speichern. Der Standardwert für die Option ist FALSE.
Wichtig: Trotz Auswahl der Eigenschaft ist die Eigenschaft erst wirksam, nachdem ein Upgrade der Datenbanktabellen mit dem Befehl sibDBUpgrade für WebSphere Application Server Version 9.0 und höher durchgeführt wurde.

Beispiel

  • Mit Jython:
    wsadmin>AdminTask.showSIBDestination(["-bus", "abus", "-name", "myqueue"])
    "{receiveExclusive=false, defaultForwardRoutingPath=[], defaultPriority=0,
    exceptionDestination=_SYSTEM.Exception.Destination.node01.aserver-abus, 
    uuid=97CC75AC71E5932CAB3417AC, overrideOfQOSByProducerAllowed=true, 
    sendAllowed=true, maxFailedDeliveries=5,
    maxReliability=ASSURED_PERSISTENT, reliability=ASSURED_PERSISTENT, 
    receiveAllowed=true, identifier=myqueue}"
    
    wsadmin>AdminTask.modifySIBDestination(["-bus", "abus", "-name", "myqueue",
     "-receiveAllowed", "FALSE"])
    
    wsadmin>AdminTask.showSIBDestination(["-bus", "abus", "-name", "myqueue"])
    "{receiveExclusive=false, defaultForwardRoutingPath=[], defaultPriority=0,
    exceptionDestination=_SYSTEM.Exception.Destination.node01.aserver-abus, 
    uuid=97CC75AC71E5932CAB3417AC, overrideOfQOSByProducerAllowed=true, 
    sendAllowed=true, maxFailedDeliveries=5,
    maxReliability=ASSURED_PERSISTENT, reliability=ASSURED_PERSISTENT, 
    receiveAllowed=false, identifier=myqueue}"
  • Mit Jacl:
    wsadmin>$AdminTask showSIBDestination {-bus abus -name myqueue}
    {receiveExclusive=false, defaultForwardRoutingPath=[], defaultPriority=0,
    exceptionDestination=_SYSTEM.Exception.Destination.node01.aserver-abus, 
    uuid=97CC75AC71E5932CAB3417AC, overrideOfQOSByProducerAllowed=true, 
    sendAllowed=true, maxFailedDeliveries=5,
    maxReliability=ASSURED_PERSISTENT, reliability=ASSURED_PERSISTENT, 
    receiveAllowed=true, identifier=myqueue}
    
    wsadmin>$AdminTask modifySIBDestination {-bus abus -name myqueue
    -receiveAllowed FALSE}
    (cells/9994GKCCell01/buses/abus|sib-destinations.xml#SIBQueue_1098215169998)
    
    wsadmin>$AdminTask showSIBDestination {-bus abus -name myqueue}
    {receiveExclusive=false, defaultForwardRoutingPath=[], defaultPriority=0,
    exceptionDestination=_SYSTEM.Exception.Destination.node01.aserver-abus, 
    uuid=97CC75AC71E5932CAB3417AC, overrideOfQOSByProducerAllowed=true, 
    sendAllowed=true, maxFailedDeliveries=5,
    maxReliability=ASSURED_PERSISTENT, reliability=ASSURED_PERSISTENT, 
    receiveAllowed=false, identifier=myqueue}

Beispiel: Ein Ziel mit dem Namen "MyAlias2" so ändern, dass ein Teil der verfügbaren Warteschlangenpunkte und Mediationspunkte verwendet wird:

  • Mit Jython:
    cluster=AdminConfig.list("ServerCluster").splitlines()[0]
    Qp1=AdminConfig.list("SIBQueueLocalizationPoint" , cluster).splitlines()[0]
    Mp1=AdminConfig.list("SIBMediationLocalizationPoint").splitlines()[0]
    AdminTask.modifySIBDestination(["-bus" , "bus1" , "-name" , "MyAlias2",
     "-queuePoints", [[Qp1]], "-mediationPoints" , [[Mp1]]])
  • Mit Jacl:
    set cluster [ lindex [ $AdminConfig list ServerCluster ] 1 ]
    set Qp1 [ lindex [ $AdminConfig list SIBQueueLocalizationPoint $cluster ] 0 ]
    set Mp1 [ lindex [ $AdminConfig list SIBMediationLocalizationPoint ] 0 ]
    $AdminTask modifySIBDestination {-bus bus1 -name MyAlias2 
     -queuePoints [[$Qp1]]-mediationPoints [[$Mp1]]}

Beispiel: Einen Zielalias so ändern, dass keine Einschränkungen mehr in Bezug auf die verwendeten Warteschlangenpunkte bestehen:

  • Mit Jython:
    AdminTask.modifySIBDestination(["-bus" , "bus1" , "-name" , "MyAlias2",
     "-queuePoints", [[]]])
  • Mit Jacl:
    $AdminTask modifySIBDestination {-bus bus1 -name MyAlias2 
    -useAllQueuePoints=true -useAllMediationPoints=true}

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