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.

[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

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
La valeur par défaut est TRUE.
-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}

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=rjo_cli_dest_mediate
Nom du fichier : rjo_cli_dest_mediate.html