Commande modifySIBDestination
La commande modifySIBDestination permet de modifier les propriétés d'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 modifySIBDestination permet de modifier les propriétés d'une destination de bus pour un bus d'intégration de services.
Objet cible
Une destination de bus.
Paramètres requis
- -bus
- Nom du bus d'intégration de services sur lequel la destination de bus est configurée. Vous pouvez utiliser la commande listSIBuses pour afficher la liste des noms des bus existants.
- -name
- Identificateur sous lequel cette destination est connue à des fins d'administration.
Paramètres conditionnels
Aucun.
Paramètres optionnels
- -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.
- -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 (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 effacé, 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.Remarque : Si l'ordre strict des messages est activé pour une destination de rubrique existante, tout abonnement durable existant associé aux messages associés devient non valide. Lorsque l'ordre strict des messages est activé et que l'environnement est redémarré, les abonnements durables existants sont supprimés et recréés ; les messages associés aux abonnements durables sont également supprimés.
- -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.
- -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
- -useAllQueuePoints TRUE | FALSE
- Si vous spécifiez TRUE pour cette option, tous les points de file d'attente disponibles sont utilisés, tandis que si vous spécifiez FALSE, seuls les points de file d'attente de la liste spécifiés par l'option -queuePoints sont utilisés.
- -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
- -useAllMediationPoints TRUE | FALSE
- Si vous spécifiez TRUE pour cette option, tous les points de file d'attente disponibles sont utilisés, tandis que si vous spécifiez FALSE, seuls les points de file d'attente de la liste spécifiés par l'option -mediationPoints sont utilisés.
- -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.showSIBDestination(["-bus", "abus", "-name", "myqueue"]) "{receiveExclusive=false, defaultForwardRoutingPath=[], defaultPriority=0, exceptionDestination=_SYSTEM.Exception.Destination.node01.aserver-abus, uuid=97CC75AC71E5932CAB3417AC, overrideOfQOSByProducerAllowed=true, sendAllowed=true, maxFailedDeliveries=5, maxReliability=ASSURED_PERSISTENT, reliability=ASSURED_PERSISTENT, receiveAllowed=true, identifier=myqueue}" wsadmin>AdminTask.modifySIBDestination(["-bus", "abus", "-name", "myqueue", "-receiveAllowed", "FALSE"]) wsadmin>AdminTask.showSIBDestination(["-bus", "abus", "-name", "myqueue"]) "{receiveExclusive=false, defaultForwardRoutingPath=[], defaultPriority=0, exceptionDestination=_SYSTEM.Exception.Destination.node01.aserver-abus, uuid=97CC75AC71E5932CAB3417AC, overrideOfQOSByProducerAllowed=true, sendAllowed=true, maxFailedDeliveries=5, maxReliability=ASSURED_PERSISTENT, reliability=ASSURED_PERSISTENT, receiveAllowed=false, identifier=myqueue}"
- A l'aide de Jacl :
wsadmin>$AdminTask showSIBDestination {-bus abus -name myqueue} {receiveExclusive=false, defaultForwardRoutingPath=[], defaultPriority=0, exceptionDestination=_SYSTEM.Exception.Destination.node01.aserver-abus, uuid=97CC75AC71E5932CAB3417AC, overrideOfQOSByProducerAllowed=true, sendAllowed=true, maxFailedDeliveries=5, maxReliability=ASSURED_PERSISTENT, reliability=ASSURED_PERSISTENT, receiveAllowed=true, identifier=myqueue} wsadmin>$AdminTask modifySIBDestination {-bus abus -name myqueue -receiveAllowed FALSE} (cells/9994GKCCell01/buses/abus|sib-destinations.xml#SIBQueue_1098215169998) wsadmin>$AdminTask showSIBDestination {-bus abus -name myqueue} {receiveExclusive=false, defaultForwardRoutingPath=[], defaultPriority=0, exceptionDestination=_SYSTEM.Exception.Destination.node01.aserver-abus, uuid=97CC75AC71E5932CAB3417AC, overrideOfQOSByProducerAllowed=true, sendAllowed=true, maxFailedDeliveries=5, maxReliability=ASSURED_PERSISTENT, reliability=ASSURED_PERSISTENT, receiveAllowed=false, identifier=myqueue}
Exemple : modification d'un alias de destination "MyAlias2" pour utiliser un sous-ensemble de points de file d'attente et de points de médiation disponibles :
- Avec Jython :
cluster=AdminConfig.list("ServerCluster").splitlines()[0] Qp1=AdminConfig.list("SIBQueueLocalizationPoint" , cluster).splitlines()[0] Mp1=AdminConfig.list("SIBMediationLocalizationPoint").splitlines()[0] AdminTask.modifySIBDestination(["-bus" , "bus1" , "-name" , "MyAlias2", "-queuePoints", [[Qp1]], "-mediationPoints" , [[Mp1]]])
- A l'aide de Jacl :
set cluster [ lindex [ $AdminConfig list ServerCluster ] 1 ] set Qp1 [ lindex [ $AdminConfig list SIBQueueLocalizationPoint $cluster ] 0 ] set Mp1 [ lindex [ $AdminConfig list SIBMediationLocalizationPoint ] 0 ] $AdminTask modifySIBDestination {-bus bus1 -name MyAlias2 -queuePoints [[$Qp1]]-mediationPoints [[$Mp1]]}
Exemple : modification d'un alias de destination pour supprimer toutes les limitations sur les points de file d'attente utilisés :
- Avec Jython :
AdminTask.modifySIBDestination(["-bus" , "bus1" , "-name" , "MyAlias2", "-queuePoints", [[]]])
- A l'aide de Jacl :
$AdminTask modifySIBDestination {-bus bus1 -name MyAlias2 -useAllQueuePoints=true -useAllMediationPoints=true}