Commande createSIBJMSConnectionFactory
La commande createSIBJMSConnectionFactory permet de créer une fabrique de connexions 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.
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
Cette commande crée une fabrique de connexions JMS sur une portée spécifique.
Objet cible
Portée du fournisseur de messagerie par défaut sur laquelle la fabrique de connexions JMS doit être créée.
Paramètres requis
- -name
- Nom administratif affecté à cette fabrique de connexions.
- -jndiName
- Nom JNDI indiqué dans les liaisons des beans gérés par message associés à cette fabrique de connexions.
- -busName
- Entrez le 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.
Paramètres optionnels
- -type
- queue | topic
- Le paramètre type permet de spécifier le type de fabrique de connexions à créer : Pour créer une fabrique de connexions de file d'attente, associez ce paramètre à la valeur queue. Pour créer une fabrique de connexions de sujet, associez ce paramètre à la valeur topic. Pour créer une fabrique de connexions générique, ne définissez pas ce paramètre.
- -category
- Chaîne de catégories facultative à utiliser lors de la classification ou du regroupement de la ressource.
- -description
- texte
- -logMissingTransactionContext
- True | False
- -manageCachedHandles
- True | False
- -clientID
- id
- -userName
- nom
- -password
- mot_de_passe
- -target
-
Avant l'exécution de la recherche de la proximité des connexions pour sélectionner un moteur de messagerie approprié, le jeu de moteurs de messagerie membres du groupe cible indiqué est sélectionné. La recherche de proximité des connexions est alors restreinte à ces moteurs de messagerie. Si un groupe cible n'est pas indiqué (valeur par défaut), tous les moteurs de messagerie du bus sont pris en compte pendant la recherche de proximité des connexions. Par exemple, si la propriété Type de cible correspond à Nom du membre du bus, la propriété Cible indique le nom du membre du bus à partir duquel les moteurs de messagerie peuvent être sélectionnés.
- -targetType
- 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).
Pour désigner un membre de bus non mis en cluster, vous devez définir la propriété -target surnom_noeud.nom_serveur, par exemple Node01.server1. Pour un membre de bus en cluster, la propriété -target doit indiquer le nom du cluster.
- 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
Cette propriété détermine si la recherche de proximité des connexions est limitée aux moteurs de messagerie dans le groupe cible.
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é.Remarque : Il est possible qu'une connexion à une cible non préférée soit renvoyée même si une cible favorite est disponible. Cela peut se produire lorsque la fabrique de connexions est activée pour une fabrique de connexions, ce qui est la situation par défaut lorsque vous utilisez une fabrique de connexions JMS dans un environnement de serveur :
- Lorsqu'aucun moteur de messagerie favori n'est disponible, une connexion à un moteur non préféré peut être créé et stocké dans le pool de connexions.
- A la prochaine demande d'une connexion par l'application, cette dernière reçoit une connexion mise en pool même si le moteur de messagerie préféré devient ensuite disponible.
- 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
-
Ces chaînes de transport indiquent les protocoles de communication qui peuvent être utilisés avec le serveur d'applications auquel l'application client est connectée.
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 . 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.
- -providerEndPoints
- -connectionProximity
- Bus | Host | Cluster | Server
- -durableSubscriptionHome
- nom_moteur_messagerie
- -nonPersistentMapping
- BestEffortNonPersistent | ExpressNonPersistent | ReliableNonPersistent | ReliablePersistent | AssuredPersistent | AsSIBDestination | None
- -persistentMapping
- BestEffortNonPersistent | ExpressNonPersistent | ReliableNonPersistent | ReliablePersistent | AssuredPersistent | AsSIBDestination | None
- -readAhead
- Default | AlwaysOn | AlwaysOff
- -tempQueueNamePrefix
- préfixe
- -tempTopicNamePrefix
- préfixe
- -shareDurableSubscriptions
- AsCluster | AlwaysShared | NeverShared
- -producerDoesNotModifyPayloadAfterSet
- true | false (false par défaut)
- Les applications qui utilisent cette fabrique de connexions pour envoyer les messages doivent respecter les règles suivantes :
- L'application ne modifie pas l'objet de données stocké dans un message d'objet JMS.
- L'application remplit un message d'octets JMS en utilisant un appel à writeBytes(byte[]) et ne modifie pas le tableau d'octets une fois qu'il est défini dans le message.
- -consumerDoesNotModifyPayloadAfterGet
- true | false (false par défaut)
- Les applications qui utilisent cette fabrique de connexions 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.
- -authDataAlias
- nom_alias
- -shareDataSourceWithCMP
- True | False
- -xaRecoveryAuthAlias
- nom_alias
Exemple
- Langage
Jython :
wsadmin>AdminConfig.getid("/Node:9994GKCNode01" )
"9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)"
wsadmin>AdminTask.createSIBJMSConnectionFactory("9994GKCNode01(cells/ 9994GKCNode01Cell/nodes/9994GKCNode01|node.xml)", ["-name", "jmscf1", "-jndiName", "jms/jmscf1", "-busName", "abus"])
"jmscf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# J2CConnectionFactory_1098733325084)"
wsadmin>AdminTask.createSIBJMSConnectionFactory("9994GKCNode01(cells/ 9994GKCNode01Cell/nodes/9994GKCNode01|node.xml)", ["-name", "jmsqcf2", "-jndiName", "jms/jmsqcf1", "-busName", "abus", "-type", "queue"])
"jmsqcf2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# J2CConnectionFactory_1098733675578)"
- Avec Jacl :
wsadmin>$AdminConfig getid /Node:9994GKCNode01
9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
wsadmin>$AdminTask createSIBJMSConnectionFactory 9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) {-name jmscf1 -jndiName jms/jmscf1 -busName abus}
jmscf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# J2CConnectionFactory_1098733325084)
wsadmin>$AdminTask createSIBJMSConnectionFactory 9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) {-name jmsqcf2 -jndiName jms/jmsqcf1 -busName abus -type queue}
jmsqcf2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# J2CConnectionFactory_1098733675578)