Commande modifySIBForeignBus
La commande modifySIBForeignBus permet de modifier les propriétés d'un bus externe.
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.
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
Cette commande modifie les propriétés d'un bus externe. Un bus externe représente un bus, situé dans une autre cellule (ou dans la même cellule) ou dans un réseau IBM MQ, avec lequel un bus d'intégration de services peut échanger des messages.
Objet cible
Un bus externe.
Paramètres requis
- -bus nombus
- Nom du bus d'intégration de services pour lequel vous souhaitez modifier un bus externe. Vous pouvez utiliser la commande listSIBuses pour afficher la liste des noms des bus existants.
- -name nombus
- Nom du bus externe que vous souhaitez modifier. Vous pouvez utiliser la commande listSIBForeignBuses pour afficher la liste des noms des bus existants.
Paramètres conditionnels
Aucun.
Paramètres optionnels
- -description texte
- Description facultative du bus à des fins d'administration.
- -sendAllowed False | False
- (True par défaut) Les expéditeurs peuvent envoyer des messages au bus externe.
- False
- Les expéditeurs ne peuvent pas envoyer de messages au bus externe.
- True
- Les expéditeurs peuvent envoyer des messages au bus externe.
- -inboundUserid IDutilisateur
- L'ID utilisateur entrant permet d'autoriser un message
provenant du bus externe à accéder aux destinations du bus d'intégration de services.
Si ce bus n'est pas
sécurisé, cette propriété n'affecte pas les messages.
Il est conseillé de spécifier un ID utilisateur entrant :
- si le bus externe se trouve dans un domaine de sécurité différent de celui de ce bus et que les ID utilisateur du bus externe ne sont pas reconnus dans ce bus,
- pour contrôler en local l'accès des messages entrants à ce bus.
- -outboundUserid IDutilisateur
- L'ID utilisateur sortant remplace l'ID utilisateur qui identifie la source d'un message dans tous les messages envoyés au bus externe. Cet ID utilisateur est également utilisé par le bus externe pour autoriser le message à accéder à sa destination si les deux bus sont sécurisés et si le bus externe n'a pas remplacé l'ID utilisateur par son propre ID utilisateur entrant.
- -nextHopBus nom_bus
- (Si -routingType est Indirect) Nom du prochain bus d'intégration de services dans la séquence de bus connectés. Un bus intermédiaire peut être un système IBM MQ au lieu d'un bus d'intégration de services.
- -topicSpaceMappings nom_espacesujets local : nom_espacesujets distant
- Un mappage d'espaces de sujets permet aux abonnés de l'espace de sujets local de recevoir des messages publiés dans l'espace de sujets externe. Pour que les publications puissent passer de l'espace de sujets local au bus externe, un mappage d'espaces de sujets équivalent est requis par le bus externe. Les noms des espaces de sujets du bus local sont mappés vers ceux définis sur le bus externe. Généralement ces noms correspondent. Notez que le mappage de deux espaces de sujets implique que les sujets de ces espaces soient identiques. Vous pouvez spécifier plusieurs paires d'espaces de sujet.
Exemple
L'exemple ci-après spécifie des propriétés facultatives pour un bus externe existant nommé foreignbus1 :- Une identité d'utilisateur entrant appelée iuserid pour autoriser les messages envoyés au bus local depuis foreignbus1, lorsque la sécurité est activée sur foreignbus1 et sur le bus local.
- Une identité d'utilisateur sortant appelée ouserid pour autoriser les messages envoyés à foreignbus1 depuis le bus local, lorsque la sécurité est activée sur foreignbus1 et sur le bus local.
- Un mappage d'espaces de sujets entre Topic.Space1 sur le bus local et Topic.Space2 sur foreignbus1. Le mappage permet aux abonnés à Topic.Space1 (bus local) de recevoir les messages publiés dans Topic.Space2 (foreignbus1).
AdminTask.modifySIBForeignBus('[-bus bus1 -name foreignbus1 -inboundUserid iuserid
-outboundUserid ouserid -topicSpaceMappings [[Topic.Space1 Topic.Space2]]]')
'foreignbus1(cells/cell01/buses/bus1|sib-bus.xml#SIBForeignBus_1213023645293)'