Commande modifyWMQActivationSpec
La commande modifyWMQActivationSpec permet de modifier certains paramètres d'une spécification d'activation du fournisseur de messagerie WebSphere MQ.
Pour exécuter la commande, utilisez l'objet AdminTask du client de scriptage wsadmin.
Le client de scriptage wsadmin est exécuté
depuis Qshell. Pour plus d'informations, voir "Configurer Qshell
pour exécuter des scripts WebSphere Application Server".
Cette commande est valide uniquement lorsqu'elle est utilisée avec des serveurs d'applications WebSphere Application Server de version 7 et ultérieures. Ne l'utilisez pas avec des versions antérieures.
print AdminTask.help('WMQAdminCommands')
print AdminTask.help('nom_commande')
AdminConfig.save()
Rôle
La commande modifyWMQActivationSpec permet de modifier une spécification d'activation du fournisseur de messagerie WebSphereMQ définie sur la portée où la commande a été lancée.
- qmgrName
- qmgrHostname
- qmgrPortNumber
- qmgrSrvconnChannel
- transportChain
- wmqTransportType
- ccdtUrl
- ccdtQmgrName
Objet cible
Spécification d'activation du fournisseur de messagerie WebSphere MQ sur une portée spécifique.
Paramètres requis
Les paramètres de cette commande sont identiques à ceux utilisés pour créer une spécification d'activation du fournisseur de messagerie WebSphere MQ.
Paramètres optionnels
Les paramètres de cette commande sont identiques à ceux utilisés pour créer une spécification d'activation du fournisseur de messagerie WebSphere MQ.
Indiquez le comportement de cette commande dans le paramètre -customProperties.
- -customProperties
- Ce paramètre indique les propriétés personnalisées à transmettre à l'implémentation de la spécification d'activation du fournisseur de messagerie WebSphere MQ. En règle générale, les propriétés personnalisées sont utilisées pour définir les attributs de la spécification d'activation qui ne sont pas directement pris en charge via les interfaces d'administration WebSphere.Chaque propriété personnalisée est définie à l'aide des paramètres d'étape du tableau des noms et des valeurs. Comme il s'agit d'étapes dans un tableau, l'ordre des deux paramètres est fixe. Vous devez donc toujours définir d'abord le nom, puis la valeur.
- Dans Jython : [nom valeur]
- Dans Jacl : {nom valeur}
Par exemple, -WAS_EndpointInitialState est une propriété personnalisée qui peut être utilisée avec le paramètre -customProperties. La valeur du paramètre -WAS_EndpointInitialState doit être ACTIF ou INACTIF. -WAS_EndpointInitialState détermine si le noeud final est activé lors de son enregistrement. Si le paramètre est défini sur ACTIF, 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.
Ce paramètre doit être ignoré pour une activation ou désactivation future via le MBean J2CMessageEndpoint.
L'ajout de nouvelles paires nom/valeur à l'ensemble des propriétés personnalisées existant se fait en suivant les règles suivantes :- Si l'ensemble des propriétés existant ne contient pas de propriété portant le même nom que celle fournie comme composant de la commande de modification, la propriété fournie est ajoutée à l'ensemble des propriétés personnalisées, à moins que la propriété personnalisée n'ait pas de valeur définie, quand elle est ignorée.
- Si l'ensemble des propriétés contient une propriété ayant le même nom que celle fournie comme composant d'une commande de modification et que cette dernière définit une valeur pour cette propriété, alors la valeur existante est remplacée par la valeur fournie.
- Si l'ensemble de propriétés contient une propriété ayant le même nom que celle fournie comme composant d'une commande de modification mais que la commande de modification ne définit pas de valeur pour cette propriété, alors la propriété de même nom est supprimée de l'ensemble de propriétés personnalisées.
Exemple
- Avec Jython :
wsadmin>AdminConfig.getid("/Node:9994GKCNode01") 9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) wsadmin>AdminTask.listWMQActivationSpecs("9994GKCNode01(cells/9994GKCNode01Cell/ nodes/9994GKCNode01|node.xml#Node_1)") spec1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# J2CActivationSpec_1098737234986) wsadmin>AdminTask.modifyWMQActivationSpec("spec1(cells/9994GKCNode01Cell/ nodes/9994GKCNode01|resources.xml#J2CActivationSpec_1098737234986)", ["-destinationJndiName jms/topics/t5 -destinationType javax.jms.Topic"]) spec1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# J2CActivationSpec_1098737234986)
- A l'aide de Jacl :
wsadmin>$AdminConfig getid /Node:9994GKCNode01 9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) wsadmin>$AdminTask listWMQActivationSpecs 9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) spec1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# J2CActivationSpec_1098737234986) wsadmin>$AdminTask modifyWMQActivationSpec spec1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# J2CActivationSpec_1098737234986) {-destinationJndiName jms/topics/t5 -destinationType javax.jms.Topic} spec1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# J2CActivationSpec_1098737234986)
- A l'aide de Jython, l'exemple suivant modifie une spécification d'activation en activant la propriété personnalisée WAS_EndpointInitialState :
wsadmin>AdminConfig.getid("/Node:myNode01") 'myNode01(cells/myCell01/nodes/myNode01|node.xml#Node_1)' wsadmin>wsadmin>AdminTask.listWMQActivationSpecs("myNode01(cells/myCell01/nodes/myNode01|node.xml#Node_1)") 'newas(cells/myCell01/nodes/myNode01|resources.xml#J2CActivationSpec_1298546034140)' wsadmin>AdminTask.modifyWMQActivationSpec("newas(cells/myCell01/nodes/myNode01|resources.xml #J2CActivationSpec_1298546034140)", '-customProperties [[WAS_EndpointInitialState ACTIVE]]')