Cette section répertorie et définit chacune des propriétés de configuration standard du connecteur.
File d'attente utilisée par le courtier d'intégration pour envoyer des messages administratifs au connecteur.
La valeur par défaut est CONNECTORNAME/ADMININQUEUE.
File d'attente utilisée par le connecteur pour envoyer des messages administratifs au courtier d'intégration.
La valeur par défaut est CONNECTORNAME/ADMINOUTQUEUE.
Applicable uniquement si RepositoryDirectory a la valeur <REMOTE>.
La propriété AgentConnections contrôle le nombre de connexions ORB (Object Request Broker) ouvertes par orb.init[].
La valeur par défaut de cette propriété est 1. Vous pouvez la modifier le cas échéant.
Niveau des messages de trace pour le composant spécifique à l'application. La valeur par défaut est 0. Le connecteur fournit tous les messages de trace applicables au niveau de trace défini ou à un niveau inférieur.
Nom qui identifie de manière unique l'application du connecteur. Ce nom permet à l'administrateur système de contrôler l'environnement système WebSphere Business Integration. Vous devez attribuer une valeur à cette propriété avant d'exécuter le connecteur.
Identifie le type de courtier d'intégration que vous utilisez. Les options sont ICS, les courtiers de messages WebSphere (WMQI, WMQIB ou WBIMB) ou WAS.
Indique le jeu de codes de caractères utilisé pour mapper un caractère (comme une lettre de l'alphabet, une représentation numérique ou un signe de ponctuation) à une valeur numérique.
Par défaut, un sous-ensemble des codages de caractères pris en charge uniquement s'affiche dans la liste déroulante. Pour ajouter à cette liste d'autres valeurs prises en charge, vous devez modifier manuellement le fichier \Data\Std\stdConnProps.xml dans le répertoire produit. Pour plus d'informations, voir l'annexe sur Connector Configurator.
Applicable uniquement si RepositoryDirectory a la valeur <REMOTE>.
Détermine le nombre d'objets métier pouvant être traités simultanément par le connecteur pour la transmission des événements. La valeur de cet attribut doit correspondre au nombre d'objets métier que vous souhaitez mapper et transmettre simultanément. Par exemple, affectez à cette propriété la valeur 5 pour que cinq objets métier soient traités simultanément. La valeur par défaut est 1.
La définition de cette propriété sur une valeur supérieure à 1 permet au connecteur d'une application source de mapper plusieurs objets métier d'événement en même temps et de les transmettre simultanément à plusieurs instances de collaboration. Cela augmente la rapidité de transmission des objets métier au courtier d'intégration, en particulier si les objets métier utilisent des mappes complexes. L'augmentation du taux d'arrivée des objets métier aux instances de collaboration peut améliorer les performances générales du système.
Pour implémenter le traitement simultané d'un flux entier (d'une application source vers une application cible), vous devez :
La propriété ConcurrentEventTriggeredFlows n'a aucun effet sur l'interrogation du connecteur, laquelle n'a qu'une seule unité d'exécution et exécutée en série.
Cette propriété permet à un connecteur activé par JMS utilisant un magasin d'événements JMS d'effectuer une transmission d'événement garantie, dans laquelle un événement est retiré de la file d'attente source et placé sur la file d'attente cible en tant que transaction JMS unique.
Il n'y a pas de valeur par défaut.
Lorsque ContainerManagedEvents est défini sur JMS, vous devez configurer les propriétés suivantes pour activer la transmission d'événement garantie :
Vous devez aussi configurer un gestionnaire de données avec les propriétés MimeType, DHClass (classe de gestionnaire de données) et DataHandlerConfigMOName (nom du métaobjet, facultatif). Pour définir ces valeurs, utilisez l'onglet Data Handler dans Connector Configurator.
Ces propriétés sont spécifiques à l'adaptateur, mais voici des valeurs d'exemple :
Les zones correspondant à ces valeurs dans l'onglet Data Handler s'affichent uniquement si vous avez défini ContainerManagedEvents sur JMS.
Cette propriété apparaît uniquement si la propriété DeliveryTransport a la valeur JMS.
Applicable uniquement si RepositoryDirectory a la valeur <REMOTE>.
Définit le comportement du contrôleur du connecteur après avoir détecté l'indisponibilité du composant spécifique à l'application cible.
Si cette propriété a la valeur true et que le composant spécifique à l'application cible n'est pas disponible lorsqu'un événement atteint l'ICS, le contrôleur du connecteur empêche la requête d'accéder au composant spécifique à l'application. Lorsque le composant spécifique à l'application redevient opérationnel, le contrôleur lui envoie la requête.
Toutefois, si le composant d'application cible devient indisponible après que le contrôleur du connecteur lui a envoyé la requête d'appel de service, celle-ci échoue.
Si cette propriété a la valeur false, le contrôleur du connecteur met toutes les requêtes d'appels de service en échec dès qu'il détecte l'indisponibilité du composant spécifique à l'application.
La valeur par défaut est true.
Applicable uniquement si RepositoryDirectory a la valeur <REMOTE>.
Niveau des messages de trace pour le contrôleur du connecteur. La valeur par défaut est 0.
Applicable uniquement si DeliveryTransport a la valeur JMS.
File d'attente utilisée par le connecteur pour envoyer des objets métier au courtier d'intégration.
La valeur par défaut est CONNECTORNAME/DELIVERYQUEUE.
Spécifie le mécanisme de transfert pour la transmission des événements. La valeurs possibles sont MQ pour WebSphere MQ, IDL pour CORBA IIOP ou JMS pour Java Messaging Service.
Le connecteur envoie les requêtes d'appel de service et les messages administratifs par CORBA IIOP si la valeur de la propriété DeliveryTransport est MQ ou IDL.
Utilisez WebSphere MQ plutôt que IDL pour le transfert d'événement, sauf si vous ne devez avoir qu'un seul produit. WebSphere MQ présente les avantages suivants par rapport à IDL :
Permet la communication entre le connecteur et la structure du connecteur de client à l'aide de Java Messaging Service (JMS).
Si vous sélectionnez JMS en tant que transfert, des propriétés JMS supplémentaires telles que jms.MessageBrokerName, jms.FactoryClassName, jms.Password et jms.UserName apparaissent dans Connector Configurator. Les deux premières sont obligatoires pour ce transfert.
Dans cet environnement, vous rencontrerez peut être des difficultés pour démarrer simultanément le contrôleur du connecteur (du côté du serveur) et le connecteur (du côté du client), en raison de l'utilisation de la mémoire dans le client WebSphere MQ. Si votre installation utilise moins de 768 Mo en taille de segment de processus, IBM recommande que vous définissiez :
Ce script se trouve dans le répertoire \bin sous le répertoire produit. A l'aide d'un éditeur de texte, ajoutez la ligne suivante à la première ligne du script CWSharedEnv.sh :
export LDR_CNTRL=MAXDATA=0x30000000
Cette ligne de commande restreint l'utilisation du segment de mémoire à un maximum de 768 Mo (3 segments * 256 Mo). Si la mémoire du processus dépasse cette limite, un remplacement des pages peut se produire, ce qui peut affecter les performances de votre système.
Lorsque vous affectez à cette propriété la valeur true, un connecteur activé par JMS peut vérifier que des doublons ne sont pas transmis à la file d'attente de transmission. Pour utiliser cette fonction, le connecteur doit avoir un identificateur d'événement unique défini en tant qu'attribut ObjectEventId de l'objet métier dans le code spécifique à l'application. Cette opération s'effectue lors du développement du connecteur.
Cette propriété peut également avoir la valeur false.
Si le connecteur rencontre une erreur lors du traitement d'un message, il transmet ce message à la file d'attente spécifiée dans cette propriété, accompagné d'un indicateur d'état et d'une description de l'incident.
La valeur par défaut est CONNECTORNAME/FAULTQUEUE.
Taille de segment maximale pour l'agent (en mégaoctets). Cette propriété est applicable uniquement si la valeur RepositoryDirectory est <REMOTE>.
La valeur par défaut est 128 Mo.
Espace mémoire natif maximal pour l'agent (en kilo-octets). Cette propriété est applicable uniquement si la valeur RepositoryDirectory est <REMOTE>.
La valeur par défaut est 128 Ko.
Taille de segment minimale pour l'agent (en mégaoctets). Cette propriété est applicable uniquement si la valeur RepositoryDirectory est <REMOTE>.
La valeur par défaut est 1 Mo.
Indique le nom de classe à instancier pour un fournisseur JMS. Vous devez définir cette propriété de connecteur lorsque vous choisissez JMS comme mécanisme de transfert (DeliveryTransport).
La valeur par défaut est CxCommon.Messaging.jms.IBMMQSeriesFactory.
Indique le nom de courtier à utiliser pour le fournisseur JMS. Vous devez définir cette propriété de connecteurs lorsque vous choisissez JMS en tant que mécanisme de transfert (DeliveryTransport).
La valeur par défaut est crossworlds.queue.manager. Utilisez la valeur par défaut lorsque vous vous connectez à un courtier de messages local.
Lorsque vous vous connectez à un courtier de messages distant, cette
propriété prend les valeurs (obligatoires) suivantes :
QueueMgrName:<Channel>:<HostName>:<PortNumber>,
où les variables représentent respectivement :
QueueMgrName : le nom du gestionnaire de files
d'attente ;
Channel : le canal utilisé par le client ;
HostName : le nom de la machine sur laquelle le gestionnaire
de files d'attente doit résider ;
PortNumber : le numéro de port que le gestionnaire de files
d'attente doit utiliser pour écouter.
Par exemple :
jms.MessageBrokerName =
WBIMB.Queue.Manager:CHANNEL1:RemoteMachine:1456
Indique le nombre maximal de requêtes d'appel de service pouvant être envoyées simultanément à un connecteur. Lorsque ce nombre maximal est atteint, les nouveaux appels de service sont bloqués et mis en attente de traitement.
La valeur par défaut est 10.
Indique le mot de passe défini pour le fournisseur JMS. Cette valeur est facultative.
Il n'y a pas de valeur par défaut.
Indique le nom d'utilisateur défini pour le fournisseur JMS. Cette valeur est facultative.
Il n'y a pas de valeur par défaut.
Cette propriété prend en charge le traitement de plusieurs unités d'exécution dans MQ Listener lorsque ICS est le courtier d'intégration. Elle permet l'écriture par lots de plusieurs événements sur la base de données, améliorant ainsi les performances du système. La valeur par défaut est 1.
Cette propriété s'applique uniquement aux connecteurs utilisant le transfert MQ. La propriété DeliveryTransport doit être définie sur MQ.
Indique le code de langue, le pays ou le territoire et, le cas échéant, le jeu de codes de caractères associé. La valeur de cette propriété détermine les conventions culturelles telles que le classement et l'ordre de tri des données, les formats de date et d'heure, ainsi que les symboles monétaires utilisés.
Le format d'un nom d'environnement local est le suivant :
ll_TT.codeset
où :
Par défaut, seul un sous-ensemble d'environnements locaux pris en charge apparaît dans la liste déroulante. Pour ajouter à cette liste d'autres valeurs prises en charges, vous devez modifier manuellement le fichier \Data\Std\stdConnProps.xml situé dans le répertoire produit. Pour plus d'informations, voir l'annexe sur Connector Configurator.
La valeur par défaut est en_US. Si le connecteur n'a pas été internationalisé, la seule valeur correcte pour cette propriété est en_US. Pour déterminer si un connecteur a été internationalisé, consultez la liste des versions de connecteur sur ces sites Web :
http://www.ibm.com/software/websphere/wbiadapters/infocenter ou http://www.ibm.com/websphere/integration/wicserver/infocenter
Applicable uniquement si RepositoryDirectory a la valeur <REMOTE>.
Indique s'il faut consigner les erreurs dans la cible du journal du courtier d'intégration. La consignation des erreurs dans la cible du journal du courtier d'intégration active également la notification par courrier électronique qui, lorsque des erreurs ou des erreurs fatales ont lieu, génère des messages électroniques pour le destinataire MESSAGE_RECIPIENT spécifié dans le fichier InterchangeSystem.cfg.
Par exemple, lorsque la connexion entre un connecteur et son application est interrompue, si LogAtInterChangeEnd a la valeur true, un courrier électronique est envoyé au destinataire du message spécifié. La valeur par défaut est false.
Nombre maximal d'événements contenus dans la mémoire tampon du contrôleur. Cette propriété est utilisée par le contrôle du flux et est applicable uniquement si la valeur de la propriété RepositoryDirectory est <REMOTE>.
La valeur peut être un nombre entier positif compris entre 1 et 2147483647. La valeur par défaut est 2147483647.
Nom du fichier de messages du connecteur. L'emplacement standard de ce fichier de messages est \connectors\messages dans le répertoire produit. Indique le nom du fichier du message dans un chemin d'accès absolu si le fichier de messages n'est pas situé à l'emplacement standard.
S'il n'existe pas de fichier de messages, le connecteur utilise InterchangeSystem.txt comme fichier de messages. Ce fichier est situé dans le répertoire produit.
File d'attente logique utilisée par le connecteur pour contrôler les événements en double. Elle est uniquement utilisée si la propriété DeliveryTransport a la valeur JMS et que DuplicateEventElimination a la valeur TRUE.
La valeur par défaut est CONNECTORNAME/MONITORQUEUE.
Valide uniquement lorsque RepositoryDirectory a la valeur <REMOTE>.
Indique si le connecteur utilise la fonction de redémarrage automatique et à distance. Cette fonction utilise le démon d'activation d'objets (OAD, Object Activation Daemon) déclenché par MQ pour redémarrer le connecteur après un arrêt anormal ou pour démarrer un connecteur distant à partir du moniteur système.
Cette propriété doit avoir la valeur true pour que la fonction de redémarrage automatique et à distance soit activée. Pour plus d'informations sur la configuration de la fonction de l'OAD déclenché par MQ, voir le document Installation Guide for Windows ou for UNIX.
La valeur par défaut est false.
Valide uniquement lorsque RepositoryDirectory a la valeur <REMOTE>.
Indique le nombre maximal de tentatives de redémarrage automatique du connecteur par l'OAD déclenché par MQ après un arrêt anormal. La propriété OADAutoRestartAgent doit avoir la valeur true pour prendre effet.
La valeur par défaut est 1000.
Valide uniquement lorsque RepositoryDirectory a la valeur <REMOTE>.
Indique la durée en minutes entre les tentatives de relance pour l'OAD déclenché par MQ. Si l'agent du connecteur ne redémarre pas durant cet intervalle, le contrôleur du connecteur demande à l'OAD de redémarrer l'agent du connecteur. L'OAD répète cette opération autant de fois que le nombre spécifié par la propriété OADMaxNumRetry. La propriété OADAutoRestartAgent doit être définie sur true pour prendre effet.
La valeur par défaut est 10.
Heure d'arrêt de l'interrogation de la file d'attente des événements. Le format est HH:MM, où HH représente les heures (de 0 à 23) et MM représente les secondes (de 0 à 59).
Vous devez indiquer une valeur correcte pour cette propriété. La valeur par défaut est HH:MM, mais elle doit être modifiée.
Intervalle compris entre la fin de la dernière interrogation et le début de la suivante. La propriété PollFrequency indique la durée (en millisecondes) de l'intervalle compris entre la fin de la dernière interrogation et le début de l'interrogation suivante. Il ne s'agit pas de l'intervalle compris entre chaque interrogation. Plus précisément, la logique est la suivante :
Affectez à la propriété PollFrequency l'une des valeurs suivantes :
La valeur par défaut est 10000.
Désigne le nombre d'éléments de l'application pour lesquels le connecteur doit émettre des interrogations. Si l'adaptateur dispose d'une propriété spécifique au connecteur pour la définition du nombre d'interrogations, la valeur définie dans cette propriété spécifique remplace la valeur de la propriété standard.
FIX
Un courrier électronique est également considéré comme un événement. Lorsqu'il est interrogé sur un courrier électronique, le connecteur agit comme suit :
Première interrogation : le connecteur va sélectionner 1. le corps du message, étant donné qu'il est aussi considéré comme une pièce jointe. Si aucun gestionnaire de données n'a été spécifié pour ce type mime, il ignorera le corps de texte. 2. le connecteur traite la première pièce jointe du PO. Si un gestionnaire de données est disponible pour ce type mime, le connecteur envoie l'objet métier au Visual Test Connector (VTC). Si le 3. accept in VTC again no BO should come thru deuxième interrogation 1. le connecteur traite la deuxième pièce jointe du PO. Un gestionnaire de données est disponible pour ce type mime, il envoie donc le BO au VTC2. accept in VTC again now the third PO attachment should come through. Il s'agit du comportement correct du connecteur.
Heure de début de l'interrogation de la file d'attente des événements. Le format est HH:MM, dans lequel HH représente les heures (de 0 à 23) et MM représente les secondes (de 0 à 59).
Vous devez saisir une valeur correcte pour cette propriété. La valeur par défaut est HH:MM, mais elle doit être modifiée.
File d'attente utilisée par le courtier d'intégration pour envoyer des objets métier au connecteur.
La valeur par défaut est CONNECTOR/REQUESTQUEUE.
Emplacement du référentiel à partir duquel le connecteur lit les schémas XML qui stockent les métadonnées pour la définition des objets métier.
Lorsqu'ICS est le courtier d'intégration, cette valeur doit être définie sur <REMOTE>, car le connecteur obtient ces informations à partir du référentiel d'InterChange Server.
Lorsqu'un courtier de messages WebSphere ou WAS est le courtier d'intégration, cette valeur doit être définie sur <local directory>.
Applicable uniquement si DeliveryTransport a la valeur JMS et obligatoire uniquement si RepositoryDirectory a la valeur <REMOTE>.
Désigne la file d'attente de réponses JMS, qui transmet un message de réponse depuis la structure du connecteur vers le courtier d'intégration. Lorsqu'ICS est le courtier d'intégration, le serveur envoie la requête et attend un message de réponse dans la file d'attente de réponses JMS.
Indique le nombre de tentatives de redémarrage du connecteur. Lorsqu'elle est utilisée pour un connecteur parallèle, cette propriété indique le nombre de tentatives de redémarrage du composant spécifique à l'application du connecteur asservi par le composant spécifique à l'application du connecteur maître.
La valeur par défaut est 3.
Indique l'intervalle en minutes pendant lequel le connecteur tente de redémarrer. Lorsqu'elle est utilisée pour un connecteur parallèle, cette propriété indique l'intervalle de temps pendant lequel le composant spécifique à l'application du connecteur principal tente de redémarrer le composant spécifique à l'application du connecteur asservi. Les valeurs possibles varient de 1 à 2147483647.
La valeur par défaut est 1.
Courtiers de messages WebSphere et WAS uniquement.
Cette propriété vous permet de configurer la valeur du nom de domaine de la zone dans l'en-tête JMS. Lorsque les données sont envoyées au WMQI par transfert JMS, la structure de l'adaptateur écrit les informations de l'en-tête JMS, avec un nom de domaine et une valeur fixe mrm. Un nom de domaine configurable permet aux utilisateurs de suivre le mode de traitement des données du message par le courtier WMQI.
Voici un modèle d'en-tête :
<mcd><Msd>mrm</Msd><Set>3</Set><Type> Retek_POPhyDesc</Type><Fmt>CwXML</Fmt></mcd>
La valeur par défaut est mrm, mais elle peut également avoir la valeur xml. Cette propriété apparaît uniquement lorsque DeliveryTransport a la valeur JMS et que le format WF a la valeur CwXML.
Applicable uniquement si DeliveryTransport a la valeur JMS et que la propriété ContainerManagedEvents est spécifiée.
Désigne la file d'attente source JMS de la structure du connecteur qui assure la transmission d'événements garantie pour les connecteur activés par JMS qui utilisent un magasin d'événements JMS. Pour plus d'informations, voir ContainerManagedEvents.
La valeur par défaut est CONNECTOR/SOURCEQUEUE.
Applicable uniquement si DeliveryTransport a la valeur JMS.
Transmet les messages de requête qui requièrent une réponse synchrone de la structure du connecteur vers le courtier. Cette file d'attente est nécessaire uniquement si le connecteur utilise l'exécution synchrone. Avec l'exécution synchrone, la structure du connecteur envoie un message à la file d'attente SynchronousRequestQueue et attend une réponse de la part du courtier sur la file d'attente SynchronousResponseQueue. Le message de réponse envoyé au connecteur porte un ID de corrélation qui correspond à l'ID du message d'origine.
La valeur par défaut est CONNECTORNAME/SYNCHRONOUSREQUESTQUEUE.
Applicable uniquement si DeliveryTransport a la valeur JMS.
Transmet les messages de réponse à une requête synchrone entre le courtier et la structure du connecteur. Cette file d'attente est nécessaire uniquement si le connecteur utilise l'exécution synchrone.
La valeur par défaut est CONNECTORNAME/SYNCHRONOUSRESPONSEQUEUE.
Applicable uniquement si DeliveryTransport a la valeur JMS.
Indique la durée d'attente en minutes d'une réponse à une requête synchrone. Si la réponse n'est pas reçue dans l'intervalle de temps indiqué, le connecteur transfère le message de requête synchrone original, accompagné d'un message d'erreur, dans la file d'attente des erreurs.
La valeur par défaut est 0.
Format du message lors du transfert.
Courtiers d'intégration WAS uniquement.
Indique la durée d'attente en minutes d'une réponse à une requête synchrone. Si la réponse n'est pas reçue dans l'intervalle de temps indiqué, le connecteur transfère le message de requête synchrone original, accompagné d'un message d'erreur, dans la file d'attente des erreurs.
La valeur par défaut est 0.
Courtiers de messages WebSphere et courtier d'intégration WAS uniquement.
Propriété stricte permettant à l'utilisateur de spécifier des espaces de nom courts et longs des définitions des objets métier au format XML.