Commande manageWMQ

La commande manageWMQ permet de gérer les paramètres de l'adaptateur de ressources IBM MQ qui est installé dans une portée particulière.

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 manageWMQ permet de gérer les paramètres de l'adaptateur de ressources IBM MQ qui est installé dans une portée particulière.

La commande manageWMQ permet de gérer le chemin de la bibliothèque native et d'interroger les métadonnées de l'adaptateur de ressources IBM MQ spécifié.

Objet cible

A IBM MQ resource adapter.

Paramètres requis

Aucun.

Paramètres facultatifs

-nativePath
Ce paramètre indique le chemin des bibliothèques natives du fournisseur de messagerie IBM MQ utilisées par l'adaptateur de ressources IBM MQ pour établir une connexion en mode liaison avec le gestionnaire de files d'attente. Ce paramètre peut être spécifié sur un adaptateur de ressources IBM MQ situé à n'importe quelle portée.
-query
Ce paramètre fournit des informations sur le niveau d'adaptateur de ressources IBM MQ utilisé par le fournisseur de messagerie IBM MQ. Ce paramètre peut être spécifié sur un adaptateur de ressources IBM MQ situé à n'importe quelle portée.
[z/OS]-enableInbound
[z/OS]Ce paramètre autorise la distribution des messages entrants de Java™ Platform, Enterprise Edition (Java EE) Connector Architecture (JCA) aux spécifications d'activation de l'adaptateur de ressources de IBM MQ sur la plateforme z/OS. Cette valeur ne peut être définie que si l'adaptateur de ressources IBM MQ cible est sur la portée du serveur. Le redémarrage du serveur d'applications est nécessaire pour que ces modifications puissent prendre effet.

La valeur de ce paramètre doit être true ou false.

La valeur par défaut est false.

-disableWMQ
Ce paramètre précise s'il faut ou non désactiver la fonctionnalité IBM MQ à la portée de l'adaptateur de ressources spécifié ainsi qu'à toutes les portées suivantes.

La valeur de ce paramètre doit être true ou false.

La valeur par défaut est false.

Dans un environnement monoserveur, ce paramètre n'est valide qu'à la portée de niveau serveur. Dans un environnement de déploiement réseau, ce paramètre est valide dans toutes les portées. Lorsque vous le réglez à true, l'effet produit dépend de la portée à laquelle le réglage est appliqué :

  • Pour un adaptateur de ressources IBM MQ dont la portée est la cellule entière, les fonctionnalités IBM MQ sont désactivées sur tous les serveurs d'applications de la cellule.
  • Pour un adaptateur de ressources IBM MQ dont la portée est un noeud particulier, les fonctionnalités IBM MQ sont désactivées sur tous les serveurs d'applications faisant partie du noeud.
  • Pour un adaptateur de ressources IBM MQ dont la portée est un cluster, les fonctionnalités IBM MQ sont désactivées sur tous les serveurs d'applications membres de ce cluster.
  • Pour un adaptateur de ressources IBM MQ dont la portée est un serveur particulier, les fonctionnalités IBM MQ sont désactivées dans ce serveur d'applications.

Dans tous les cas, tous les processus affectés doivent être redémarrés pour que les changements prennent effet.

La valeur du paramètre définie à une portée donnée prime sur celle qui est définie à une portée plus basse. Par exemple, si vous réglez le paramètre à false dans la portée d'un serveur particulier, mais que ce même paramètre est réglé à true pour un fournisseur de messagerie IBM MQ dont la portée est la cellule entière, c'est ce dernier réglage qui est pris en compte et, par conséquent, les fonctionnalités IBM MQ dont désactivées dans tous les serveurs d'applications de la cellule, quelle que soit la valeur du paramètre à la portée du serveur.

-maxConnections
Ce paramètre indique le nombre maximum de connexions disponibles vers un gestionnaire de files d'attente IBM MQ.

La valeur par défaut est 10.

Pour plus d'informations, voir Configuration of the ResourceAdapter object dans le centre de documentation IBM MQ.

-connectionConcurrency
Ce paramètre indique le nombre maximum de beans gérés par message pouvant être fournis par chaque connexion.

La valeur par défaut est 1.

La définition de cette propriété a des conséquences uniquement sur les noeuds WebSphere Application Server 7. La propriété ne modifie en rien les noeuds de WebSphere Application Server Version 8 ou version ultérieure.

Pour plus d'informations, voir Configuration of the ResourceAdapter object dans le centre de documentation IBM MQ.

-reconnectionRetryCount
Ce paramètre indique le nombre maximum de tentatives effectuées par une spécification d'activation de fournisseur de messagerie IBM MQ pour rétablir la connexion à un gestionnaire de files d'attente IBM MQ en cas d'échec.

La valeur par défaut est 5.

Pour plus d'informations, voir Configuration of the ResourceAdapter object dans le centre de documentation IBM MQ.

-reconnectionRetryInterval
Ce paramètre indique le délai d'attente, exprimé en millisecondes, observé par une spécification d'activation de fournisseur de messagerie IBM MQ, pour tenter de se reconnecter à un gestionnaire de files d'attente IBM MQ.

La valeur par défaut est 300000.

Pour plus d'informations, voir Configuration of the ResourceAdapter object dans le centre de documentation IBM MQ.

-customProperties
Ce paramètre indique les propriétés personnalisées à transmettre à l'adaptateur de ressources IBM MQ. En règle générale, les propriétés personnalisées sont utilisées pour définir les attributs de l'adaptateur de ressources IBM MQ qui ne sont pas directement pris en charge à l'aide d'interfaces d'administration WebSphere Application Server.
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, 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, elle est alors 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.

Exemples

L'exemple suivant montre comment activer la livraison des messages JCA entrants sur la plateforme z/OS.
  • En langage Jython :
    wsadmin>AdminTask.manageWMQ("IBM MQ Resource Adapter
    (cells/L3A3316Node04Cell/nodes/L3A3316Node05/servers/server1|resources.xml#
    J2CResourceAdapter_1201601803796)", ["-enableInbound true"])
  • A l'aide de Jacl :
    wsadmin>$AdminTask manageWMQ "IBM MQ Resource Adapter
    (cells/L3A3316Node04Cell/nodes/L3A3316Node05/servers/server1|resources.xml#
    J2CResourceAdapter_1201601803796)" {-enableInbound true}
L'exemple suivant définit la valeur de -maxConnections sur 100 et ajoute une propriété personnalisée dont le nom est name1 et la valeur est value1.
  • En langage Jython :
    AdminTask.manageWMQ("IBM MQ Resource Adapter(
    cells/L3A3316Node01Cell|resources.xml#J2CResourceAdapter_1284547647859)", 
    ["-maxConnections 100 -customProperties [[name1 value1]]"])
  • A l'aide de Jacl :
    wsadmin>$AdminTask manageWMQ "IBM MQ Resource Adapter(
    cells/L3A3316Node01Cell|resources.xml#J2CResourceAdapter_1284547647859)" 
    {-maxConnections 100 -customProperties {{name1 value1}}}

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_jmswmq_manage
Nom du fichier : rmj_wmq_jmswmq_manage.html