Commande modifySIBLink

La commande modifySIBLink permet de modifier les propriétés d'une liaison de bus d'intégration de services.

Pour exécuter la commande, utilisez l'objet AdminTask du client de scriptage wsadmin.

[IBM i][IBM i]Le client de scriptage wsadmin est exécuté à partir de Qshell. [IBM i]Pour plus d'informations, voir Configuration de Qshell pour exécuter des scripts WebSphere à l'aide de l'outil de scriptage wsadmin.

L'aide de la ligne de commande est fournie pour les commandes de bus d'intégration de services :
  • Pour obtenir une liste des commandes de bus d'intégration de services disponibles dans Jython et une brève description de chacune d'elles, entrez la commande suivante à l'invite wsadmin :

    print AdminTask.help('SIBAdminCommands')

  • Pour obtenir une aide générale sur une commande donnée, entrez la commande suivante à l'invite wsadmin :

    print AdminTask.help('nom_commande')

Après avoir utilisé ces commandes, sauvegardez les modifications apportées à la configuration maîtresse en exécutant la commande suivante :

AdminConfig.save()

Rôle

La commande modifySIBLink permet de modifier les propriétés d'une liaison de bus d'intégration de services.

Objet cible

Aucun.

Paramètres requis

-bus
Nom du bus d'intégration de services pour lequel vous souhaitez modifier la liaison de bus d'intégration de services. Vous pouvez utiliser la commande listSIBuses pour afficher la liste des noms des bus existants.
-messagingEngine
Nom du moteur de messagerie pour lequel vous souhaitez modifier la liaison de bus d'intégration de services. La liaison de bus d'intégration de services connecte deux moteurs de messagerie de bus d'intégration de services différents, créant ainsi un pont entre deux bus d'intégration de services.
-name
Nom sous lequel vous souhaitez que la liaison de bus d'intégration de services soit connue.
-foreignBusName
Nom du bus externe qui définit le bus d'intégration de services distant pour la liaison de bus d'intégration de services. Vous pouvez utiliser la commande listSIBForeignBuses pour afficher la liste des noms des bus externes existants.

Paramètres conditionnels

Aucun.

Paramètres optionnels

-bootstrapEndpoints
Cette propriété est définie de la même manière que la propriété du noeud final du fournisseur dans les paramètres de fabriques de connexions JMS. Pour plus d'informations, voir les étapes relatives à la configuration de points finaux d'amorce dans Configuration d'une connexion à un serveur d'amorçage autre que celui par défaut.

Le port du noeud final d'amorçage correspond au port défini dans l'adresse du noeud final SIB configurée sur le serveur d'applications cible du bus externe.

-remoteMessagingEngineName
-description
Description facultative du bus à des fins d'administration.
-protocolName

Le nom de la chaîne de transport doit correspondre au nom de la chaîne de transport définie sur le serveur sur lequel le moteur de messagerie cible est hébergé.

-authAlias

Vous devez avoir prédéfini un alias d'authentification J2C.

-exceptionDestination
Destination d'un message entrant lorsque la liaison du bus d'intégration de services ne peut pas remettre le message à sa destination cible ou à la destination d'exception configurée pour la destination cible ou lorsque la destination cible n'existe pas.
Système
La liaison du bus d'intégration de services utilise la destination d'exception par défaut. Les messages qui ne peuvent pas être remis à la destination de bus sont reroutés automatiquement vers la destination d'exception par défaut du système du moteur de messagerie auquel la liaison est affectée : _SYSTEM.Exception.Destination.messaging_engine_name.
Aucun
La liaison du bus d'intégration de services n'a pas de destination d'exception. Les messages qui ne peuvent pas être distribués ne sont pas reroutés vers une destination d'exception et peuvent bloquer le traitement des autres messages attendant d'être remis dans la même destination. Cette option peut être utilisée pour préserver l'ordre des messages.
Spécifier
La liaison du bus d'intégration de services utilise la destination d'exception par défaut définie ici. Si cette opération est impossible, elle utilise la destion d'exception du système.
-initialState Started | Stopped
Etat de la liaison de la passerelle, qui indique si le lien est démarré automatiquement au démarrage du moteur de messagerie.
Information Valeur
Valeut par défaut Démarré
Intervalle
Arrêté
Lorsque le moteur de messagerie associé est démarré, le lien de la passerelle est à l'état Arrêté et ne peut pas traiter de nouvelles demandes de connexion.
Démarré
Lorsque le moteur de messagerie associé est démarré, le lien de la passerelle est à l'état Démarré et peut traiter de nouvelles demandes de connexion.
-preferLocal TRUE | FALSE
Indique si la liaison préfère envoyer des messages entrants au point de file d'attente de la destination cible située sur le même moteur de messagerie qu'elle, le cas échéant. La liaison doit être détenue par un moteur de messagerie s'exécutant sur WebSphere Application Server Version 7.0 ou ultérieure.

Cette option est prise en charge uniquement si elle est utilisée par une application JMS qui est exécutée avec un serveur ou un client WebSphere Application ServerVersion 7.0 ou ultérieures et connectée à un moteur de messagerie exécuté sur un serveur WebSphere Application ServerVersion 7.0 ou ultérieures. L'utilisation sur des versions antérieures de WebSphere Application Server entraîne une exception de l'application.

Information Valeur
Valeut par défaut TRUE
Intervalle
TRUE
Envoie chaque message entrant au point de file d'attente de la destination cible située sur le même moteur de messagerie que la liaison, le cas échéant.
FALSE
Envoie les messages entrants à tous les points de file d'attente des destinations cible.

Exemples

wsadmin>AdminTask.showSIBLink('[-bus bus1 -messagingEngine node01.server1-bus1  -sibLink
mySIBLink]') 
'{bootstrapEndpoints=host1:1111:chain1, protocolName=null, authAlias=null, 
preferLocalQueuePoints=true, name=mySIBLink, uuid=34647E59163B253D,  
remoteMessagingEngineName=node02.server2-bus2, description=null,  
targetUuid=BAD49BA75CD36D740E366978, initialState=STARTED,
exceptionDestination=$DEFAULT_EXCEPTION_DESTINATION}'

wsadmin>AdminTask.modifySIBLink('[-bus bus1 -messagingEngine node01.server1-bus1 
-name MySIBLink -foreignBusName -bus2 
-bootstrapEndpoints anotherhost:2222:BootstrapBasicMessaging]')

wsadmin>AdminTask.showSIBLink('[-bus bus1 -messagingEngine node01.server1-bus1  -sibLink
mySIBLink]') 
'{bootstrapEndpoints=anotherhost:2222:BootstrapBasicMessaging, protocolName=null, 
authAlias=null, preferLocalQueuePoints=true, name=mySIBLink, uuid=34647E59163B253D,  
remoteMessagingEngineName=node02.server2-bus2, description=null, 
targetUuid=BAD49BA75CD36D740E366978, initialState=STARTED, 
exceptionDestination=$DEFAULT_EXCEPTION_DESTINATION}'

Modification d'une liaison de bus d'intégration de services de sorte qu'aucune préférence n'indique les points de file d'attente à utiliser.

AdminTask.modifySIBLink('[-bus bus1 -messagingEngine cluster1.000-bus1 -name MyLink 
-foreignBusName -FB1 bootstrapEndpoints host1:1111:chain1 -remoteMessagingEngineName 
-cluster2.000-FB1 -preferLocal FALSE]')

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjj_siblink_modify
Nom du fichier : rjj_siblink_modify.html