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.

[IBM i]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.

Pour obtenir la liste des commandes d'administration de fournisseur de messagerie IBM MQ disponibles, ainsi qu'une brève description de chaque commande, entrez la commande suivante à l'invite wsadmin :

print AdminTask.help('WMQAdminCommands')

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é la commande, sauvegardez vos modifications dans la configuration maîtresse. Par exemple, utilisez la commande suivante :

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.

Remarque : Vous ne pouvez pas modifier le type d'une spécification d'activation. Par exemple, vous ne pouvez pas créer une spécification d'activation là où vous entrez manuellement les informations de configuration puis la modifier pour utiliser une table CCDT.
Pour une spécification d'activation basée sur une table CCDT , vous ne pouvez modifier aucun des paramètres suivants :
  • qmgrName
  • qmgrHostname
  • qmgrPortNumber
  • qmgrSrvconnChannel
  • transportChain
  • wmqTransportType
Pour une spécification d'activation générique, vous ne pouvez pas modifier l'un des paramètres suivants :
  • 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.

Remarque : Si le paramètre -qmgrHostname ou -qmgrPortNumber est spécifié sans le paramètre -connectionNameList, l'on part du principe qu'un nom de connexion ne doit plus être utilisé pour la connexion à WebSphere MQ et que le nom d'hôte et le numéro de port indiqués doivent être utilisés à la place. Par conséquent, aucune valeur n'est définie pour le paramètre -connectionNameList.

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]]')

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=rmj_wmq_jmsas_modify
Nom du fichier : rmj_wmq_jmsas_modify.html