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.

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

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

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_modify
Nom du fichier : rjn_jmscf_modify.html