Paramètres de spécification d'activation du fournisseur de messagerie IBM MQ

Utilisez ce panneau pour afficher ou modifier les propriétés de configuration de la spécification d'activation sélectionnée pour une utilisation avec le fournisseur de messagerie IBM MQ. Ces propriétés de configuration déterminent comment les connexions sont créées et associées à des sujets et files d'attente.

Pour afficher les paramètres de spécification d'activation IBM MQ, utilisez la console d'administration pour exécutez les opérations suivantes :
  1. Dans le panneau de navigation, cliquez sur Ressources > JMS->Spécifications d'activation pour afficher les spécifications d'activation existantes.
  2. Si nécessaire, attribuez au paramètre Portée le niveau auquel les spécifications d'activation sont définies dans le panneau de contenu. Ceci limite l'ensemble des spécifications d'activation affichées.
  3. Sélectionnez le nom de la spécification d'activation à utiliser.
Il existe cinq groupes de propriétés sous Propriétés générales :
Effectuez les modifications nécessaires aux propriétés des groupes Administration, Connexion, Destination, Avancées et Paramètres de sécurité, puis cliquez sur Appliquer pour enregistrer la configuration avant de cliquer sur les liens suivants dans le panneau de contenu sous Propriétés supplémentaires :
  • Propriétés avancées pour afficher ou modifier les propriétés avancées de votre spécification d'activation IBM MQ.
  • Propriétés avancées pour afficher ou modifier les propriétés du courtier de la spécification d'activation IBM MQ.
  • Propriétés personnalisées pour afficher ou modifier les propriétés personnalisées de votre spécification d'activation IBM MQ. Vous utilisez par exemple cette option pour définir la propriété personnalisée WAS_EndpointInitialState pour une spécification d'activation. WAS_EndpointInitialState détermine si la consommation des messages commence ou non à partir de la destination JMS dès que la spécification d'activation est utilisée pour un bean géré par message afin de se connecter à la destination.
  • Propriétés de transport du client pour afficher ou modifier les propriétés de transport du client de votre spécification d'activation IBM MQ. Si la spécification d'activation sélectionnée n'a pas été créée à l'aide d'une table de définition de canal du client (CCDT), suivez ce lien pour entrer toutes les informations nécessaires pour la connexion à IBM MQ. Si la spécification d'activation sélectionnée a été créée à l'aide d'une CCDT, vous n'avez pas besoin de fournir les propriétés de transport du client et le lien est donc absent.

Sous Articles liés, vous pouvez cliquer sur JAAS - Données d'authentification J2C pour configurer les informations d'authentification à utiliser avec la spécification d'activation.

Vous pouvez également spécifier la propriété -localAddress à l'aide de la commande d'administration IBM MQ createWMQActivationSpec.

Remarque : Lorsque vous spécifiez des propriétés IBM MQ, les limitations suivantes s'appliquent :
  • Les noms peuvent comporter jusqu'à 48 caractères, à l'exception des canaux, qui ne peuvent pas en comporter plus de 20.
  • Les valeurs de propriétés que vous spécifiez doivent correspondre à celles spécifiées lors de la configuration de IBM MQ pour les ressources JMS. Pour plus d'informations, reportez-vous aux sectionsUsing Java et System Administration dans le centre de documentation IBM MQ.

Si la fonctionnalité IBM MQ a été désactivée dans une portée qui affecte cette ressource du fournisseur de messagerie IBM MQ, un message d'information indiquant que IBM MQ a été désactivé s'affiche. En environnement monoserveur, ce message d'information ne s'affiche qu'au redémarrage du serveur après la désactivation de la fonctionnalité IBM MQ. Dans un environnement de déploiement réseau, le message d'information s'affiche immédiatement.

Une spécification d'activation IBM MQ possède les propriétés avancées suivantes :

Administration

Portée

Niveau auquel cette définition de ressource est visible des applications.

Des ressources telles que les fournisseurs de messagerie, les liaisons d'espace de noms et les bibliothèques partagées peuvent être définies à plusieurs niveaux. Dans ce cas, pour une ressource donnée, la définition figurant au niveau le plus spécifique (par exemple, le serveur) l'emporte sur l'éventuelle définition homologue figurant à un niveau plus général (par exemple, la cellule).

La portée affichée est à des fins d'information uniquement et n'est pas modifiable dans cet écran. Pour parcourir cette ressource (ou d'autres ressources) ou en modifier la portée, modifiez la portée dans le panneau de collection de spécification d'activation IBM MQ, puis cliquez sur Appliquer avant de cliquer sur le lien du type de ressource.

Information valeur
Type de donnée String (chaîne)

Fournisseur

Le fournisseur JMS affecté lorsque la spécification d'activation est créée.

Le fournisseur de toutes les spécifications d'activation créées à l'aide de ce panneau est le fournisseur de messagerie IBM MQ.

Le fournisseur s'affiche à titre d'information uniquement.

Information valeur
Type de donnée String (chaîne)

Chaîne

Nom sous lequel la spécification d'activation est connue dans WebSphere Application Server à des fins d'administration.

Information valeur
Type de donnée String (chaîne)
Intervalle Le nom doit être unique dans l'ensemble des spécifications d'activation définies pour la cellule.

Nom JNDI

Nom JNDI permettant d'associer la spécification d'activation dans l'espace nom JNDI.

Par convention, utilisez le nom JNDI complet, par exemple sous la forme jms/Nom, Nom correspondant au nom logique de la ressource.

Information valeur
Type de donnée String (chaîne)

Description

Description de cette spécification d'activation dans WebSphere Application Server à des fins d'administration.

Information valeur
Type de donnée String (chaîne)
Valeut par défaut Null

Connexion

Les informations requises pour configurer une connexion varient selon que la spécification d'activation sélectionnée a été créée ou non à l'aide d'une table de définition de canal du client (CCDT).

Si la spécification d'activation sélectionnée a été créée à l'aide d'une CCDT, seules les propriétés suivantes sont affichées :
  • URL de la table de définition de canal du client
  • Gestionnaire de files d'attente
  • Configuration SSL
Si la spécification d'activation sélectionnée n'a pas été créée à l'aide d'une CCDT, les propriétés suivantes sont affichées :
  • Gestionnaire de files d'attente
  • Transport
  • Si l'option Entrez les informations sur l'hôte et sur le port sous forme de valeurs de nom d'hôte et de port distinctes est sélectionnée, la propriété de la liste de noms de connexion ne peut pas être utilisée contrairement aux propriétés suivantes :
    • Nom d'hôte
    • port
  • Si vous sélectionnez Entrez les informations sur l'hôte et sur le port sous forme de liste de noms de connexion, la propriété de liste de noms de connexion peut être utilisée et les propriétés suivantes ne peuvent pas l'être :
    • Nom d'hôte
    • port
  • Canal de connexion serveur
  • Si vous avez désélectionné la case à cocher Utiliser SSL pour sécuriser des communications avec IBM MQ, les propriétés suivantes ne peuvent pas être utilisées :
    • Géré de façon centrale
    • Configuration spécifique
    • Configuration SSL

Pour plus d'informations sur la définition des propriétés SSL pour IBM MQ, voir SSL properties dans la sectionIBM MQ Using Java du centre de documentation IBM MQ.

Remarque : Quatre propriétés de connexion IBM MQ permettent de configurer l'adaptateur de ressources IBM MQ utilisé par le fournisseur de messagerie IBM MQ. Ces propriétés affectent le pool de connexions utilisé par les spécifications d'activation :
  • maxConnections
  • connectionConcurrency (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.)
  • reconnectionRetryCount
  • reconnectionRetryInterval
Pour plus d'informations sur ces quatre propriétés et sur leur configuration, voir Propriétés d'adaptateur de ressources.

URL de la table de définition de canal du client

URL qui définit l'emplacement d'une table CCDT IBM MQ.

Information valeur
Type de donnée String (chaîne)

Gestionnaire de files d'attente

Si la spécification d'activation se base sur CCDT, cette propriété est utilisée pour sélectionner une entrée dans CCDT. Sinon, il s'agit du nom du gestionnaire de files d'attente ou du groupe de partage de files d'attente auquel vous vous connectez. Une connexion est établie à la ressourceIBM MQ définie devant recevoir les messages.

Information valeur
Type de donnée String (chaîne)
Intervalle Si cette spécification d'activation ne se base pas sur CCDT, la valeur doit être un nom de gestionnaire de files d'attente valide.
Si cette spécification d'activation se base sur CCDT, la valeur doit être l'une des valeurs suivantes :
  • un nom de gestionnaire de files d'attente valide,
  • Astérisque (*) suivi du groupe de gestionnaires de files d'attente1
  • Astérisque (*),
  • Vide 1
1Lorsque vous définissez la valeur de la propriété Gestionnaire de file d'attente de cette manière en combinaison avec une CCDT, des connexions individuelles établies en utilisant la spécification d'activation peuvent être établies à des gestionnaires de files d'attente différents. Plusieurs gestionnaires de files d'attente sont sélectionnés lorsque la table CCDT contient plusieurs définitions de canaux de connexion client avec un paramètre de nom de gestionnaire de files d'attente (QMNAME) correspondant et que ces définitions définissent les informations de connexion réseau de différents gestionnaires de files d'attente.
Si la fabrique de connexions repose sur une table CCDTI et que la table peut choisir entre plusieurs gestionnaires de files d'attente, vous ne pouvez pas récupérer les transactions globales. Par conséquent, pour les fabriques de connexion qui définissent une table CCDT, vous avez deux possibilités :
  • Eviter toute ambiguïté sur le gestionnaire de files d'attente cible lors de la définition de la propriété Gestionnaire de files d'attente, ce qui implique que la valeur définie de cette propriété ne doit pas contenir d'astérisque (*).
  • Eviter d'utiliser les ressources avec les applications qui s'enregistrent dans les transactions globales.

Transport

Type de transport IBM MQ de la connexion. Le type de transport permet d'indiquer le mécanisme précis utilisé pour se connecter à IBM MQ.

Information valeur
Type de donnée Liste déroulante
Valeut par défaut Liaisons, puis client
Intervalle
Client
Utilisez une connexion réseau TCP/IP pour communiquer avec le gestionnaire de files d'attente IBM MQ.
Liaisons, puis client
Tentez d'établir une connexion en mode liaisons au gestionnaire de files d'attente. Si ce n'est pas possible, repassez en mode de transport du client.
Liaisons
Etablit une connexion transmémoire à un gestionnaire de files d'attente en cours d'exécution sur le même noeud. Les propriétés suivantes du mode de transport du client sont désactivées :
  • Nom d'hôte
  • port
  • Liste des noms de connexion
  • Canal de connexion serveur
Pour plus d'informations sur la configuration d'un type de transport Liaisons, puis client ou Liaisons, voir Configuration du fournisseur de messagerie IBM MQ avec des informations de bibliothèques natives.

Entrez les informations d'hôte et de port sous forme de valeurs de nom d'hôte et de port distinctes.

Si vous sélectionnez ce bouton d'option, vous indiquez que la connexion au gestionnaire de files d'attente IBM MQ est établie en utilisant les informations fournies par les propriétés de nom d'hôte et de port.

La sélection de cette option active les propriétés de nom d'hôte et de port et désactive la propriété de liste de noms de connexion. Pour entrer les informations d'une liste de nom de connexion, cliquez sur Entrez les informations sur l'hôte et sur le port sous forme de liste de noms de connexion.

Ce bouton radio est disponible uniquement si la propriété de portée définit une cellule ou un cluster ou bien un noeud ou un serveur exécutant WebSphere Application Server Version 8.0 ou ultérieure.

Information valeur
Type de donnée Bouton radio

Nom d'hôte

Nom d'hôte, adresse IPv4 ou IPv6 du gestionnaire de files d'attente IBM MQ auquel la connexion doit être établie.

Information valeur
Type de donnée String (chaîne)

port

Numéro du port qu'écoute IBM MQ.

Information valeur
Type de donnée Entierr
Valeut par défaut 1414
Intervalle La valeur doit être comprise entre 1 et 65536 (inclus).

Entrez les informations sur l'hôte et sur le port sous forme de liste de noms de connexion

Si vous sélectionnez ce bouton d'option, vous indiquez que la connexion au gestionnaire de files d'attente IBM MQ est établie en utilisant les informations fournies par la propriété de liste de noms de connexion.

Vous pouvez utiliser des listes de noms de connexion pour établir une connexion à un seul gestionnaire de files d'attente ou à un gestionnaire de files d'attente multi-instance. Pour plus d'informations sur l'utilisation d'un gestionnaire de files d'attente multi-instance, voir le centre de documentation de IBM MQ. La sélection de cette option active la propriété de liste de noms de connexion et désactive les propriétés de nom d'hôte et de port. Pour entrer des informations de nom d'hôte et de port distinctes, cliquez sur Entrez les informations sur l'hôte et sur le port sous forme de valeurs de nom d'hôte et de port distinctes.

Ce bouton radio est disponible uniquement si la propriété de portée définit une cellule ou un cluster ou bien un noeud ou un serveur exécutant WebSphere Application Server Version 8.0 ou ultérieure.

Information valeur
Type de donnée Bouton radio

Liste de noms de connexion

Liste de noms de connexion qui définit les informations de nom d'hôte et de port à utiliser lorsque vous voulez que la spécification d'activation se connecte à un gestionnaire de files d'attente multi-instance.

Utilisez cette propriété uniquement pour autoriser la connexion à un gestionnaire de files d'attente multi-instance. Ne l'utilisez pas pour autoriser des connexions à des gestionnaires de files d'attente à instance unique afin de ne pas générer des problèmes d'intégrité des transactions.

Information valeur
Type de donnée String (chaîne)
Valeut par défaut Non définie
Intervalle Cette zone doit se présenter sous la forme d'une chaîne au format suivant :

hôte[(port)][,hôte(port)]

Les informations de port sont facultatives. Si vous n'en définissez pas, la valeur par défaut est 1414.

La variable hôte doit correspondre à un nom d'hôte TCP/IP ou à une adresse IPv4 ou IPv6 valide.

port doit être un entier compris entre 1 et 65536 (inclus).

Par exemple : localhost(1234),remotehost1(1234),remotehost2

Si vous définissez la propriété de liste de noms de connexion, les propriétés de nom d'hôte et de port sont définies automatiquement dans le nom d'hôte ou le numéro de port de la première entrée de la liste de noms de connexion. Par conséquent, si vous définissez localhost(1234),remotehost1(1234),remotehost2, le nom d'hôte doit correspondre à localhost et le port à 1234.

Cette propriété est disponible uniquement si la propriété de portée définit une cellule ou un cluster ou bien un noeud ou un serveur exécutant WebSphere Application Server Version 8.0 ou ultérieure.

Lorsque vous les utilisez dans un environnement de cellule mixte, les informations dans la propriété de liste de noms de connexion, pour les spécifications d'activation de portée de cellule ou de cluster, sont disponibles sur les noeuds WebSphere Application Server Version 7.0. Le comportement exact dépend du niveau du module de correctifs du noeud :
  • Pour les noeuds fonctionnant au niveau de module de correctifs WebSphere Application Server Version 7.0 7 ou suivant, la propriété de liste de noms de connexion peut être utilisée se connecter à des gestionnaires de files d'attente multi-instances.
  • Pour les noeuds fonctionnant à un niveau de module de correctifs antérieur àVersion 7.0, la propriété de liste de noms de connexion n'est pas reconnue et un message d'avertissement au message suivant est généré :
    [29/09/10 12:15:27:468 BST] 00000018 J2CUtilityCla W   J2CA0008W: Class com.ibm.mq.connector.inbound.ActivationSpecImpl used by resource cells/L3A3316Node01Cell/resources.xml#J2CResourceAdapter_1284547647859 did not contain method setConnectionNameList. Processing continued.
    Dans ce cas, les informations dans les propriétés de nom d'hôte et de port sont utilisées pour se connecter à un gestionnaire de files d'attente.

Canal de connexion serveur

Nom de canal de connexion serveur IBM MQ utilisé pour se connecter à IBM MQ.

Information valeur
Type de donnée String (chaîne)
Valeut par défaut SYSTEM.DEF.SVRCONN
Intervalle Cette valeur doit correspondre à un canal de connexion serveur défini dans le gestionnaire de files d'attente IBM MQ auquel la connexion doit être établi.

Utiliser SSL pour sécuriser les communications avec IBM MQ

Cette option détermine si le protocole SSL (Secure Sockets Layer) est utilisé pour sécuriser les communications réseau avec le gestionnaire de files d'attente ou le groupe de partage de files d'attente IBM MQ.

Lorsque vous utilisez une spécification d'activation du fournisseur de messagerie IBM MQ dans l'environnement du serveur d'applications, le serveur d'applications gère la configuration SSL. Pour modifier les paramètres de configuration de la couche Secure Sockets Layer, utilisez la console d'administration pour accéder à l'écran Sécurité > Certificat SSL et gestion des clés.

Dans la configuration SSL, vous pouvez uniquement utiliser un algorithme de cryptographie pour une spécification d'activation du fournisseur de IBM MQ. Si vous indiquez plus d'un algorithme de cryptographie, seul le premier est utilisé.

Information valeur
Type de donnée Case à cocher. Si cette case n'est pas cochée, les propriétés SSL suivantes sont désactivées :
  • Géré de façon centrale
  • Configuration spécifique
  • Configuration SSL

Géré de façon centrale

Lorsque le protocole SSL est utilisé pour communiquer avec IBM MQ, sélectionnez ce bouton d'option pour indiquer que la configuration SSL provient de la configuration SSL WebSphere Application Server gérée de façon centralisée.

Lorsque vous sélectionnez ce bouton d'option, les attributs de nom d'hôte et de port de la spécification d'activation du fournisseur de messagerie IBM MQ servent à sélectionner une configuration SSL appropriée. Si les informations d'hôte et de port sont fournies à la spécification d'activation par une liste de noms de connexion, cela implique que les informations de nom d'hôte et de port du premier élément dans la liste sont utilisées pour sélectionner une configuration SSL appropriée. Pour fournir la configuration SSL qui sera mise en correspondance avec la spécification d'activation, reportez-vous à la rubrique relative aux paramètres de configuration SSL des noeuds finaux sortants dynamiques répertoriée sous la référence associée.

Information valeur
Type de donnée Bouton radio

Configuration spécifique

Sélectionnez ce bouton d'option lorsque vous souhaitez spécifier une configuration SSL particulière à utiliser lorsque le protocole SSL sert à sécuriser les communications de réseau avec le gestionnaire de files d'attente ou le groupe de partage de file d'attente IBM MQ.

Information valeur
Type de donnée Bouton radio

Configuration SSL

Configuration SSL à utiliser lorsque SSL est utilisé pour sécuriser les communications réseau avec le gestionnaire de files d'attente ou le groupe de partage de file d'attente IBM MQ.

Cette propriété est désactivée si le bouton d'option Géré de façon centrale est sélectionné et la ressource du fournisseur de messagerie IBM MQa été définie de manière explicite.

Cette propriété est toujours activée si la ressource du fournisseur de messagerie IBM MQ est basée sur une table CCDT.

Si cette ressource du fournisseur de messagerie IBM MQ repose sur une table CCDT, ce paramètre est uniquement utilisé si les entrées correspondantes de la table CCDT ont été configurées pour utiliser SSL.

De plus, si une configuration SSL none est sélectionnée, la configuration SSL WebSphere Application Server gérée de manière centrale par défaut pour le fournisseur de messagerie IBM MQ est utilisée.

Information valeur
Type de donnée Liste déroulante

Destination

Remarque : La propriété WAS_EndpointInitialState est une propriété personnalisées. Cette propriétés détermine si la consommation des messages commence à partir de la destination JSM dès que la spécification d'activation est utilisée pour un bean géré par message pour se connecter avec la destination. Pour définir des propriétés personnalisées, après avoir effectué les modifications dans ce panneau de contenu et cliqué sur Appliquer pour enregistrer la configuration, cliquez sur le lien Propriétés personnalisées dans le panneau de contenu sous Propriétés supplémentaires.

Nom JNDI de destination

Nom JNDI de la destination JMS à partir de laquelle les messages sont distribués à un bean de gestion des messages configuré pour utiliser cette spécification d'activation.

Informations Value
Type de données String (chaîne)

Sélecteur de messages

Expression de sélection de message indiquant les messages à distribuer.

Informations Value
Type de données String (chaîne)

Type de destination

Type de destination (file d'attente ou rubrique) à partir de laquelle les messages sont consommés.

Informations Value
Type de données Liste déroulante
Plage
File d'attente
Le nom de la destination JNDI se réfère à une destination JMS qui est une file d'attente.
Rubrique
Le nom de la destination JNDI se réfère à une destination JMS qui est une rubrique.

Abonnement Durable

Option spécifiant si un abonnement durable ou non durable est utilisé pour remettre des messages à un bean géré par message abonné à ce sujet.

Informations Value
Type de données Case à cocher
Valeur par défaut Décochée (non durable)
Plage
Désélectionné
Non durable.
Sélectionnés
Durable.

Nom de l'abonnement

Nom d'un abonnement durable. Ce paramètre est disponible uniquement lorsque la case Abonnement durable est cochée.

Informations Value
Type de données String (chaîne)

Avancé

ID client

Identificateur client à indiquer lors de la connexion au fournisseur de messagerie IBM MQ.

Informations Value
Type de données String (chaîne)

Autoriser des abonnements durables clonés

Option déterminant si plusieurs serveurs peuvent accéder simultanément à plusieurs instances d'un abonnement durable.

Informations Value
Type de données Case à cocher
Valeur par défaut Désélectionné
Plage
Sélectionnés
Plusieurs serveurs peuvent accéder en même temps à plusieurs instances d'un abonnement durable.
Désélectionné
Plusieurs serveurs ne peuvent pas accéder simultanément à plusieurs instances d'un abonnement durable.

Version du fournisseur

Version du fournisseur de messagerie IBM MQ. Cette option est utilisée pour déterminer s'il faut se connecter à une version particulière du gestionnaire de connexions. Elle permet également de déterminer le type de fonctionnalité requis par le client.

Informations Value
Type de données String (chaîne)
Plage La valeur entrée doit être soit la chaîne vide, soit avoir l'un des formats suivants :
  • n.n.n.n
  • n.n.n
  • n.n
  • n
où n est une valeur numérique supérieure ou égale à 0.

Par exemple, 6.0.0.0.

Paramètres de sécurité

Alias d'authentification

Nom d'utilisateur et mot de passe à utiliser pour se connecter à IBM MQ.

Informations Value
Type de données Liste déroulante
Valeur par défaut (Aucune)
Plage Tous les alias d'authentification définis dans la cellule et la valeur "(none)" qui spécifie qu'aucun justificatif n'est envoyé à IBM MQ.

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