Commande modifyWMQConnectionFactory

La commande modifyWMQConnectionFactory permet de modifier certains paramètres d'une fabrique de connexions 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 modifyWMQConnectionFactory permet de modifier une fabrique de connexions du fournisseur de messagerie WebSphere MQ définie sur la portée à partir de laquelle la commande a été lancée.

Remarque : Lorsque vous modifiez une fabrique de connexions du fournisseur de messagerie WebSphere MQ, une interaction se produit entre les paramètres mappingAlias et containerAuthAlias. Cette interaction apparaît si le paramètre containerAuthAlias est indiqué sans le paramètre mappingAlias. Dans ce cas, le paramètre mappingAlias est automatiquement associé à la valeur DefaultPrincipleMapping.

Objet cible

Fabrique de connexions du fournisseur de messagerie WebSphere MQ sur la portée indiquée.

Paramètres requis

Les paramètres de cette commande sont identiques à ceux utilisés pour créer une fabrique de connexions du fournisseur de messagerie WebSphere MQ.

Paramètres optionnels

Les paramètres de cette commande sont identiques à ceux utilisés pour créer une fabrique de connexions 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 des fabriques de connexions 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 des fabriques de connexions 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}
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 des 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 des propriétés personnalisées.

Exemple

  • Avec Jython :
    wsadmin>AdminConfig.getid("/Node:9994GKCNode01") 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)  
    
    wsadmin>AdminTask.listWMQConnectionFactories("9994GKCNode01(cells/
    9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)") 
    cf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    MQConnectionFactory_1098737234986)  
    
    wsadmin>AdminTask.modifyWMQConnectionFactory("cf1(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|resources.xml#MQConnectionFactory_1098737234986)", ["-description
     'My new description'"])  
    cf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    MQConnectionFactory_1098737234986)
  • A l'aide de Jacl :
    wsadmin>$AdminConfig getid /Node:9994GKCNode01 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)  
    
    wsadmin>$AdminTask listWMQConnectionFactories 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) 
    cf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    MQConnectionFactory_1098737234986)  
    
    wsadmin>$AdminTask modifyWMQConnectionFactory 
    cf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    MQConnectionFactory_1098737234986) {-description "My new description"}  
    cf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    MQConnectionFactory_1098737234986)

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_jmscf_modify
Nom du fichier : rmj_wmq_jmscf_modify.html