Commande createSIBJMSQueue

La commande createSIBJMSQueue permet de créer un file d'attente JMS pour le 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.

[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 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')

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 createSIBJMSQueue permet de créer une file d'attente JMS pour le fournisseur de messagerie par défaut sur une portée spécifique.

Objet cible

Portée du fournisseur de messagerie par défaut sur laquelle la file d'attente JMS doit être créée.

Paramètres obligatoires

-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.

Paramètres optionnels

-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 le paramètre Durée de vie n'est pas indiqué.
-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 laquelle la destination du bus d'intégration de services, identifiée par nomFileAttente, 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 la file d'attente de réponses est connectée, et non le moteur de messagerie auquel l'application utilisant la file d'attente de réponses 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.

Exemples

Remarque : Dans les exemples suivants, les blocs de code commençant par wsadmin> présentent un code entré par l'utilisateur. Les lignes ne commençant pas par wsadmin> présentent un code renvoyé par la console.
  • En langage Jython :
    wsadmin>AdminConfig.getid("/Node:9994GKCNode01" )
    '9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)'
    wsadmin>AdminTask.createSIBJMSQueue("WASINSTALL2Node01(cells/WASINSTALL2Cell01/
    nodes/WASINSTALL2Node01|node.xml#Node_1)", ["-name", "jmsq2", "-jndiName",
     "jms/jnmsq2", "-queueName", "busq4jmsq2"])
    'jmsq2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml
    #J2CAdminObject_1098737234986)'
    wsadmin>AdminTask.listSIBJMSQueues("WASINSTALL2Node01(cells/WASINSTALL2Cell01
    /nodes/WASINSTALL2Node01|node.xml#Node_1)")
    'queue1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CAdminObject_1098711838691)
    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 createSIBJMSQueue 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
     {-name jmsq2 -jndiName jms/jnmsq2 -queueName busq4jmsq2}
    jmsq2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CAdminObject_1098737234986)
    wsadmin>$AdminTask listSIBJMSQueues 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
    queue1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CAdminObject_1098711838691)
    jmsq2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CAdminObject_1098737234986)
L'exemple ci-dessous montre comment créer la file d'attente JMS d'un fournisseur de messagerie par défaut qui sélectionne un point de file d'attente lorsqu'une session est ouverte et ne change jamais :
  • En langage Jython :
    wsadmin>AdminTask.createSIBJMSQueue("9994GKCNode01(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|node.xml#Node_1)", ["-name", "MyJMSQueue", "-jndiName",
     "MyJMSQueue", "-busName bus1", "-queueName", "MyExistingQueue", "-deliveryMode",
     "Application", "-readAhead", "AsConnection", "-producerBind", "TRUE"])
  • A l'aide de Jacl :
    wsadmin>$AdminTask createSIBJMSQueue 9994GKCNode01(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|node.xml#Node_1 {-name MyJMSQueue -jndiName MyJMSQueue 
    -busName bus1 -queueName MyExistingQueue -deliveryMode Application 
    -readAhead AsConnection -producerBind TRUE }
L'exemple ci-dessous montre comment créer la file d'attente JMS d'un fournisseur de messagerie par défaut qui sélectionne un point de file d'attente à chaque envoi d'un message. Peu importe le point de file d'attente sélectionné, et les destinataires prélèvent les messages d'un point de file d'attente :
  • En langage Jython :
    wsadmin>AdminTask.createSIBJMSQueue("9994GKCNode01(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|node.xml#Node_1)", ["-name", "MyJMSQueue", "-jndiName",
     "MyJMSQueue", "-busName bus1", "-queueName", "MyExistingQueue", "-deliveryMode",
     "Application", "-readAhead", "AsConnection", "-producerBind", "FALSE",
     "-producerPreferLocal", "FALSE", "-gatherMessages", "TRUE"])
  • A l'aide de Jacl :
    wsadmin>$AdminTask createSIBJMSQueue 9994GKCNode01(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|node.xml#Node_1 {-name MyJMSQueue -jndiName MyJMSQueue 
    -busName bus1 -queueName MyExistingQueue -deliveryMode Application 
    -readAhead AsConnection -producerBind FALSE -producerPreferLocal FALSE 
    -gatherMessages TRUE}
L'exemple ci-dessous montre comment créer la file d'attente JMS d'un fournisseur de messagerie par défaut qui définit les portées de toutes les opérations dont elle fait l'objet jusqu'au point de file d'attente défini en local au niveau de l'utilisateur de la file d'attente JMS :
  • En langage Jython :
    wsadmin>AdminTask.createSIBJMSQueue("9994GKCNode01(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|node.xml#Node_1)", ["-name", "MyJMSQueue", "-jndiName",
     "MyJMSQueue", "-busName bus1", "-queueName", "MyExistingQueue", "-deliveryMode",
     "Application", "-readAhead", "AsConnection", "-scopeToLocalQP", "TRUE"])
  • A l'aide de Jacl :
    wsadmin>$AdminTask createSIBJMSQueue 9994GKCNode01(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|node.xml#Node_1 {-name MyJMSQueue -jndiName MyJMSQueue 
    -busName bus1 -queueName MyExistingQueue -deliveryMode Application 
    -readAhead AsConnection -scopeToLocalQP TRUE}

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