Commande createSIBDestinations

La commande createSIBDestinations permet de créer des destinations de bus pour un bus d'intégration de services.

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

La commande createSIBDestinations crée plusieurs destinations de bus pour un bus d'intégration de services, possédant toutes les mêmes propriétés. Si les destinations créées sont des destinations d'alias, elles ciblent toutes la même destination. Cette commande permet également de localiser les nouvelles destinations de bus 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 les destinations de bus doit être crée. La commande listSIBuses permet d'afficher la liste des noms des bus existants.
-nameList
Liste des identificateurs par lesquels les destinations sont connues à 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 les destinations 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 les destinations 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 les destinations 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 les destinations 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 aux destinations (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 des destinations d'alias, indiquez le nom du bus source du mappage d'alias.
-targetBus
Si vous créez des destinations d'alias, indiquez le nom du bus vers lequel les destinations d'alias sont mappées.
-targetName
Si vous créez des destinations d'alias, spécifiez le nom de la destination vers laquelle les destinations d'alias sont mappées.
-foreignBus
Si vous créez des destinations externes, indiquez le nom du bus externe.
-description
Indique une description des destinations de bus à des fins administratives.
-reliability
Indique le niveau de fiabilité par défaut à affecter aux messages générés sur ces destinations 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 à ces destinations.
  • 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 vers une 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 ces destinations de bus à une file d'attente IBM MQ, indiquez le nom du membre du bus du serveur WebSphere MQ auquel les destinations sont affectées (le paramètre -wmqServer), et le nom de la file d'attente IBM MQ utilisée pour stocker les messages envoyés à ces destinations (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 à ces destinations sont doté d'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 des destinations de type file d'attente à un membre de bus du serveur WebSphere MQ, utilisez le paramètre -useRFH2. Si vous créez des destinations d'alias ou des destinations externes, 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 1

  • Avec Jython :
    wsadmin>AdminTask.createSIBDestinations("[-bus bus1 -type QUEUE
    -cluster cluster1 -nameList [[-identifier myqueue1][-identifier myqueue2]]]")
    "(cells/9994GKCCell01/buses/bus1|sib-destinations.xml#SIBQueue_1098215169998)"
  • A l'aide de Jacl :
    wsadmin>$AdminTask createSIBDestinations {-bus bus1 -type QUEUE 
    -cluster cluster1 -nameList {{myqueue1} {myqueue2}}}
    (cells/9994GKCCell01/buses/bus1|sib-destinations.xml#SIBQueue_1098215169998)

Exemple 2 :

Créez des alias pour "MyDestination1" appelés "MyAlias1" et "MyAlias2". Ces destinations d'alias donnent accès à un seul point de file d'attente de la destination cible :
  • Avec Jython :
    wsadmin>AdminTask.createSIBDestinations("[-bus bus1 -type ALIAS 
    -nameList [[MyAlias1][MyAlias2]] -aliasBus bus1 
    -targetName MyDestination1 -reliability INHERIT -maxReliability INHERIT 
    -overrideOfOQSByProducerAllowed INHERIT -sendAllowed INHERIT 
    -receiveAllowed INHERIT -queuePoints [[MyDestination1@cluster1.001-bus1]
    [MyDestination1@cluster1.002-bus1]]]")
  • A l'aide de Jacl :
    wsadmin>set cluster [ lindex [ $AdminConfig list ServerCluster ] 1 ] 
    wsadmin>$AdminTask createSIBDestinations {-bus bus1 -type ALIAS 
    -nameList {{MyAlias1} {MyAlias2}} -aliasBus bus1 
    -targetName MyDestination1 -reliability INHERIT -maxReliability INHERIT 
    -overrideOfOQSByProducerAllowed INHERIT -sendAllowed INHERIT 
    -receiveAllowed INHERIT -queuePoints {{"MyDestination1@cluster1.001-bus1"} 
    {"MyDestination1@cluster1.002-bus1}}}

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_dests_create
Nom du fichier : rjo_cli_dests_create.html