Commande createSIBJMSActivationSpec

La commande createSIBJMSActivationSpec permet de créer une spécification d'activation 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 createSIBJMSActivationSpec crée une spécification d'activation JMS sur une portée spécifique.

Objet cible

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

Paramètres requis

-name
Nom administratif affecté à cette spécification d'activation.
-jndiName
Nom JNDI indiqué dans les liaisons des beans gérés par message associés à cette spécification d'activation.

Paramètres facultatifs

-description
Description facultative de la spécification d'activation.
-destinationJndiName
Nom JNDI de la file d'attente ou du sujet JMS de destination utilisé par le bean géré par message. Les paramètres de nom JNDI de destination et de nom de consultation de destination ont la même utilisation pour le stockage du nom JNDI de destination dans la configuration. Bien que les deux zones individuellement ne soient pas obligatoires, vous devez vous assurer qu'au moins l'une d'entre elles comporte une valeur. Lorsque les paramètres destinationLookup et destinationJndiName comportent des valeurs, le paramètre destinationLookup est prioritaire sur le paramètre. destinationJndiName.
-destinationLookup
Nom JNDI de la file d'attente ou du sujet JMS de destination utilisé par le bean géré par message. Les paramètres de nom JNDI de destination et de nom de consultation de destination ont la même utilisation pour le stockage du nom JNDI de destination dans la configuration. Bien que les deux zones individuellement ne soient pas obligatoires, vous devez vous assurer qu'au moins l'une d'entre elles comporte une valeur. Lorsque les paramètres destinationLookup et destinationJndiName comportent des valeurs, le paramètre destinationLookup est prioritaire sur le paramètre. destinationJndiName.
-connectionFactoryLookup
Nom JNDI de recherche de fabrique de connexions. Lorsque la recherche de fabrique de connexions est définie dans la spécification d'activation en tant que nom JNDI, les propriétés de fabrique de connexions sont prioritaires sur les propriétés définies sur une configuration de spécification d'activation. Ainsi, l'ID client défini comme composant du nom JNDI de la fabrique de connexions a la priorité sur l'ID client défini sur une propriété de configuration de spécification d'activation.
-destinationType
Option permettant de déterminer si le bean géré par message utilise une file d'attente ou un sujet JMS. Sélectionnez l'une des valeurs suivantes :
File d'attente
Le bean géré par message utilise une file d'attente JMS. Le nom JNDI de la file d'attente JMS est spécifié dans la propriété Nom JNDI de destination.
Rubrique
Le bean géré par message utilise un sujet JMS. Le nom JNDI du sujet JMS est spécifié dans la propriété Nom JNDI de destination.
-messageSelector

La chaîne du sélecteur peut faire référence aux zones de l'en-tête du message JMS et aux zones des propriétés du message. Les sélecteurs de messages ne peuvent pas faire référence à des valeurs liées au corps du message.

Une valeur null (chaîne vide) indique qu'il n'existe aucun sélecteur de message pour le consommateur du message.

-busName
Nom du bus d'intégration de services avec lequel les connexions sont établies. Il doit s'agir du nom du bus sur lequel la destination de bus identifiée par la propriété -destinationJndiNameest définie.
-acknowledgeMode
Le mode d'identification indique comment un message reçu par un bean géré par message doit être identifié. Sélectionnez l'une des valeurs suivantes :
Accusé de réception automatique
La session accuse réception d'un message automatiquement.
Accusé de réception auto OK en double
La session accuse réception des messages de façon passive, ce qui peut améliorer les performances, mais un bean géré par message peut alors recevoir un message plusieurs fois.
-target
Nom d'une cible qui identifie un groupe de moteurs de messagerie. Définissez le type de cible en utilisant la propriété Type de cible.
-targetType
Type de cible nommé dans la propriété -target. Sélectionnez l'une des valeurs suivantes :
Nom du membre du bus
Nom d'un membre du bus. Cette option extrait les moteurs de messagerie actifs qui sont hébergés par le membre de bus spécifié (un serveur d'applications ou un cluster de serveurs).
Nom du groupe de moteurs de messagerie personnalisés
Nom d'un groupe personnalisé de moteurs de messagerie (formant un cluster auto-déclaré). Cette option extrait les moteurs de messagerie actifs qui sont enregistrés dans le groupe personnalisé spécifié.
le nom du moteur de messagerie,
Nom d'un moteur de messagerie. Cette option extrait les noeuds finaux disponibles qui permettent d'atteindre le moteur de messagerie spécifié.
-targetSignificance
Sélectionnez l'une des valeurs suivantes :
Préférée
Il est préférable de sélectionner un moteur de messagerie dans le groupe cible. Si un moteur de messagerie du groupe cible est disponible, il est sélectionné. Si aucun moteur de messagerie n'est disponible dans le groupe cible, mais qu'il existe un moteur de messagerie externe disponible dans le même bus d'intégration de services, ce dernier est sélectionné.
Requis
Un moteur de messagerie doit être sélectionné dans le groupe cible. Si un moteur de messagerie du groupe cible est disponible, il est sélectionné. Si aucun moteur de messagerie n'est disponible dans le groupe cible, le processus de connexion échoue.
-targetTransportChain

Si le moteur de messagerie sélectionné se trouve sur le même serveur que l'application, une connexion directe en cours de processus est établie et cette propriété de chaîne de transport est ignorée.

Les chaînes de transport représentent des piles de protocoles réseau en fonctionnement sur un serveur. Le nom que vous spécifiez doit correspondre à celui de l'une des chaînes de transport disponibles sur le serveur qui héberge le moteur de messagerie, comme indiqué dans le panneau Serveurs -> Types de serveurs -> Serveurs d'applications WebSphere -> nom_serveur -> [Messagerie du serveur] Transports entrants du moteur de messagerie. Les chaînes de transport ci-après sont fournies, mais vous pouvez définir vos propres chaînes dans ce panneau.
InboundBasicMessaging
Il s'agit d'un protocole orienté connexion qui utilise une connexion standard TCP/IP (JFAP-TCP/IP). Il prend en charge deux flux transactionnels biphasé (XA distant). Un émetteur ou un destinataire de messages qui fonctionne sur un système client ou serveur peut participer à une transaction globale gérée sur ce système client ou serveur. Les flux XA permettent à une application exécutée sur un serveur d'accéder à un moteur de messagerie sur un deuxième serveur dans la mesure où le premier serveur n'héberge pas de moteur le messagerie approprié. Si les flux XA distants sont utilisés, l'application doit pouvoir accéder à un coordinateur de transactions en local.
InboundSecureMessaging
Il s'agit du protocole InboundBasicMessaging encapsulé dans SSL.
Pour plus d'informations sur l'utilisation de cette propriété avec d'autres propriétés de fabrique de connexions pour la gestion de la charge de travail des connexions, voir la rubrique Propriétés d'administration des connexions JMS à un bus.
-providerEndPoints
Liste comportant trois noeuds finaux séparés par des virgules, avec la syntaxe nom_hôte:numéro_port:nom_chaîne, utilisée pour se connecter à un serveur d'amorçage. Par exemple Merlin:7276:BootstrapBasicMessaging,Gandalf:5557:BootstrapSecureMessaging.

Les noeuds finaux du fournisseur sont utilisés si le bus indiqué est introuvable dans la cellule locale. Les applications de bean géré par message tentent d'abord de connecter le bus indiqué dans la cellule locale. Si cette tentative échoue, les noeuds finaux du fournisseur sont utilisés pour permettre aux applications de recevoir les messages d'une cellule éloignée.

Si le nom d'hôte n'est pas indiqué, localhost est utilisé comme valeur par défaut.

Si le numéro de port n'est pas indiqué, 7276 est utilisé comme valeur par défaut.

Si le protocole n'est pas indiqué, une chaîne prédéfinie comme BootstrapBasicMessaging est utilisée comme valeur par défaut.

-authenticationAlias

Un alias d'authentification Java™ Platform, Enterprise Edition (Java EE) JCA (Connector Architecture) spécifie l'ID utilisateur et le mot de passe qui permettent d'authentifier la création d'une connexion au fournisseur JMS.

-maxBatchSize
Nombre maximal de messages d'un même lot distribué en série à une unique instance de bean géré par message. La distribution par lot des messages peut améliorer les performances, notamment si elle est utilisée avec une propriété Mode de reconnaissance dont la valeur est Accusé de réception auto OK en double. Si le classement des messages doit être conservé après des échecs de distribution, choisissez une taille de lot de 1.
-maxConcurrency

L'augmentation de cette valeur peut améliorer les performances, mais également augmenter le nombre d'unités d'exécution utilisées simultanément. Si le classement des messages doit être conservé après des échecs de distribution, indiquez un nombre maximal de noeuds finaux simultanés de 1. Le classement des messages s'applique uniquement si la destination à partir de laquelle le bean géré par message reçoit les messages n'est pas une destination partitionnée. Les destinations partitionnées sont utilisées dans un scénario de partage des charges dans un cluster.

-subscriptionDurability
Cette option indique si un abonnement à des sujets JMS est durable ou non.
En général, une seule application à la fois peut avoir un destinataire pour un abonnement durable donné. Cette propriété permet de redéfinir ce comportement et d'autoriser l'accès simultané de plusieurs destinataires à un abonnement durable. Sélectionnez l'une des valeurs suivantes :
Durable
Le fournisseur de messagerie stocke les messages lorsque le bean géré par message n'est pas disponible et distribue les messages lorsque le bean géré par message redevient disponible.
Non durable
Le fournisseur de messagerie ne procède pas au stockage et à la redistribution des messages si aucun bean géré par message n'est disponible.
-subscriptionName

Chaque abonnement durable JMS est identifié par un nom d'abonnement (spécifié dans cette propriété). Une connexion JMS a également un identificateur client associé (spécifié dans la propriété Identificateur client) qui permet d'associer une connexion et ses objets à la liste des messages (dans l'abonnement durable) gérée par le fournisseur JMS du client.

Le nom de cet abonnement doit être unique dans un identificateur de client donné.

-clientId

La valeur spécifiée est l'identificateur unique d'un client (bean géré par message). Cet identificateur permet d'associer une connexion client à la liste des messages (dans un abonnement durable) conservée par le fournisseur de messagerie pour le client. Lorsqu'un client devient disponible, après avoir été indisponible, le fournisseur de messagerie utilise l'identificateur du client pour remettre les messages stockés au client approprié.

-durableSubscriptionHome

Les administrateurs peuvent gérer l'état d'exécution des abonnements durables via des points de publication pour ce moteur de messagerie.

-shareDurableSubscriptions

Généralement, une seule session à la fois peut avoir un TopicSubscriber pour un abonnement durable donné. Cette propriété vous permet de redéfinir ce comportement et permettre l'accès simultané de plusieurs destinataires à un abonnement durable, chacun étant connecté à un serveur d'applications dans le cluster de serveurs.

Sélectionnez l'une des valeurs suivantes :
Dans le cluster
Permet le partage d'abonnements durables lors de connexions à partir d'un cluster de serveurs.
Toujours partagé
Les abonnements durables peuvent être partagés sur des connexions.
Jamais partagé
Les abonnements durables ne sont jamais partagés sur des connexions.
-shareDataSourceWithCmp

True | False

Cette option est utilisée comme partie de la tâche afin d'activer les beans entity CMP pour partager les connexions de base de données utilisées par le magasin de données d'un moteur de messagerie. Cela permettrait d'améliorer les performances du débit général des messages d'environ 15 %, mais n'est possible que pour les beans entity connectés au serveur d'applications contenant le moteur de messagerie. Cette option ne doit pas être activée pour un moteur de messagerie utilisant le magasin de fichiers comme son magasin de données.

Pour plus d'informations sur l'utilisation de cette option, voir Activation de beans entity CMP et de magasins de données de moteur de messagerie pour le partage des connexions de base de données.

-readAhead

Les messages affectés à un destinataire sont verrouillés sur le serveur et ne peuvent pas être consommés par d'autres destinataires de cette destination. Les messages affectés à un destinataire, mais qui ne sont pas consommés avant la fermeture du client, sont ensuite déverrouillés sur le serveur, puis prêts à être reçus par d'autres destinataires.

Vous pouvez redéfinir cette propriété pour des destinations JMS en définissant la propriété Lecture anticipée sur la destination JMS.

Sélectionnez l'une des valeurs suivantes :
Activé
Le fournisseur de messagerie affecte les messages aux clients par anticipation. Ainsi le temps nécessaire à la satisfaction des demandes des destinataires est réduit.
Désactivé
Le fournisseur de messagerie n'affecte pas les messages aux clients par anticipation.
Valeut par défaut
Le fournisseur de messages affecte les messages aux clients par anticipation pour les abonnements non durables et les abonnements durables non partagés. L'optimisation de la lecture anticipée est donc activée uniquement s'il ne peut y avoir qu'un seul client.
Propriétés de "transmission de la charge de messages par référence" :
-forwarderDoesNotModifyPayloadAfterSet
true | false (false par défaut)
Les applications renvoyant les messages initialement reçus à l'aide de cette spécification d'activation doivent respecter les règles suivantes :
  • L'application peut remplacer l'objet de données dans un message JMS à condition qu'il n'ait pas encore été défini dans le message. L'application ne modifie ou ne remplace pas l'objet de donnés après sa définition dans le message.
  • L'application peut remplacer le tableau d'octets dans un message d'octets JMS, mais uniquement en utilisant un seul appel à writeBytes(byte[]) et si le tableau d'octets n'a pas encore été défini dans le message. L'application ne modifie ou ne remplace pas le tableau d'octets après sa définition dans le message.
-consumerDoesNotModifyPayloadAfterGet
true | false (false par défaut)
Les applications qui utilisent la spécification d'activation pour recevoir les messages doivent respecter la règle suivante : L'application ne modifie pas l'objet de données obtenu à partir du message d'objet JMS. L'objet des données sont traitées en mode lecture seule.
Lorsque des messages volumineux de type objet ou octet sont envoyés, la quantité de mémoire et le traitement processeur nécessaires pour sérialiser, désérialiser et copier les messages peuvent être importants. Si vous activez les propriétés de transmission de la charge de messages par référence sur une fabrique de connexions ou une spécification d'activation, vous pouvez demander au fournisseur de messagerie par défaut d'ignorer la spécification JMS 1.1 et de limiter fortement ou d'ignorer la copie de ces données.
ATTENTION :
Les parties de la spécification JMS ignorées par ces propriétés sont définies pour assurer l'intégrité des données. Toute application JMS utilisant ces propriétés doit respecter strictement les règles décrites dans la rubrique Pourquoi et quand transmettre la charge utile des messages JMS par référence, pour éviter la perte de l'intégrité des données.
-alwaysActivateAllMDBs
True | False

Cette propriété est utilisée uniquement lorsque l'application à bean géré par message s'exécute sur un serveur membre du bus que l'application cible. Elle n'a pas d'effet lorsque le bean géré par message s'exécute sur un serveur membre du bus cible.

Si l'application de bean géré par message (MDB) s'exécute sur un serveur membre du bus cible, l'activation de cette option permet à l'application de traiter les messages, que le serveur héberge ou non également un moteur de messagerie actif. Si cette option n'est pas activée, les applications à bean géré par messages des serveurs qui ne disposent pas de moteur de messagerie local ne traitent pas les messages.

Pour les applications de beans gérés par message qui se connectent à un membre de bus du cluster, vous pouvez également utiliser cette option pour activer l'une des configurations supplémentaires suivantes :
  • Tous les serveurs du cluster peuvent recevoir des messages d'une application de beans gérés par messages pour tirer pleinement parti de la puissance de traitement du cluster.
  • Un seul serveur à la fois peut recevoir les messages de l'application de beans gérés par message pour assurer le traitement séquentiel des messages.
Pour permettre à tous les serveurs du cluster à recevoir les messages de l'application MDB, sélectionnez cette option. Pour permettre à un seul serveur de recevoir des messages de l'application MDB, vérifiez que cette option n'est pas sélectionnée et sélectionnez l'option Réception exclusive sur la destination.

Pour plus d'informations, voir la rubrique Connexion d'un bean géré par message dans un cluster.

-retryInterval
-userName
ID utilisateur à employer pour la sécurité du connecteur Java 2.
-password
Mot de passe à utiliser pour la sécurité du connecteur Java 2.
-WAS_EndpointInitialState
ACTIVE |INACTIVE
Cette propriété détermine si le noeud final est activé lors de son enregistrement. Si la propriété est définie sur ACTIVE, la consommation des messages commence à partir de la destination JMS dès que la spécification d'activation est utilisée pour un bean géré par message en vue de la connexion à la destination.

Exemple

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.
  • L'exemple suivant présente la création d'une spécification d'activation à l'aide de Jython :
    wsadmin>AdminConfig.getid("/Node:9994GKCNode01" )
    "9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)"
    wsadmin>AdminTask.createSIBJMSActivationSpec("9994GKCNode01(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|node.xml"), ["-name", "myjmsas", "-jndiName", "jms/myjmsas",
     "-destinationJndiName", "jms/mqueue", "-busName", "abus"]) 
    "myjmsas(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CActivationSpec_1098726667851)"
    
    wsadmin>AdminTask.listSIBJMSActivationSpecs("9994GKCNode01(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|node.xml)")
    "myjmsas(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CActivationSpec_1098726667851)"
  • L'exemple suivant présente la création d'une spécification d'activation à l'aide de Jacl :
    wsadmin>$AdminConfig getid /Node:9994GKCNode01
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
    wsadmin>$AdminTask createSIBJMSActivationSpec 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
    {-name myjmsas -jndiName jms/myjmsas -destinationJndiName jms/mqueue -busName 
    abus} 
    myjmsas(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CActivationSpec_1098726667851)
    wsadmin>$AdminTask listSIBJMSActivationSpecs 9994GKCNode01 (cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
    myjmsas(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CActivationSpec_1098726667851)

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_jmsas_create
Nom du fichier : rjn_jmsas_create.html