Les connecteurs ont deux types de propriétés de configuration, décrits dans les sections suivantes :
Vous devez définir les valeurs de ces propriétés avant d'exécuter le connecteur.
Utilisez Connector Configurator pour configurer les propriétés du connecteur :
Les propriétés standard de configuration fournissent des informations utilisées par tous les connecteurs. Voir l'Annexe A. Propriétés de configuration standard pour les connecteurs pour plus d'informations sur ces propriétés. Pour une procédure étape par étape de définition de ces propriétés, voir l'Annexe B. Connector Configurator.
Les propriétés de configuration spécifiques au connecteur fournissent des informations requises par l'agent du connecteur au moment de l'exécution. Les propriétés spécifiques au connecteur permettent également de modifier les informations statiques ou logiques dans l'agent du connecteur sans devoir le recoder et le recompiler.
Le tableau 9 contient les propriétés de configuration spécifiques au connecteur. Pour obtenir une explication des propriétés, voir les sections suivantes.
Nom | Valeurs possibles | Valeur par défaut | Obligatoire |
---|---|---|---|
ArchivalConnectionFactoryName | Nom de l'objet du magasin JNDI à extraire et utiliser pour les événements d'archivage ; prend en charge les styles de publication PTP (basé sur les files d'attente) et Pub/Sub (basé sur les rubriques). | Non | |
ArchiveDestination | Destination des copies des messages dont l'envoi a réussi | Non | |
ConfigurationMetaObject | Méta-objet de configuration | Voir la description de la propriété | |
ConnectionFactoryName | Fabrique de connexion de file d'attente ou rubrique JMS définie dans le magasin JNDI. | Oui | |
CTX_Authoritative | Constante contenant le nom de la propriété d'environnement permettant d'indiquer l'autorité du service requis. | Non | |
CTX_Batchsize | Constante contenant le nom de la propriété d'environnement permettant d'indiquer la taille de traitement par lot à utiliser pour retourner des données via le protocole du service. | Non | |
CTX_DNS_URL | Constante contenant le nom de la propriété d'environnement permettant d'indiquer les noms de domaine et d'hôte DNS à utiliser pour le contexte de l'URL JNDI (par exemple "dns://somehost/wiz.com"). | Non | |
CTX_InitialContextFactory | Nom de la classe de fabrique à utiliser pour établir un contexte JNDI initial. | Oui | |
CTX_Language | Constante contenant le nom de la propriété d'environnement permettant d'indiquer la langue à utiliser de préférence avec le service. | Non | |
CTX_ObjectFactories | Constante contenant le nom de la propriété d'environnement permettant d'indiquer la liste des fabriques d'objets à utiliser. | Non | |
CTX_ProviderURL | URL identifiant le contexte JNDI dans lequel se situe la fabrique de connexion. | Oui | |
CTX_Referral | Constante contenant le nom de la propriété d'environnement permettant d'indiquer de quelle façon les référenceurs rencontrés par le fournisseur de service doivent être traités. | Non | |
CTX_SecurityAuthentication | Constante contenant le nom de la propriété d'environnement permettant d'indiquer le niveau de sécurité à utiliser. | Non | |
CTX_SecurityCredentials | Constante contenant le nom de la propriété d'environnement permettant d'indiquer les accréditations de l'entité pour authentifier l'appelant au service. | Non | |
CTX_SecurityPrincipal | Constante contenant le nom de la propriété d'environnement permettant d'indiquer l'identité de l'entité pour authentifier l'appelant au service. | Non | |
CTX_SecurityProtocol | Constante contenant le nom de la propriété d'environnement permettant d'indiquer le protocole de sécurité à utiliser. | Non | |
CTX_URLPackagePrefixes | Constante contenant le nom de la propriété d'environnement permettant d'indiquer la liste des préfixes de modules à utiliser lors du chargement dans des fabriques de contexte d'URL. | Non | |
DataHandlerClassName | Nom de la classe du gestionnaire de données à instancier. | Voir la description de la propriété | |
DataHandlerConfigMO | Nom du méta-objet du gestionnaire de données contenant des informations de configuration pour DataHandlerMimeType |
MO_DataHandler_ Valeur par défaut |
Voir la description de la propriété |
DataHandlerMimeType | Type mime à utiliser lors de la sélection du gestionnaire de données par défaut |
text/delimited |
Voir la description de la propriété |
DataHandlerPoolSize | Nombre maximum d'instances DataHandler à mettre en mémoire cache pour un type particulier de DataHandler | 30 | Non |
DefaultVerb | Indique l'instruction à définir dans un objet métier entrant | Create | Non |
EnableMessageProducerCache | true ou false | true | Non |
ErrorDestination | Destination des messages non traités | Non | |
InDoubtEvents |
FailOnStartup Reprocess Ignore LogError |
Reprocess |
Non |
InProgressDestination | Destination de stockage temporaire | Non | |
InputDestination | Nom des destinations d'interrogation | Non | |
LookupDestinationsUsingJNDI | true ou false |
false |
Non |
MessageFormatProperty | Nom de propriété précisant le format du message |
JMSType |
Non |
MessageResponseResultProperty | Propriété du message de réponse indiquant le résultat de l'opération de requête | WBI_Result | Oui, pour un traitement synchrone. |
PollQuantity | Nombre de messages à extraire de chaque destination indiquée dans la propriété InputDestination |
1 |
Non |
ReplyToDestination | Destination des fichiers de réponse lorsque le connecteur émet des requêtes | Oui, pour un traitement synchrone. | |
SessionPoolSizeForRequests | Taille de pool maximale pour la mise en mémoire cache des sessions utilisées au cours du traitement de la requête. | 10 | Non |
UnsubscribeOnTerminate | Indique les rubriques supprimées de InputDestination. | Non | |
UseDefaults |
trueou false |
false |
Non |
UseDurableSubscriptions |
trueou false |
false |
Non |
WorkerThreadCount | Nombre maximum d'unités d'exécution parallèles à interroger. |
1 |
Non |
Cette propriété permet au connecteur de prendre en charge l'archivage des événements dans des styles point à point ou basés sur les rubriques. La propriété nomme la file d'attente JMS ou l'objet de fabrique de connexion de rubrique défini dans le magasin JNDI, et que le connecteur doit extraire et utiliser pour établir une connexion auprès du fournisseur JMS. Cet objet de connexion est ensuite utilisé pour créer des références de publication pour les destinations d'archive. Les propriétés de connecteur qui définissent les définitions d'archivage sont les suivantes :
Si cette propriété n'est pas définie, le connecteur utilise la fabrique définie dans la propriété ConnectionFactoryName pour créer des références aux destinations d'archivage.
Cette propriété est indiquée sous la forme
connection_factory_name:<msg_system_type>
où connection_factory_name est obligatoire et le second paramètre (<msg_system_type>) facultatif, avec la valeur Topics ou Queues. Le second paramètre indique à l'adaptateur de déterminer le type de système de message en fonction de la configuration de l'utilisateur.
Par exemple, pour préciser une messagerie pub/sub, configurez ConnectionFactoryName comme suit :
<connection_factory_name>:Topics
Pour une messagerie point à point, configurez ConnectionFactoryName comme suit :
<connection_factory_name>:Queues
Si vous ne mentionnez pas le second paramètre (Topics ou Queues), l'adaptateur tentera d'identifier le système de messagerie en fonction de l'instance de l'objet de fabrique.
Valeur par défaut = none.
Destination des copies des messages dont l'envoi a réussi.
La valeur par défaut est CWLD_ARCHIVE.
Nom du méta-objet statique contenant les informations de configuration du connecteur.
Il n'y a pas de valeur par défaut.
Nom de l'objet de fabrique de connexion de file d'attente ou de rubrique JMS, défini dans le magasin JNDI, et que le connecteur doit extraire et utiliser pour établir une connexion auprès du fournisseur JMS. Pour rechercher ce nom, le connecteur utilise le contexte JNDI initial établi par les propriétés CTX_InitialContextFactory et CTX_ProviderURL.
Cette propriété est indiquée sous la forme
connection_factory_name:<msg_system_type>
où connection_factory_name est obligatoire et le second paramètre (<msg_system_type>) facultatif, avec la valeur Topics ou Queues. Le second paramètre indique à l'adaptateur de déterminer le type de système de message en fonction de la configuration de l'utilisateur.
Par exemple, pour préciser une messagerie pub/sub, configurez ConnectionFactoryName comme suit :
<connection_factory_name>:Topics
Pour une messagerie point à point, configurez ConnectionFactoryName comme suit :
<connection_factory_name>:Queues
Si vous ne mentionnez pas le second paramètre (Topics ou Queues), l'adaptateur tentera d'identifier le système de messagerie en fonction de l'instance de l'objet de fabrique.
Valeur par défaut = none.
Constante contenant le nom de la propriété d'environnement permettant d'indiquer l'autorité du service requis. Si la propriété est définie sur la chaîne "true", l'accès est la source qui dispose des droits les plus élevés (prioritaire sur la mémoire cache et les répliques). Pour toutes les autres valeurs, la source n'est pas nécessairement celle qui a les droits les plus élevés (même si elle peut l'être).
Par défaut, la propriété est définie sur "false".
Constante contenant le nom de la propriété d'environnement permettant d'indiquer la taille de traitement par lot à utiliser pour retourner des données via le protocole du service. Ceci indique au fournisseur de retourner les résultats des opérations dans des lots de la taille précisée, pour qu'il puisse optimiser ses performances et l'utilisation des ressources. La propriété est indiquée par une chaîne qui représente un entier. En l'absence d'indication, la taille du traitement par lot est déterminée par le fournisseur.
Constante contenant le nom de la propriété d'environnement permettant d'indiquer les noms de domaine et d'hôte DNS à utiliser pour le contexte de l'URL JNDI (par exemple, "dns://somehost/wiz.com"). Si la propriété n'est pas précisée dans l'environnement, la propriété système portant le même nom est utilisée. Si elle n'est pas non plus précisée dans une propriété système et si le programme tente d'utiliser une URL JNDI contenant le nom DNS, une exception ConfigurationException est levée.
Nom de la classe de fabrique utilisé pour établir un contexte JNDI initial.
Valeur par défaut = none.
Constante contenant le nom de la propriété d'environnement permettant d'indiquer la langue à utiliser de préférence avec le service. La valeur de la propriété est une liste de balises de langues définies dans RFC 1766 et séparées par le caractère ":". En l'absence d'indication, la langue est déterminée par le fournisseur de service.
Constante contenant le nom de la propriété d'environnement permettant d'indiquer la liste des fabriques d'objets à utiliser. La valeur de la propriété doit être une liste de noms complets de classes de fabriques, séparés par le caractère ":", qui créeront un objet d'après des informations le concernant. Si la propriété n'est pas précisée dans l'environnement, la propriété système portant le même nom est utilisée. Si elle n'est pas précisée non plus en tant que propriété système, NamingManager.getObjectInstance() tentera de créer l'objet.
URL complète identifiant le contexte JNDI dans lequel se situe le facteur de connexion. Cette valeur est transmise au facteur de contexte.
Valeur par défaut = none.
Constante contenant le nom de la propriété d'environnement permettant d'indiquer de quelle façon les référenceurs rencontrés par le fournisseur de service doivent être traités. La valeur de la propriété est l'une des chaînes suivantes :
Constante contenant le nom de la propriété d'environnement permettant d'indiquer le niveau de sécurité à utiliser. La valeur est l'une des chaînes "none", "simple" et "strong". En l'absence d'indication, le comportement est déterminé par le fournisseur de service.
Constante contenant le nom de la propriété d'environnement permettant d'indiquer les accréditations de l'entité pour authentifier l'appelant au service. La valeur de la propriété dépend de la méthode d'authentification. Par exemple, il peut s'agir d'un mot de passe haché, d'un mot de passe en texte clair, d'une clé, d'un certificat, etc. En l'absence d'indication, le comportement est déterminé par le fournisseur de service.
Constante contenant le nom de la propriété d'environnement permettant d'indiquer l'identité de l'entité pour authentifier l'appelant au service. La valeur de la propriété dépend de la méthode d'authentification. En l'absence d'indication, le comportement est déterminé par le fournisseur de service.
Constante contenant le nom de la propriété d'environnement permettant d'indiquer le protocole de sécurité à utiliser. Sa valeur est une chaîne déterminée par le fournisseur de service (par exemple "ssl"). En l'absence d'indication, le comportement est déterminé par le fournisseur de service.
Constante contenant le nom de la propriété d'environnement permettant d'indiquer la liste des préfixes de modules à utiliser lors du chargement dans des fabriques de contexte d'URL. La valeur de la propriété doit être une liste (séparée par le caractère ":") de préfixes de modules pour le nom de classe de la classe de fabrique qui créera une fabrique de contexte d'URL. Si la propriété n'est pas précisée dans l'environnement, la propriété système portant le même nom est utilisée. Le préfixe com.sun.jndi.url est toujours ajouté à la fin de la liste potentiellement vide des préfixes de modules.
Classe de gestionnaire de données à utiliser lors de la conversion de messages depuis et vers des objets de données. Précisez à la fois DataHandlerConfigMO et DataHandlerMimeType, ou uniquement DataHandlerClassName. N'indiquez pas les trois propriétés à la fois.
Valeur par défaut = none.
Nom du méta-objet contenant des informations de configuration pour le type mime précisé dans la propriété DataHandlerMimeType. Fournit des informations de configuration pour le gestionnaire de données. Précisez à la fois DataHandlerConfigMO et DataHandlerMimeType, ou uniquement DataHandlerClassName. N'indiquez pas les trois propriétés à la fois.
La valeur par défaut est MO_DataHandler_Default.
Permet de lancer une requête sur un gestionnaire de données en fonction d'un type MIME particulier. Précisez à la fois DataHandlerConfigMO et DataHandlerMimeType, ou uniquement DataHandlerClassName. N'indiquez pas les trois propriétés à la fois.
Valeur par défaut = text/delimited.
Définissez cette propriété facultative si vous souhaitez que l'adaptateur mette en pool les instances de gestionnaires de données précédemment créées, en vue d'une utilisation ultérieure. Nombre maximum d'instances DataHandler à mettre en mémoire cache pour un type particulier de DataHandler.
Valeur par défaut =30
Indique l'instruction à définir dans une objet métier entrant, si elle n'a pas été définie par le gestionnaire de données pendant l'interrogation.
Valeur par défaut = Create
Propriété booléenne permettant de préciser que l'adaptateur doit activer la mémoire cache d'un producteur de message pour envoyer des messages de requête.
Valeur par défaut = true
Destination des copies des messages entrants lorsque le connecteur rencontre des erreurs de traitement.
La valeur par défaut est CWLD_ERROR.
Indique comment gérer les événements en cours qui ne sont pas totalement traités en raison d'une panne inattendue de connecteur. Choisissez l'une des quatre actions à entreprendre si des événements figurent dans la file d'attente en cours pendant l'initialisation :
La valeur par défaut est Reprocess.
Destination temporaire contenant les messages pendant le traitement.
Valeur par défaut = none.
Destinations qui seront interrogées par le connecteur pour détecter les nouveaux messages. Le connecteur accepte plusieurs noms, séparés par un point-virgule. Par exemple, pour interroger les trois files d'attente suivantes dans une configuration de ce type : MyQueueA, MyQueueB et MyQueueC, la propriété de configuration du connecteur InputQueue doit être définie sur : MyQueueA;MyQueueB;MyQueueC.
Si la propriété InputDestination n'est pas indiquée, le connecteur ne sera pas interrogé.
Valeur par défaut = none.
Si cette propriété a la valeur true, le connecteur cherche tous les noms de destination JMS du magasin JNDI. Pour cela, toute destination précisée est définie dans le magasin JNDI.
Par défaut, le connecteur saute cette étape et permet au fournisseur JMS de résoudre le nom sur la destination appropriée lors de l'exécution.
Valeur par défaut = false.
Zone d'un message JMS contenant le format d'entrée ou de sortie du message. Par défaut, le connecteur contrôle la zone JMSType des messages entrants pour connaître le format du message, et il l'indique dans la zone JMSType des messages sortants.
Valeur par défaut =JMSType.
Obligatoire pour le traitement synchrone des requêtes, cette propriété précise dans un message JMS de réponse la zone que le connecteur doit contrôler pour déterminer le résultat de la requête. Cette propriété n'est pas utilisée pour le traitement asynchrone.
Si la propriété de l'en-tête JMS spécifiée par MessageResponseResultProperty n'existe pas, le connecteur interprète le code de retour en tant que VALCHANGE, transmet le contenu du message de réponse au gestionnaire de données puis met à jour l'objet métier.
La valeur par défaut est WBI_Result.
Nombre maximum de messages à extraire de chaque destination précisée par la propriété InputDestination pendant un cycle pollForEvents.
La valeur par défaut est 1.
Destination des fichiers de réponse lorsque le connecteur émet des requêtes. Il s'agit par défaut de la destination utilisée par le connecteur pour coordonner l'échange des messages de requête avec l'application cible. Ne précisez cette propriété que pour le traitement synchrone.
Valeur par défaut = none.
Taille de pool maximale pour la mise en mémoire cache des sessions utilisées au cours du traitement de la requête.
Valeur par défaut = 10
Destination des copies des messages entrants si le message n'est pas reconnu ou si l'objet métier auquel il est mappé n'est pas pris en charge. Si cette propriété est définie et valide, le connecteur place une copie des messages non souscrits dans cette destination. Dans le cas contraire, le message est éliminé.
Valeur par défaut = none.
N'est utilisé que si UserDurableSubscriptions est défini sur true. L'utilisation de souscriptions durables crée un problème si vous supprimez des rubriques de la configuration du connecteur. Le fournisseur JMS continuera à conserver des messages pour les souscriptions durables, même si le connecteur ne contrôle plus jamais ces souscriptions.
Lorsque vous supprimez des rubriques de la liste précisée dans InputDestination, indiquez-les (en les séparant par un point-virgule) pour cette valeur de propriété. Pour détruire les souscriptions durables, procédez comme suit :
Cette action ne modifie aucune valeur de InputDestination.
A défaut d'effectuer la procédure ci-dessus, le connecteur n'est pas perturbé mais le fournisseur JMS de messages stockera des messages inutiles.
Valeur par défaut = none.
Dans une opération Create, si UseDefaults est défini sur true, le connecteur contrôle si une valeur valide ou une valeur par défaut est fournie pour chaque attribut d'objet métier isRequired. Si une valeur est indiquée, l'opération Create réussit. Si le paramètre est défini sur false, le contrôleur cherche uniquement une valeur valide et entraîne l'échec de l'opération Create s'il n'en trouve pas.
Valeur par défaut = false.
N'utilisez cette propriété qu'avec les messages de type rubrique Pub/Sub. Si cette propriété est définie sur true, le connecteur agit comme un souscripteur durable pour les destinations applicables. Au prix d'une surcharge supérieure, le connecteur indiquera au fournisseur JMS de conserver tous les messages des rubriques auxquelles il souscrit, même lorsque le connecteur est hors ligne. Une fois ramené en ligne, le connecteur traitera de nouveau les messages publiés qu'il a manqués.
Valeur par défaut = false.
Nombre maximum d'unités d'exécution parallèles à interroger. Pendant le traitement simultané des événements, l'adaptateur est dans l'incapacité de soumettre des événements au courtier dans l'ordre dans lequel il les a reçus. Si la séquence doit être maintenue, WorkerThreadCount doit toujours être défini sur 1.
L'adaptateur prend en charge les interfaces de messagerie point à point (PTP) et de publication/souscription (Pub/Sub) définies par le standard JMS. Le style de messagerie utilisé par l'adaptateur est déterminé par le type d'objet administré précisé par l'utilisateur dans la propriété ConnectionFactoryName spécifique au connecteur. Voir ConnectionFactoryName avant de poursuivre avec les procédures suivantes :
Pour configurer une instance de l'adaptateur dans le style de message PTP :
Pour configurer une instance de l'adaptateur dans le style de message Pub/Sub :
Pour établir une connexion avec le fournisseur JMS, le connecteur doit accéder à une fabrique de connexion JMS. JMS définit l'interface de la fabrique mais chaque fournisseur JMS doit fournir sa propre implémentation. Une fois que le connecteur a une référence à cette implémentation de fabrique, il peut établir une connexion et communiquer avec le fournisseur JMS sans connaître les protocoles propriétaires ni même l'identité du fournisseur.
Pour être portable, le connecteur a besoin que la fabrique de connexions réside dans un magasin JNDI. Pendant l'implémentation, l'utilisateur ou l'administrateur système doit créer et configurer une fabrique de connexions et la placer dans le magasin JNDI, sous un nom défini par l'utilisateur. Lors de l'exécution, le connecteur se connectera au magasin JNDI, recherchera la fabrique de connexions et l'utilisera pour établir une connexion auprès du fournisseur JMS.
Certains fournisseurs JMS apportent leurs propres implémentations JNDI contenant les fabriques et connexions et autres objets JMS administrés que vous créez. Cette approche simplifie la configuration de l'adaptateur JMS. Pour d'autres fournisseurs JMS, les utilisateurs devront peut-être installer et configurer un fournisseur JNDI externe, créer la fabrique de connexions et la mettre à la disposition de l'adaptateur. Pour plus d'informations, voir la documentation sur le fournisseur JNDI.
Pour plus d'informations sur la configuration et les variables de l'environnement JNDI, voir www.javasoft.com. Pour plus d'informations sur la configuration de JNDI avec le module de correction MA88, voir Configuration de JNDI avec les bibliothèques du client WebSphere MQ Java.
Pour accéder à un didacticiel indiquant comment configurer JNDI avec les bibliothèques du client WebSphere MQ Java, voir Configuration pour la messagerie basée sur des files d'attente et Configuration de la messagerie basée sur des rubriques.