Configuration du fournisseur de messagerie IBM MQ avec des informations de bibliothèques natives

Pour se connecter à un gestionnaire de files d'attente ou à un groupe de partage de files d'attente IBM MQ en mode liaison, le fournisseur de messagerie IBM MQ doit savoir d'où il peut charger des bibliothèque natives. Ces informations sont qualifiées d'informations sur le chemin natif. La définition de ces informations sur le chemin natif dépend de la manière avec laquelle la connexion est établie dans un client d'application ou dans un environnement de serveurs d'applications.

Pourquoi et quand exécuter cette tâche

En cas d'exécution en cours dans un environnement client, utilisez la commande launchClient pour démarrer une application client. Dans les propriétés du système MQ_INSTALL_ROOT, entrez le nom d'un répertoire contenant les bibliothèques natives de IBM MQ, dans un sous-répertoire de java/lib ou java/lib64 selon que vous utilisez des bibliothèques natives de 32 bits ou de 64 bits. Par exemple, sur Linux spécifiez ./launchClient.sh myappclient.ear -CCDMQ_INSTALL_ROOT=/opt/mqm/.

En cas d'exécution dans un environnement de serveurs d'applications, vous pouvez configurer le fournisseur de messagerie IBM MQ avec des informations sur le chemin natif en utilisant la ligne de commande comme décrit dans Groupe de commandes WMQAdminCommands pour l'objet AdminTask ou bien vous pouvez utiliser la console d'administration et procéder comme suit :

[AIX]Remarque : Si votre serveur d'applications est en 64 bits, vous devez exécuter la commande de contrôle dltmqlnk IBM MQ en tant que racine avant que les applications puissent se connecter au gestionnaire de files d'attente à l'aide du type de transport BINDINGS. La commande doit être réexécutée chaque fois qu'un groupe de correctifs IBM MQ est installé. Pour plus d'informations, consultez "Implications d'un gestionnaire de files d'attente 64 bits" dans la section Guide d'initiation pour AIX du centre de documentation IBM MQ.

Procédure

  1. Dans le panneau de navigation, développez Ressources > JMS > Fournisseurs JMS.
  2. Sélectionnez le fournisseur de messagerie IBM MQ qui se trouve à la Portée adéquate pour la création d'une connexion en mode liaison par l'intermédiaire de la fabrique de connexions ou de la spécification d'activation.
    Remarque :
    • Les informations sur le chemin natif à la portée de Cluster sont utilisées de manière préférentielle par rapport à celles à portée de Noeud et de Cellule.
    • Les informations de chemin natif à portée de Noeud sont utilisées de manière préférentielle par rapport à celles à portée de Cellule.
    [z/OS]Remarque : Lors de l'utilisation des spécifications d'activation ou des fabriques de connexions du fournisseur de messagerie IBM MQ qui créent des connexions en mode liaison avec un gestionnaire de files d'attente IBM MQ pour z/OS, assurez-vous que la valeur du paramètre IDBACK est assez élevée. Sinon, une exception MQExceptions avec un code achèvement 2 et un code motif 2025 (MQRC_MAX_CONNS_LIMIT_REACHED) peut se produire. Pour savoir comment définir le paramètre IDBACK, reportez-vous à la description de la macro CSQ6SYSP dans le centre de documentation IBM MQ.
  3. Sous Propriétés générales, dans les propriétés du Chemin chemin d'accès à la bibliothèque native, entrez le nom complet du répertoire contenant les bibliothèques natives de IBM MQ. Par exemple, dans Linux entrez /opt/mqm/java/lib. Entrez un seul nom de répertoire.
  4. Cliquez sur OK.
  5. Sauvegardez les modifications apportées à la configuration principale.
  6. En cas d'exécution dans un environnement de serveur d'applications, vous devez redémarrer deux fois tous les serveurs affectés par le changement de données du chemin natif. Si vous ne redémarrez pas deux fois tous les serveurs affectés, un message WMSG1623E est généré, indiquant que le fournisseur de messagerie IBM MQ n'est pas disponible.

    En cas d'exécution dans un environnement client, vous devez réexécuter deux fois le programme client. Sinon, un message WMSG2013E se produit.

    Quelque soit l'environnement d'exécution, jusqu'à ce que vous ayez effectué ces redémarrages, toute tentative pour utiliser une ressource de fournisseur de messagerie IBM MQ (par exemple, une fabrique de connexions) à partir de ces serveurs affectés provoque une exception javax.naming.NamingException et un message WMSG2003E.

Que faire ensuite

Remarque : Pour des raisons de migration uniquement, vous pouvez également indiquer des informations de chemin natif en définissant la variable d'environnement MQ_INSTALL_ROOT de WebSphere Application Server, si vous vous trouvez dans un environnement de serveur d'applications. Pour plus d'informations, consultez la rubrique suivante du centre de documentation de WebSphere Application Server version 6.1 : Installation de IBM MQ pour interopérer avec WebSphere Application Server (version 6.1).

Icône indiquant le type de rubrique Rubrique de tâche



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