Commande createSIBDestination
La commande createSIBDestination permet de créer une destination de bus pour un 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 createSIBDestination permet de créer une destination de bus pour un bus d'intégration de services. Elle permet également de localiser une destination de messagerie sur un membre du bus du serveur WebSphere MQ.
Objet cible
Un bus d'intégration de services.
Paramètres requis
- -bus
- Nom du bus d'intégration de services sur lequel la destination du bus doit être créée. La commande listSIBuses permet d'afficher la liste des noms des bus existants.
- -name
- Identificateur sous lequel cette destination est connue à des fins d'administration.
- -type
- Indique le type de la destination de bus à créer :
- Alias
- Destination d'alias fournissant un niveau d'abstraction entre les applications et les destinations de bus cible sous-jacentes qui contiennent les messages. Les applications interagissent avec la destination d'alias de sorte que la destination de bus cible puisse être modifiée sans que l'application ne le soit.
- Destination externe
- Destination identifiant une destination sur un autre bus et permettant aux applications d'un bus d'accéder directement à la destination d'un autre bus.
- Port
- Représente un message particulier et une liaison de transport pour un service sortant qui communique avec un service Web ciblé hébergé en externe.
- File d'attente
- File d'attente pour la messagerie point-à-point.
- espaceSujet
- Espace de sujet pour la messagerie de publication/d'abonnement.
- WebService
- Représente un service Web cible hébergé en externe.
Paramètres conditionnels
Aucun.
Paramètres optionnels
- -cluster
- Pour affecter la destination de bus à un membre du bus de clusters, indiquez le nom du cluster. N'indiquez pas les paramètres -node, -server ou -wmqServer.
- -node
- Pour affecter 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. N'indiquez pas les paramètres -cluster ou -wmqServer.
- -server
- Pour affecter 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. N'indiquez pas les paramètres -cluster ou -wmqServer.
- -wmqServer
- Pour affecter la destination de bus à une file d'attente IBM MQ, indiquez le nom du membre du bus du serveur WebSphere MQ auquel la destination est affectée (ce paramètre), et le nom de la file d'attente IBM MQ utilisée pour stocker les messages envoyés à la destination (le paramètre -wmqQueueName). Définissez le paramètre -wmqServer sur le nom que vous avez sélectionné lors de la création du serveur WebSphere MQ. Définissez le paramètre -wmqQueueName sur le nom affecté à la file d'attente IBM MQ par l'administration IBM MQ. N'indiquez pas les paramètres -cluster, -node ou -server .
- -aliasBus
- Si vous créez une destination d'alias, indiquez le nom du bus source du mappage d'alias.
- -targetBus
- Si vous créez une destination d'alias, indiquez le nom du bus vers lequel la destination d'alias est mappée.
- -targetName
- Si vous créez une destination d'alias, indiquez le nom de la destination vers laquelle la destination d'alias est mappée.
- -foreignBus
- Si vous créez une destination externe, indiquez le nom du bus externe.
- -description
- Indique une description de la destination de bus à des fins administratives.
- -reliability
- Indique le niveau de fiabilité par défaut à affecter à un message généré sur cette destination lorsqu'aucune fiabilité explicite n'a été définie par l'application émettrice. L'intégration de service prend en charge cinq
niveaux de fiabilité (également appelés options de distribution de
qualités de service) :
- 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 sur les niveaux de fiabilité de l'intégration de services, voir Niveaux de fiabilité des messages - Mode de livraison JMS et qualité de service de l'intégration de services.
- -maxReliability
- Indique le niveau de fiabilité maximal accepté pour les valeurs spécifiées par les applications émettrices. L'intégration de service prend en charge cinq
niveaux de fiabilité (également appelés options de distribution de
qualités de service) :
- BEST_EFFORT_NONPERSISTENT
- EXPRESS_NONPERSISTENT
- RELIABLE_NONPERSISTENT
- RELIABLE_PERSISTENT
- ASSURED_PERSISTENT
Pour plus d'informations sur les niveaux de fiabilité de l'intégration de services, voir Niveaux de fiabilité des messages - Mode de livraison JMS et qualité de service de l'intégration de services.
- -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
- 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.
- -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.
- -overrideOfQOSByProducerAllowed TRUE | FALSE
- Contrôle la qualité de service des flux de messages entre les émetteurs et les destinations. Sélectionnez cette option pour utiliser la qualité de service spécifiée par les émetteurs au lieu de celle définie pour la destination.
- -defaultPriority nombre
- -maxFailedDeliveries nombre
- Définissez une valeur comprise entre 0 et 2147483647. La valeur 0 (zero) (zéro) signifie que si un message ne peut pas être distribué lors de la première tentative, il est transmis à la destination des exceptions ou éliminé, en fonction de la valeur du paramètre -exceptionDestination.
- -exceptionDestination value
- Par défaut, tous les messages qui ne peuvent pas être livrés à cette destination sont redirigés vers la
destination d'exception par défaut du système du moteur de messagerie auquel cette destination est affectée
(_SYSTEM.Exception.Destination.nom_moteur_messagerie). Utilisez ce paramètre pour remplacer la valeur par défaut. Vous pouvez associer une destination d'exception spécifique à cette destination ou bien entrer
une chaîne vide ("") pour indiquer que les messages non livrables ne doivent pas être redirigés, auquel cas
le paramètre "Nombre maximum de distributions n'ayant pas abouti" est sans effet. Remarque : Un message non distribué peut bloquer le traitement des autres messages en attente de distribution à la même destination.
- Vous pouvez utiliser cette option et ne spécifier aucune destination d'exception pour préserver l'ordre des messages.
- -sendAllowed TRUE | FALSE
- Désélectionnez cette option (valeur FALSE) afin d'éviter que les expéditeurs de message puissent envoyer des messages à cette destination.
- Pour un point de file d'attente d'une destination n'ayant pas fait l'objet d'une médiation ou un point de médiation d'une destination ayant fait l'objet d'une médiation, si vous désélectionnez cette option, les nouveaux messages (des expéditeurs connectés ou transmis depuis une autre destination) sont réacheminés vers un point de message disponible. Si aucun point de message n'est disponible, les messages déjà acceptés sur le bus et les nouveaux messages provenant d'expéditeurs sont conservés jusqu'à ce qu'un point de message devienne disponible. Seule exception : une destination ne comportant qu'un seul point de message (point de file d'attente ou point de médiation, selon que la destination fait l'objet ou non d'une médiation), où l'expéditeur est associé au même moteur de messagerie. Dans ce cas, un message d'exception est généré sur chaque appel d'envoi. Le message d'exception indique que le seul emplacement conservé a été désactivé pour les envois. L'expéditeur reste ouvert comme d'habitude et les appels d'envoi ultérieurs aboutissent si la propriété Envoi autorisé du point de message est resélectionnée (associée à nouveau à la valeur TRUE).
- Pour un point de file d'attente d'une destination ayant fait l'objet d'une médiation, si vous désélectionnez cette option, les messages provenant des instances de médiation sont réacheminés vers un point de message disponible. Si aucun point de message n'est disponible, les messages sont conservés par le bus jusqu'à ce qu'un point de message devienne disponible. Pour toute instance de médiation (sur un serveur possédant un point de médiation), si le serveur héberge un point de file d'attente et que ce dernier est le seul pour la destination, la médiation passe à l'état "arrêtée suite à une erreur".
- -receiveAllowed TRUE | FALSE
- Pour le point de message, si vous désélectionnez cette option, l'état des destinataires ouverts change et une exception est générée si le consommateur demande un message. Les messages continuent d'être envoyés et s'accumulent sur le point de messages.
- -receiveExclusive TRUE | FALSE
- Sélectionnez cette option (en lui affectant la valeur TRUE) pour permettre à un seul destinataire de se connecter à une destination. Si vous sélectionnez cette option, un seul client peut être connecté à chaque point de file d'attente d'une destination de file d'attente à tout moment. Les clients suivants qui tentent de se connecter à un point de file d'attente auquel un client est déjà connecté sont rejetés.
- -maintainStrictMessageOrder TRUE | FALSE
- Sélectionnez cette option (en lui affectant la valeur TRUE) pour conserver l'ordre dans lequel un expéditeur envoie des 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.
- -topicAccessCheckRequired
- Incluez cette option si les vérifications d'autorisation sont requises pour l'accès aux sujets.
- -replyDestination
- Cette propriété est destinée à être utilisée avec les médiations des messages de réponse. Pour plus d'informations sur l'utilisation de cette propriété, voir Configuration du chemin de routage inverse d'une destination.
- -replyDestinationBus
- Nom du bus sur lequel la destination des réponses est configurée. Cette propriété est destinée à être utilisée avec les médiations des messages de réponse. Pour plus d'informations sur l'utilisation de cette propriété, voir Configuration du chemin de routage inverse d'une destination.
- -delegateAuthorizationCheckToTarget
- Incluez cette option si vous souhaitez que le contrôle d'autorisation soit effectué sur la destination cible.
- -wmqQueueName
- Pour affecter la destination de bus à une file d'attente IBM MQ, indiquez le nom du membre du bus du serveur WebSphere MQ auquel la destination est affectée (le paramètre -wmqServer), et le nom de la file d'attente IBM MQ utilisée pour stocker les messages envoyés à la destination (ce paramètre). Définissez le paramètre -wmqServer sur le nom que vous avez sélectionné lors de la création du serveur WebSphere MQ. Définissez le paramètre -wmqQueueName sur le nom affecté à la file d'attente IBM MQ par l'administration IBM MQ. N'indiquez pas les paramètres -cluster, -node ou -server .
- -useRFH2 ou -mqRfh2Allowed TRUE | FALSE
- Détermine si les messages envoyés à la destination comportent un en-tête MQRFH2.
- Lorsque l'intégration de services convertit un message du format de l'intégration de services au format de IBM MQ, elle insère par défaut un en-tête MQRHF2 dans le message IBM MQ. Cet en-tête contient les attributs de messages, notamment les attributs JMS, qui ne sont pas des attributs de messages IBM MQ et ne figurent donc pas dans le descripteur de message de IBM MQ (MQMD). Certaines applications IBM MQ ne peuvent pas traiter les messages contenant un en-tête MQRFH2. Si les messages envoyés à cette destination vont être traités par des applications IBM MQ qui n'acceptent pas les en-têtes MQRFH2, désélectionnez cette option (indiquez la valeur FALSE).
- Si vous affectez une destination de type file d'attente à un membre du bus du serveur WebSphere MQ, utilisez le paramètre -useRFH2. Si vous créez une destination d'alias ou une destination externe, utilisez le paramètre -mqRfh2Allowed.
- -auditAllowed TRUE | FALSE
- Désélectionnez cette option (affectez-lui la valeur FALSE) afin d'éviter que le bus effectue un audit des contrôles d'autorisation au niveau du sujet lorsque l'option d'audit du bus et du serveur d'applications est activée. La valeur par défaut est TRUE. Vous devez détenir les droits d'administrateur d'audit pour utiliser ce paramètre. Le paramètre est ignoré s'il est utilisé dans la création d'autres type de destination.
- -defaultForwardRoutingPath
- Valeur à laquelle le chemin de routage de transmission d'un message est définie si le message ne contient aucun chemin de routage de transmission. Cette valeur identifie une liste séquentielle de destinations de bus intermédiaires par lesquelles doivent passer les messages pour atteindre une destination de bus cible. Le format de la zone correspond à une liste de destinations de bus sous la forme nom_bus : nom_destination.
- -queuePoints
- Liste des points de file d'attente utilisés par les utilisateurs de la destination
d'alias.
Si aucun point de file d'attente spécifique n'est fourni, tous les points de file d'attente peuvent être utilisés. La destination cible doit être une destination de file d'attente située dans le même bus que la définition de destination d'alias. La destination cible doit également être une destination de file d'attente comportant plusieurs points de file d'attente.
Un point de file d'attente est spécifié sous la forme : nom_destination@nom_moteur_messagerie
- -mediationPoints
- Liste des points de médiation utilisés par les utilisateurs de la destination
d'alias.
Si aucun point de médiation spécifique n'est fourni, tous les points de médiation peuvent être utilisés. La destination cible doit être une destination de file d'attente bénéficiant d'une médiation située dans
le même bus que la définition de destination d'alias. La destination cible doit également être une destination de file
d'attente comportant plusieurs points de médiation.
Un point de médiation est spécifié sous la forme : nom_destination@nom_moteur_messagerie
- -persistRedeliveryCount TRUE | FALSE
- Sélectionnez cette option (en lui affectant la valeur TRUE) pour conserver le nombre de distributions ayant échoué pour les messages JMS dans l'emplacement de stockage des messages. La valeur de l'option est paramétrée par défaut sur FALSE.Important : Bien que la propriété soit sélectionnée, elle ne sera pas effective tant que les tables de base de données ne seront pas mises à niveau à l'aide de la commande sibDBUpgrade pour WebSphere Application Server Version 9.0 et versions ultérieures.
Exemple
- Avec Jython :
wsadmin>AdminTask.createSIBDestination("[-bus bus1 -name myqueue -type QUEUE -node node1 -server server1]") "(cells/9994GKCCell01/buses/bus1|sib-destinations.xml#SIBQueue_1098215169998)"
- A l'aide de Jacl :
wsadmin>$AdminTask createSIBDestination {-bus bus1 -name myqueue -type QUEUE -node node1 -server server1} (cells/9994GKCCell01/buses/bus1|sib-destinations.xml#SIBQueue_1098215169998)
Exemple : création d'un alias de destination pour "MyDestination1" appelé "MyAlias1" pouvant utiliser deux points de file d'attente :
- Avec Jython :
wsadmin>AdminTask.createSIBDestination("[-bus bus1 -type ALIAS -name MyAlias1 -aliasBus bus1 -targetName MyDestination1 -reliability INHERIT -maxReliability INHERIT -overrideOfQOSByProducerAllowed INHERIT -sendAllowed INHERIT -receiveAllowed INHERIT -queuePoints [[MyDestination1@cluster1.001-bus1] [MyDestination1@cluster1.002-bus1]]]")
- A l'aide de Jacl :
wsadmin>$AdminTask createSIBDestination {-bus bus1 -type ALIAS -name MyAlias1 -aliasBus bus1 -targetName MyDestination1 -reliability INHERIT -maxReliability INHERIT -overrideOfQOSByProducerAllowed INHERIT -sendAllowed INHERIT -receiveAllowed INHERIT -queuePoints {{"MyDestination1@cluster1.001-bus1"} {"MyDestination1@cluster1.002-bus1"}}}