Au fur et à mesure de l'évolution de votre environnement métier, il peut être
utile de modifier les destinations
WebSphere
MQ utilisées par un module SCA (Service Component Architecture).
Avant de commencer
Vous devez savoir quels modules SCA utilisent les destinations JMS WebSphere MQ
que vous modifiez. Par défaut, ces destinations sont créées lorsque vous
installez un module SCA dans un serveur ou cluster. Les destinations sont de la forme :
- Pour une exportation unidirectionnelle :
- nommodule.nomexportation_MQEXPORT_CF
- nommodule.nomexportation_MQ_RECEIVE_D
- En outre, pour une exportation bidirectionnelle :
- nommodule.nomexportation_MQ_SEND_D
- Pour une importation unidirectionnelle :
- nommodule.nomimportation_MQIMPORT_CF
- nommodule.nomimportation_MQ_SEND_D
- En outre, pour une importation bidirectionnelle :
- nommodule.nomimportation_MQ_RECEIVE_D
Cette tâche suppose que vous utilisiez la console d'administration pour modifier la
configuration.
Restrictions : Lorsque vous modifiez les
destinations, tenez compte des éléments suivants :
- Vous devez configurer des destinations de files d'attente en attribuant la valeur MQ au client cible.
- Vous devez utiliser une connexion client TCP/IP pour vous connecter à WebSphere MQ. Pour plus de détails, voir "WebSphere MQ Intercommunication".
- Vous ne pouvez pas utiliser la compression de canal.
- Vous devez définir les exits de canal nécessaires pour une gestion correcte des données. Pour ce faire, cliquez sur puis définissez les propriétés personnalisées suivantes :
- SENDEXIT doit avoir la valeur com.ibm.ws.sca.internal.mq.exit.MQInternalSendExitImpl.
- RECEXIT doit avoir la valeur com.ibm.ws.sca.internal.mq.exit.MQInternalReceiveExitImpl.
- Facultatif : SENDEXITINIT doit être une chaîne de texte de votre choix. Définir cette propriété vous permet d'identifier l'exit dans une trace.
- Facultatif : RECEXITINIT doit être une chaîne
de texte de votre choix. Définir cette propriété vous permet d'identifier l'exit dans une trace.
- Vous ne pouvez pas utiliser les mêmes fabriques de connexions pour les liaisons
WebSphere MQ et
Java™
Message Service (JMS) MQ car les exits vont bloquer les liaisons JMS MQ.
Pourquoi et quand exécuter cette tâche
Après le déploiement des modules SCA, vous devrez peut être modifier les
destinations JMS WebSphere MQ pour répondre à de nouveaux besoins métier.
Procédure
- Arrêtez toutes les applications qui empruntent les destinations que vous modifiez. Suivez les étapes décrites à la section "Administration des
applications d'entreprise".
- Permettez à la destination d'achever le traitement des messages en cours.
- Affichez les destinations JMS WebSphere MQ. Accédez à cette page de la console d'administration en sélectionnant Ressources > Fournisseurs JMS> WebSphere MQ > Destinations de file d'attente WebSphere MQ
- Sélectionnez la portée des destinations que vous modifiez.
Si les modules SCA contenant les destinations sont installés sur des serveurs uniques, sélectionnez Portée serveur.
Si les modules SCA contenant les destinations sont installés sur des clusters, sélectionnez Portée cluster.
- Sélectionnez la destination à modifier dans la liste.
- Dans la page suivante, complétez les zones par les nouvelles valeurs.
- Répétez les étapes 5 et 6 pour chaque destination que vous modifiez.
- Sauvegardez les modifications de la configuration.
Que faire ensuite
Redémarrez les applications que vous aviez arrêtées à l'étape
1.