Configuration du connecteur

Les adaptateurs ont deux types de propriétés de configuration : standard et spécifiques à l'adaptateur. Vous devez définir les valeurs de certaines de ces propriétés avant d'exécuter le connecteur.

Les propriétés du connecteur sont configurées depuis Connector Configurator (lorsque WebSphere MQ Integrator Broker est le courtier d'intégration ou depuis Connector Configurator, auquel vous accédez depuis System Manager (lorsque ICS est le courtier d'intégration). Pour obtenir des informations de configuration détaillées, voir Annexe B. Utilisation de Connector Configurator et Connector Development Guide for Java.

Propriétés standard 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 standard du connecteur pour plus d'informations sur ces propriétés.

Important :
Ce connecteur prenant en charge tous les courtiers d'intégration, les propriétés de configuration de tous les courtiers lui sont applicables.

Remarque :
Ce connecteur étant doté d'une seule unité d'exécution, il ne peut pas tirer parti de la propriété AgentConnections.

Le tableau 2 donne des informations spécifiques à ce connecteur et concernant les propriétés de configuration de l'annexe.

Tableau 2. Informations sur les propriétés spécifiques à ce connecteur
Propriété Important
CharacterEncoding Ce connecteur n'utilise pas cette propriété.
Locale Ce connecteur étant internationalisé, vous pouvez modifier la valeur de cette propriété. Voir les notes d'informations concernant le connecteur pour connaître les paramètres régionaux pris en charge.

Important :
WebSphere MQ Integrator Broker ne prend pas en charge plusieurs paramètres nationaux. Vérifiez que chaque composant de votre installation (par exemple, tous les adaptateurs, toutes les applications et le courtier d'intégration) sont définis en fonction des mêmes paramètres nationaux.

Remarque :
L'adaptateur Portal Infranet prend en charge la propriété DuplicateEventElimination. Pour activer la propriété DuplicateEventElimination, attribuez la valeur true à l'attributDuplicateEventElimination. Pour plus de détails sur la propriétéDuplicateEventElimination, voir Annexe A. Propriétés standard du connecteur.

Remarque :
Ce connecteur prenant en charge tous les courtiers d'intégration, les propriétés de configuration de tous les courtiers lui sont applicables.

Propriétés spécifiques au connecteur

Les propriétés de configuration spécifiques au connecteur fournissent des informations requises par le 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 le connecteur sans devoir le recoder et le recompiler.

Le tableau 3 contient les propriétés de configuration spécifiques au connecteur. Pour obtenir une explication des propriétés, voir les sections suivantes.

Tableau 3. Propriétés de configuration spécifiques au connecteur
Nom Valeurs possibles Valeur par défaut Obligatoire
Mot de passe de l'application Mot de passe pour le compte utilisateur Oui
ApplicationUserName Nom du compte utilisateur Oui
CommentFail Commentaire relatif à la table d'événements pour les événements ayant échoué Echec Non
CommentSucceed Commentaire relatif à la table d'événements pour les événements ayant abouti Succès Non
DatabaseInfo jdbc:oracle:thin@ CWENGTEST:1521:
portaldb
Nom d'hôte serveur, numéro de port de la base de données Portal et nom de celle-ci. Oui
DbName Nom du programme d'écoute Oracle Oui
DbPassword Mot de passe de la base de données Oui
DbUser Nom d'utilisateur de la base de données pin Oui
DriverClass Nom de classe de pilote de la base de données Non
InfDatabase String 0.0.0.1 Oui
InfHost Nom et port de la machine hôte //CWENGTEST1:11960 Oui
InfLogFile Nom du fichier journal InfConnection.txt Oui
InfranetConnections Nombre de connexions Infranet ouvertes par le connecteur pour le regroupement de connexions 5 Oui
InfService String service\admin_client 1 Oui
InfType 0 ou 1 1 Oui
InfVersion Version de l'application Infranet Oui
PollQuantity Nombre d'événements à récupérer 1 Non
UseDefaults true ou false false Non

Mot de passe de l'application

Mot de passe défini pour le compte utilisateur du système WebSphere Business Integration.

ApplicationUserName

Nom du compte utilisateur pour le connecteur.

CommentFail

Commentaire sur la table d'événements en cas d'échec. La valeur par défaut est Fail.

CommentSucceed

Commentaire sur la table d'événements en cas de succès. La valeur par défaut est Succeed.

DatabaseInfo

Cette propriété définit l'URL qui serait utilisée par le pilote JDBC pour établir une connexion avec la base de données.

Exemple :

jdbc:oracle:thin:@CWENGTEST1:1521:portaldb

Consultez la documentation JDBC pour connaître les formats spécifiques de l'URL

DbName

Nom du programme d'écoute Oracle pour la base de données Infranet.

DbPassword

Mot de passe de la base de données.

DriverClass

Nom de classe de pilote de la base de données.

Pour Oracle, définissez :

oracle.jdbc.driver.OracleDriver

Si DriverClass n'est pas défini, l'adaptateur utilise oracle.jdbc.driver.OracleDriver comme valeur par défaut.

DbUser

Nom d'utilisateur de la base de données, généralementpin.

InfDatabase

Chaîne au format Infranet. La valeur par défaut est 0.0.0.1..

InfHost

Nom et port de la machine hôte, par exemple, //engtest2:11960. La valeur par défaut est //CWENGTEST1:11960.

InfLogFile

Nom du fichier à utiliser en tant que journal par défaut. La valeur par défaut est InfConnection.txt.

InfranetConnections

Cette propriété est utilisée pour définir le nombre de connexions ouvertes par le connecteur avec l'application l'application Infranet pour le regroupement de connexions. Le connecteur gère le nombre affecté de connexions. Lorsqu'un processus d'objet métier a besoin d'une connexion, il en alloue une du groupe. Cette connexion est alors retirée du groupe disponible et ajoutée au groupe utilisé. A l'issue du processus d'objet métier, la connexion est retirée du groupe utilisé et replacée dans le groupe disponible. Ce mode d'utilisation du regroupement de connexions augmente les performances car il n'est pas nécessaire d'ouvrir et de fermer la connexion pour chaque processus métier.

Remarque :
Si cette propriété n'est pas définie, le connecteur va générer l'exception suivante au démarrage du connecteur : NumberFormatException

InfService

Chaîne, généralement service\admin_client 1. Il s'agit de la valeur par défaut.

InfType

Type de connexion. Les seules valeurs possibles sont 0 ou 1. La valeur par défaut est 1.

InfVersion

Version de l'application Infranet.

PollQuantity

Nombre d'événements récupérés en une seule interrogation. La valeur par défaut est 1.

UseDefaults

Si la propriété UseDefaults a la valeur true ou n'est pas définie, le connecteur vérifie si une valeur correcte ou une valeur par défaut est indiquée pour chaque attribut d'objet métier isRequired. Si une valeur est indiquée, l'opération de création aboutit. Dans le cas contraire, l'opération échoue.

Si le paramètre est défini sur false, le connecteur cherche uniquement des valeurs valides et entraîne l'échec de l'opération Create s'il n'en trouve pas.

La valeur par défaut est "false".

Copyright IBM Corp. 2003, 2005