Commande migrateWMQMLP

La commande migrateWMQMLP permet de migrer une définition de port d'écoute des messages IBM MQ vers une définition de spécification d'activation.

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 migrateWMQMLP permet de migrer une définition de port d'écoute des messages IBM MQ vers une définition de spécification d'activation. Après la création de la spécification d'activation, vous pouvez supprimer le port d'écoute.

Notez que le paramètre de port d'écoute Nombre maximal de tentatives n'est pas migré vers la nouvelle spécification d'activation, car il n'existe pas d'équivalent exact.

Lorsque vous migrez un port d'écoute associé à un bean géré par message (MDB) ayant la propriété de configuration d'activation subscriptionDurability paramétrée sur Durable et que MDB possède déjà un abonnement durable actif, l'abonnement durable n'est pas migré. Ceci est dû au fait que les ports d'écoute et les spécifications d'activation IBM MQ utilisent des formes incompatibles de nom d'abonnement. Par conséquent, il peut y avoir deux abonnements durables actifs enregistrés dans la rubrique associée pour le même MDB. Au cours du processus de migration, vous devez supprimer l'ancien abonnement durable associé au port d'écoute et nettoyer manuellement les messages associés. Pour plus d'informations sur la façon de procéder, voir la documentation de IBM MQ et IBM Integration Bus.

Objet cible

Port d'écoute des messages à faire migrer.

Paramètres requis

-asName
Nom de la spécification d'activation à créer.
-asJNDIName
Nom JNDI de la spécification d'activation à créer.
-asScope
Type de portée sur laquelle créer la spécification d'activation (serveur, noeud, cluster ou cellule). Attention, l'option cluster n'est prise en charge que si le serveur qui contient le port d'écoute des messages fait partie d'un cluster. Si elle n'est pas définie, l'option par défaut est serveur. Les portées indiquées dépendent du port d'écoute des messages, ainsi, noeud est le noeud du serveur qui contient le port d'écoute des messages.

Paramètres optionnels

Aucun.
L'exemple suivant montre comment faire migrer un port d'écoute des messages vers une spécification d'activation.
  • Avec Jython :
    wsadmin>AdminConfig.list("ListenerPort")
    lp1(cells/L3A3316Node09Cell/nodes/L3A3316Node10/servers/server1|
    server.xml#ListenerPort_1211265363796)
    
    wsadmin>AdminTask.migrateWMQMLP("lp1(cells/L3A3316Node09Cell/nodes/
    L3A3316Node10/servers/server1|server.xml#ListenerPort_1211265363796)",
     ["-asName migratedFromLP -asJNDIName jms/as1 -asScope node"])
    migratedFromLP(cells/L3A3316Node09Cell/nodes/L3A3316Node10|
    resources.xml#J2CActivationSpec_1211265679078)
  • A l'aide de Jacl :
    wsadmin>$AdminConfig list ListenerPort
    lp1(cells/L3A3316Node09Cell/nodes/L3A3316Node10/servers/server1|
    server.xml#ListenerPort_1211265363796)
    
    wsadmin>$AdminTask migrateWMQMLP 
    lp1(cells/L3A3316Node09Cell/nodes/L3A3316Node10/servers/server1|
    server.xml#ListenerPort_1211265363796) 
    {-asName migratedFromLP -asJNDIName jms/as1 -asScope node}
    migratedFromLP(cells/L3A3316Node09Cell/nodes/L3A3316Node10|
    resources.xml#J2CActivationSpec_1211265679078)

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_jmswmqmlp_migrate
Nom du fichier : rmj_wmq_jmswmqmlp_migrate.html