Commande mediateSIBDestination
La commande mediateSIBDestination permet d'effectuer une médiation sur une destination de bus pour un bus d'intégration de services.
La création de la médiation d'une destination associe une médiation à une destination de bus sélectionnée. Lors de l'exécution, la médiation applique un certain traitement aux messages gérés par la destination de bus. Notez que vous ne pouvez associer à une destination qu'une médiation à la fois. Vous pouvez associer une même médiation à plusieurs destinations.
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
Cette commande effectue une médiation sur une destination de bus pour un bus d'intégration de services. Un certain nombre de paramètres permettent de créer un point de file d'attente de médiation sur un serveur IBM MQ et de créer le point d'exécution de la médiation correspondant sur un cluster ou un serveur.
Objet cible
Aucun.
Paramètres obligatoires.
- -bus nom_bus -destinationName nom_destination
- Destination à laquelle une médiation doit être appliquée.
- -mediationName nom_médiation
- Nom de la médiation à appliquer à la destination de bus Cette médiation doit exister pour que cette commande puisse être utilisée.
Paramètres conditionnels
- -wmqServer nom_serveur_mq -wmqQueueName nom_fileattente_mq
- [Destination de file d'attente ou de service Web] Pour affecter le point de médiation à une file d'attente IBM MQ, indiquez le nom du membre du bus du serveur IBM MQ où le point de médiation doit être affecté, et le nom de la file d'attente IBM MQ dans laquelle seront stockés les messages prêts pour la médiation. nom_serveur_mq est le nom du serveur IBM MQ indiqué dans le paramètre -name lors de la création du serveur IBM MQ. nom_fileattente_mq est le nom affecté à la file d'attente IBM MQ par l'administration IBM MQ.
- -node nom_noeud -server nom_serveur
- [Sauf espace de sujet] Pour appliquer la médiation de la destination de bus à un membre du bus de serveurs, indiquez le nom du noeud sur lequel le serveur s'exécute, ainsi que le nom du serveur.
- -cluster nom_cluster
- [Sauf espace de sujet] Pour appliquer la médiation de la destination de bus à un membre du bus de clusters, indiquez le nom du cluster.
Paramètres optionnels
- -nonPersistentReliability
Indique la qualité de service de l'intégration de services à utiliser avec les messages IBM MQ non persistants reçus par l'intégration de services et provenant d'un réseau IBM MQ. Les messages contenus dans un réseau IBM MQ ont leur propre niveau de qualité de service. Il s'agit de messages persistants ou non persistants. Lorsque ces messages sont reçus par une application d'intégration de services, celle-ci leur affecte un niveau de qualité de service d'intégration de services en fonction de leur niveau de qualité de service IBM MQ.
Pour les messages IBM MQ non persistants reçus, la qualité de service de l'intégration de services par défaut est RELIABLE_NONPERSISTENT. Si vous optez pour le remplacement de cette valeur par défaut, vous choisirez probablement l'une des autres qualités de service d'intégration de service non persistants suivantes : BEST_EFFORT_NONPERSISTENT ou EXPRESS_NONPERSISTENT. Toutefois, vous pouvez choisir entre cinq niveaux de qualité de service possibles :- BEST_EFFORT_NONPERSISTENT
- Les messages sont éliminés lorsqu'un moteur de messagerie s'arrête ou échoue. Les messages peuvent également être éliminés si une connexion utilisée pour les envoyer devient indisponible ou si les ressources systèmes sont soumises à des contraintes.
- EXPRESS_NONPERSISTENT
- Les messages sont éliminés lorsqu'un moteur de messagerie s'arrête ou échoue. Les messages peuvent également être éliminés si une connexion utilisée pour les envoyer devient non disponible.
- RELIABLE_NONPERSISTENT
- Les messages sont éliminés lorsqu'un moteur de messagerie s'arrête ou échoue.
- RELIABLE_PERSISTENT
- Les messages peuvent être éliminés lorsqu'un moteur de messagerie échoue.
- ASSURED_PERSISTENT
- Les messages ne sont pas éliminés.
Remarque : Plus haute est la fiabilité, meilleures sont les performances.Pour plus d'informations, voir Mappage de l'option de distribution JMS et de la fiabilité des message vers et depuis la valeur de persistance IBM MQ.
- -persistentReliability
Indique la qualité de service de l'intégration de services à utiliser avec les messages IBM MQ persistants reçus par l'intégration de services et provenant d'un réseau IBM MQ. Les messages contenus dans un réseau IBM MQ ont leur propre niveau de qualité de service. Il s'agit de messages persistants ou non persistants. Lorsque ces messages sont reçus par une application d'intégration de services, celle-ci leur affecte un niveau de qualité de service d'intégration de services en fonction de leur niveau de qualité de service IBM MQ.
Pour les messages IBM MQ persistants reçus, la qualité de service de l'intégration de services par défaut est ASSURED_PERSISTENT. Si vous optez pour le remplacement de cette valeur par défaut, vous choisirez probablement l'autre qualité de service d'intégration de service persistant, notamment RELIABLE_PERSISTENT. Toutefois, vous pouvez choisir entre cinq niveaux de qualité de service possibles :- BEST_EFFORT_NONPERSISTENT
- EXPRESS_NONPERSISTENT
- RELIABLE_NONPERSISTENT
- RELIABLE_PERSISTENT
- ASSURED_PERSISTENT
Pour plus d'informations, voir Mappage de l'option de distribution JMS et de la fiabilité des message vers et depuis la valeur de persistance IBM MQ.
- -useRFH2
- Détermine si les technologies d'intégration de services incluent un en-tête RFH2 dans les messages placés sur le point de médiation. Valeurs possibles :
- TRUE
- FALSE
- -maintainStrictMessageOrder
- Maintenir l'ordre strict des messages.
Valeurs possibles :
- Elément sélectionné
- Conserve l'ordre dans lequel un expéditeur envoie les messages à la destination.
Lors de l'exécution, cette propriété est prioritaire par rapport aux autres valeurs de propriétés de configuration. Pour obtenir des informations sur les propriétés de configuration ignorées lors de l'exécution, voir Maintien d'un ordre strict des messages pour les destinations de bus.
- Elément non sélectionné
- L'ordre des messages n'est pas conservé pour cette destination.
Exemple
- En langage
Jython :
wsadmin>AdminTask.mediateSIBDestination("-bus abus -destinationName myqueue -mediationName filterMed -cluster cluster1")
- Avec Jacl :
wsadmin>$AdminTask mediateSIBDestination {-bus abus -destinationName myqueue -mediationName filterMed -cluster cluster1}