Commande modifySIBJMSConnectionFactory
La commande modifySIBJMSConnectionFactory permet de modifier les propriétés d'une fabrique de connexions 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.
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 modifie les propriétés d'une fabrique de connexions JMS.
Objet cible
Fabrique de connexions JMS.
Paramètres requis
Aucun.
Paramètres optionnels
- -name
- nom_fabrique
- -jndiName
- nom_jndi
- -category
- category
- -description
- texte
- -logMissingTransactionContext
- True | False
- -manageCachedHandles
- True | False
- -busName
- nom
- -clientID
- id
- -userName
- nom
- -password
- motdepasse
- -target
- nom_cible
- -targetType
- BusMember | Custom | ME
- -targetSignificance
- Preferred | Required
- -targetTransportChain
- chaîne_transport
- -providerEndPoints
- liste_bloc_données
- -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.
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
- Avec Jython :
wsadmin>AdminConfig.getid("/Node:9994GKCNode01" ) "9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)" wsadmin>AdminTask.modifySIBJMSConnectionFactory("jmsqcf2(cells/9994GKCNode01Cell/ nodes/9994GKCNode01|resources.xml#J2CConnectionFactory_1098736176544)", ["-manageCachedHandles", "True"]) "jmsqcf2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#J2CConnectionFactory_1098733675578)"
- A l'aide de Jacl :
wsadmin>$AdminConfig getid /Node:9994GKCNode01 9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) wsadmin>$AdminTask modifySIBJMSConnectionFactory jmsqcf2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# J2CConnectionFactory_1098736176544) {-manageCachedHandles True} jmsqcf2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# J2CConnectionFactory_1098733675578)