Commande modifySIBJMSQueue
La commande modifySIBJMSQueue permet de modifier les propriétés d'une file d'attente JMS du fournisseur de messagerie par défaut sur une portée spécifique.
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 JMS 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('SIBJMSAdminCommands')
- 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 modifySIBJMSQueue permet de modifier les propriétés d'une file d'attente JMS du fournisseur de messagerie par défaut sur une portée spécifique.
Objet cible
File d'attente JMS.
Paramètres requis
Aucun.
Paramètres optionnels
- -name
- Identificateur sous lequel cette file d'attente JMS est connue à des fins d'administration.
- -jndiName
- Nom JNDI utilisé pour lier la file d'attente dans l'espace de nom du serveur d'applications.
- -queueName
- Nom de la destination du bus d'intégration de services à laquelle la file d'attente JMS est mappée.
- -description
- Description facultative du bus à des fins d'administration.
- -deliveryMode Application | NonPersistent | Persistent
- Mode de livraison qu'utilise MessageProducers pour les messages envoyés à cette file d'attente.
- -timeToLive
- Durée par défaut à partir du moment de la distribution d'un message envoyé à cette file d'attente pendant laquelle il doit être conservé par le système, 0 indiquant que la durée de vie n'expire pas. La valeur indiquée par le fournisseur est utilisée si ce paramètre n'est pas fourni.
- -priority
- Priorité des messages envoyés à cette file d'attente. La valeur indiquée par le fournisseur est utilisée si elle n'est pas renseignée. Comprise entre 0 et 9, 0 étant la priorité la plus basse et 9 la priorité la plus élevée
- -readAhead AsConnection | AlwaysOn | AlwaysOff
- Permet de contrôler l'optimisation de la lecture anticipée lors de la distribution des messages. La valeur par défaut est AsConnection.
- -busName
- Nom du bus d'intégration de services sur lequel la destination du bus, identifiée par queueName, est configurée. S'il n'est pas défini, le bus auquel l'application est connectée est utilisé.
- -scopeToLocalQP TRUE | FALSE
- Indique si la destination de file d'attente du bus d'intégration de services sous-jacent est sectorisée
vers un point de file d'attente locale lorsqu'elle est adressée à l'aide de cette file d'attente JMS. Un point de
file d'attente locale est un point de file d'attente configuré sur le moteur de messagerie auquel
l'application JMS est connectée. Cette option s'applique lorsque la file
d'attente JMS est utilisée pour envoyer et recevoir des messages et lors de la
définition d'une file d'attente de réponses dans un message de demande. Lorsqu'une file d'attente de réponses est définie dans un message de demande, le point de file d'attente local se trouve sur le moteur de messagerie auquel l'application définissant le file d'attente de réponses est connectée, et non le moteur de messagerie auquel l'application utilisant le file d'attente de réponse envoie le message de réponse. Si le moteur de messagerie connecté ne dispose pas de point de file d'attente pour la destination, cette option est ignorée.
La valeur par défaut est FALSE.
La modification de la valeur par défaut de cette option est prise en charge uniquement si elle est utilisée par une application JMS qui s'exécute avec un serveur ou un client WebSphere Application Server Version 7.0 ou ultérieures et est connectée à un moteur de messagerie s'exécutant sur un serveur WebSphere Application Server Version 7.0 ou ultérieures. L'utilisation sur des versions antérieures de WebSphere Application Server entraîne une exception de l'application.
- -producerBind TRUE | FALSE
- Indique la manière dont les fournisseurs JMS associent aux points de file d'attente de la file
d'attente en cluster.
La valeur par défaut est FALSE.
La modification de la valeur par défaut de cette option est prise en charge uniquement si elle est utilisée par une application JMS qui s'exécute avec un serveur ou un client WebSphere Application Server Version 7.0 ou ultérieures et est connectée à un moteur de messagerie s'exécutant sur un serveur WebSphere Application Server Version 7.0 ou ultérieures. L'utilisation sur des versions antérieures de WebSphere Application Server entraîne une exception de l'application.
- TRUE
- Le système de messagerie sélectionne un point de file d'attente lorsque la session est ouverte. Tous les messages générés par la session sont envoyés au point de file d'attente choisi. Le système de messagerie utilise le paramètre producerPreferLocal lorsqu'il sélectionne le point de file d'attente.
- FALSE
- Le système de messagerie sélectionne un point de file d'attente chaque fois qu'un message est envoyé et équilibre éventuellement la charge de travail des messages entre tous les points de file d'attente disponibles. Le système de messagerie utilise le paramètre producerPreferLocal lorsqu'il sélectionne le point de file d'attente.
- -producerPreferLocal TRUE | FALSE
- Indique si un point de file d'attente en local sur le producteur est
prioritaire par rapport aux autres points de file d'attente disponibles lorsque
le système de messagerie sélectionne un point de file d'attente pour y générer
des messages. Un point de
file d'attente locale est un point de file d'attente configuré sur le moteur de messagerie auquel
l'application JMS est connectée. La valeur par défaut est TRUE.
La modification de la valeur par défaut de cette option est prise en charge uniquement si elle est utilisée par une application JMS qui s'exécute avec un serveur ou un client WebSphere Application Server Version 7.0 ou ultérieures et est connectée à un moteur de messagerie s'exécutant sur un serveur WebSphere Application Server Version 7.0 ou ultérieures. L'utilisation sur des versions antérieures de WebSphere Application Server entraîne une exception de l'application.
- -consumerGatherMessages TRUE | FALSE
- Un navigateur ou un consommateur JMS est associé à un point de file
d'attente de la destination de bus d'intégration de services par le système de
messagerie. Ce paramètre indique si un navigateur ou un consommateur JMS accepte les messages de tous les points de file d'attente disponibles de la
destination de bus d'intégration de services (TRUE) ou du point de file d'attente auquel il est associé (FALSE). La valeur par défaut est FALSE. La collecte de messages de plusieurs points de file d'attente entraîne l'augmentation des coûts de performance et l'ordre des messages ne peut pas être conservé.
La modification de la valeur par défaut de cette option est prise en charge uniquement si elle est utilisée par une application JMS qui s'exécute avec un serveur ou un client WebSphere Application Server Version 7.0 ou ultérieures et est connectée à un moteur de messagerie s'exécutant sur un serveur WebSphere Application Server Version 7.0 ou ultérieures. L'utilisation sur des versions antérieures de WebSphere Application Server entraîne une exception de l'application.
Exemple
- Avec Jython :
wsadmin>AdminConfig.getid("/Node:9994GKCNode01" ) '9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)' wsadmin>AdminTask.modifySIBJMSQueue("jmsq2(cells/9994GKCNode01Cell/nodes/ 9994GKCNode01|resources.xml#J2CAdminObject_1098737234986)", ["-queueName", "q2forjms"]) 'jmsq2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# J2CAdminObject_1098737234986)'
- A l'aide de Jacl :
wsadmin>$AdminConfig getid /Node:9994GKCNode01 9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) wsadmin>$AdminTask modifySIBJMSQueue jmsq2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# J2CAdminObject_1098737234986) {-queueName q2forjms} jmsq2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# J2CAdminObject_1098737234986)