Commande createSIBLink
La commande createSIBLink permet de créer une liaison de bus d'intégration de services.
Pour exécuter la commande, utilisez l'objet AdminTask du client de scriptage wsadmin.
Le client de scriptage wsadmin est exécuté à partir de Qshell.
Pour plus d'informations, voir Configuration de Qshell pour exécuter des scripts WebSphere à l'aide de l'outil de scriptage wsadmin.
- 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')
AdminConfig.save()
Rôle
La commande createSIBLink permet de créer une liaison de bus pour un bus spécifié. Une liaison de bus définit une liaison entre le moteur de messagerie d'un bus et le moteur de messagerie d'un bus externe.
Objet cible
Aucun.
Paramètres requis
- -bus
- Nom du bus d'intégration de services pour lequel vous souhaitez créer 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 créer 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.
- -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
Paramètres conditionnels
Aucun.
Paramètres optionnels
- -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 de bus 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 que 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
AdminTask.createSIBLink('[-bus bus1 -messagingEngine node01.server1-myBus
-name mySIBLink -foreignBusName bus2 -bootstrapEndpoints host1:1111:chain1
-remoteMessagingEngineName node02.server2-bus2]')
Créez un bus d'intégration de services qui utilise un point de file d'attente sur le même moteur de messagerie que la liaison, dans la mesure du possible.
AdminTask.createSIBLink('[-bus bus1 -messagingEngine node01.server1-bus1
-name mySIBLink -foreignBusName bus2 -bootstrapEndpoints host1:1111:chain1
-remoteMessagingEngineName node02.server2-bus2 -preferLocal TRUE]')