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.

[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

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.
Vous pouvez modifier les paramètres de pool de connexions pour supprimer régulièrement toutes les connexions inutilisées dans le pool. Une fois le pool de connexions vidé, les connexions sont établies avec le moteur de messagerie préféré si une des connexions est disponible. Par exemple, attribuez la valeur 300 secondes à ReapTime, AgedTimeout et UnusedTimeout et la valeur EntirePool à PurgePolicy. Le pool de connexions est régénéré toutes les cinq minutes. Ensuite, l'application sélectionne un moteur de messagerie préféré si un moteur est 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 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
-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

Propriétés de "transmission de la charge de messages par référence" :
-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.
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.
-authDataAlias
nom_alias
-shareDataSourceWithCMP
True | False

-xaRecoveryAuthAlias
nom_alias

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

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_jmscf_create
Nom du fichier : rjn_jmscf_create.html