Commande createSIBForeignBus
La commande createSIBForeignBus permet de créer un bus externe 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.
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 crée un bus externe pour un bus d'intégration de services spécifié. Un bus externe représente un bus avec lequel un autre bus peut échanger des messages.
Objet cible
Bus d'intégration de services spécifié.
Paramètres requis
- -bus nombus
- Nom du bus d'intégration de services pour lequel vous souhaitez créer le bus externe. Vous pouvez utiliser la commande listSIBuses pour afficher la liste des noms des bus existants.
- -name nombus
- Nom sous lequel le bus externe doit être connu.Remarques :
- Si vous créez un bus externe, son nom doit correspondre au nom du bus d'intégration de services qu'il représente.
- Si vous comptez lier directement deux bus, vous devez leur attribuer des noms uniques.
- Une fois le bus externe configuré, vous ne devez plus en modifier le nom.
- -routingType Direct | Indirect
- Créez un bus externe en spécifiant la liaison physique (également appelée type de routage) :
- Direct
- Une liaison de bus d'intégration de services entre un moteur de messagerie du bus local et un moteur de messagerie du bus externe.
- Indirect
- Liaison indirecte qui est établie via un ou plusieurs bus externes.
Paramètres conditionnels
Aucun.
Paramètres optionnels
- -description texte
- Description facultative du bus à des fins d'administration.
- -type MQ | SIBus
- Créez un bus externe en spécifiant son type :
- MQ
- Créez un bus externe pour lier le bus d'intégration de services à un réseau IBM MQ.
- SIBus
- Créez un bus externe pour lier le bus d'intégration de services à un autre bus d'intégration de services.
- -sendAllowed True | 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 les messages entrants provenant d'un bus externe à accéder aux
destinations d'un bus d'intégration de services sécurisé. Si le bus n'est pas sécurisé, la propriété de l'ID
utilisateur entrant n'affecte pas les messages. Vous pouvez indiquer un ID d'utilisateur entrant pour les scénarios
suivants :
- Le bus externe et le bus d'intégration de services sécurisé se trouvent dans des domaines de sécurité distincts et les ID utilisateur du bus externe ne sont pas reconnus par le bus sécurisé.
- Vous voulez contrôler en local l'accès au bus sécurisé à l'aide de messages entrants.
- -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
AdminTask.createSIBForeignBus('[-bus bus1 -name foreignbus1 -routingType Direct
-type SIBus]')
'foreignbus1(cells/cell01/buses/bus1|sib-bus.xml#SIBForeignBus_1213023645293)'