Administration des connecteurs

L'administration des connecteurs peut consister à démarrer, mettre en pause, arrêter et fermer des connecteurs. Pour plus d'informations sur la configuration des connecteurs, notamment la définition des propriétés, les objets métier pris en charge et les mappes associées, voir le Guide d'implémentation du système.

Vous pouvez démarrer, interrompre, arrêter et fermer des connecteurs à partir de System Monitor ou de System Manager et vous pouvez démarrer manuellement des connecteurs à l'aide de scripts sous Windows, sous OS/400 et sous i5/OS et Linux.

Le script du gestionnaire de connecteurs générique appelle le script start_connecteur .bat ou start_connecteur.sh approprié, qui prend en charge la gestion effective du connecteur (y compris l'arrêt). Le produit InterChange Server Express propose un script start_connecteur.bat ou start_connecteur.sh pour chaque connecteur fourni.

Cette section inclut les rubriques suivantes :

Affichage des états de connecteur

Démarrage, arrêt et mise en pause de connecteurs

Procédure de configuration du contrôle des flux pour les connecteurs

Procédure de modification des profils utilisateur pour les agents d'adaptateur sous OS/400 et i5/OS

Affichage des états de connecteur

Vous pouvez afficher l'état d'un connecteur en vous connectant à System Monitor et en accédant à une vue contenant les états de connecteur ou via la vue Gestion de composant InterChange Server, dans System Manager. Pour utiliser System Manager, appliquez les instructions de la section Procédure de connexion à une instance d'InterChange Server Express.

L'état d'un connecteur est représenté différemment, selon l'outil que vous utilisez.

Procédure d'utilisation de System Monitor pour afficher les états de connecteur

Pour afficher les états de connecteur dans System Monitor, procédez comme suit :

  1. Connectez-vous à System Monitor (voir Procédure de connexion à System Monitor).
  2. Si la vue Aperçu général du système n'apparaît pas, cliquez sur le lien Aperçu général du système sous Vues. Le moniteur Aperçu général du système s'affiche.

    Lorsque le produit est installé, la vue par défaut est Aperçu général du système et le moniteur par défaut de cette vue est également Aperçu général du système. Ces valeurs par défaut peuvent être adaptées à vos exigences en matière de surveillance. Voir Définition de vues pour surveiller le système pour plus d'instructions.

  3. Cliquez sur le triangle en regard du nom du serveur pour afficher la liste des composants du système.
  4. Cliquez sur le triangle en regard d'une collaboration en cours d'exécution pour afficher les connecteurs associés (voir figure 27).
    Figure 27. System Monitor, Aperçu général du système affichant l'état des connecteurs

Procédure d'utilisation de System Manager pour afficher les états de connecteur

Pour afficher l'état d'un connecteur dans System Manager, procédez comme suit :

  1. Connectez-vous à une instance d'InterChange Server Express contenant le connecteur que vous souhaitez afficher. Pour plus d'instructions sur la connexion à une instance d'InterChange Server Express, voir Procédure de connexion à une instance d'InterChange Server Express.
  2. Développez l'instance d'InterChange Server Express, puis le dossier Connecteurs.

    Les connecteurs apparaissent sous le dossier Connecteurs ouvert, en différentes couleurs indiquant les différents états.

    Figure 28. Dossier Connecteurs dans la vue Gestion de composant InterChange Server

Le tableau 6 répertorie les états de connecteur représentés par la couleur d'affichage de chaque connecteur et indique les actions effectuées dans ces états.

Tableau 6. Etats de connecteur
Etat de connecteur (couleur) Requêtes de souscription traitées Requêtes d'appel de service traitées Envois de souscriptions traités
Actif (vert) Oui Oui Oui
En pause (jaune) Oui Oui Non
En reprise ou inconnu (gris)
Inactif (rouge) Non Non Non

Démarrage, arrêt et mise en pause de connecteurs

Cette section décrit comment démarrer, arrêter et mettre en pause des connecteurs.

Cette section traite des points suivants :

Initialisation d'un connecteur

Procédure de démarrage, d'arrêt et de mise en pause de connecteurs

Commandes System Manager de modification des états de connecteur

Procédure de démarrage manuel d'un connecteur sous Windows

Procédure de démarrage manuel d'un connecteur sous OS/400 et i5/OS

Procédure de démarrage manuel d'un connecteur sous Linux

Arrêt d'un connecteur

Redémarrage d'un connecteur

Procédure de définition de redémarrage automatique et à distance d'un connecteur

Procédure d'utilisation d'OAD sous forme de service Windows

Initialisation d'un connecteur

Lorsque vous démarrez un connecteur pour la première fois, vous devez d'abord l'initialiser. Cette opération implique que vous démarriez le connecteur manuellement. Pour plus d'instructions sur le démarrage manuel d'un connecteur, voir Procédure de démarrage manuel d'un connecteur sous Windows.

Si le connecteur ne démarre pas, vérifiez que la ligne de commande utilisée pour le démarrer contient le nom en cours d'InterChange Server Express. Pous plus d'informations, consultez le guide d'installation de WebSphere Business Integration Server Express pour Windows, pour Linux ou pour OS/400 et i5/OS.

Procédure de démarrage, d'arrêt et de mise en pause de connecteurs

Une fois le connecteur initialisé, vous pouvez le démarrer, l'arrêter et le mettre en pause à partir de System Monitor ou System Manager.

Pour démarrer, arrêter et mettre en pause des connecteurs dans System Monitor, procédez comme suit :

  1. Dans la vue Aperçu général du système (voir figure 27), spécifiez un connecteur en sélectionnant la case à sa gauche.
  2. Sélectionnez l'icône Démarrer, Mettre en pause ou Arrêter dans le groupe d'icônes, dans l'angle supérieur gauche de la vue (voir figure 29).

Figure 29. System Monitor, icônes de démarrage, mise en pause, redémarrage ou arrêt des composants

Pour démarrer, arrêter et mettre en pause des connecteurs dans System Manager, procédez comme suit :

  1. Dans System Manager, placez-vous dans le dossier Connecteurs de la vue Gestion de composant InterChange Server (voir figure 28).
  2. A l'aide du bouton droit de la souris, cliquez sur le nom d'un connecteur, puis sélectionnez Démarrer Nom_connecteur, Mettre en pause Nom_connecteur ou Arrêter Nom_connecteur.

Commandes System Manager de modification des états de connecteur

La liste suivante contient les commandes que vous pouvez utiliser pour modifier l'état d'un connecteur et décrit les actions de traitement correspondantes :

Démarrer Nom_connecteur
Démarre le connecteur sélectionné s'il est en pause ou arrêté. Les connecteurs interrogent l'application et les contrôleurs de connecteur lisent la file d'attente persistante. Les flux sont traités.
Mettre en pause Nom_connecteur
Met en pause le connecteur sélectionné s'il est en cours d'exécution ou arrêté. Les connecteurs cessent d'interroger l'application et les contrôleurs de connecteur cessent de lire les nouvelles requêtes, mais le traitement des événements se poursuit.
Arrêter Nom_connecteur
Arrête le connecteur sélectionné s'il est en cours d'exécution ou en pause. Les connecteurs cessent d'interroger l'application et provoquent l'échec des requêtes, avec un message d'exception. Les contrôleurs de connecteur cessent de lire la file d'attente persistante. Les flux et les requêtes ne sont pas traités.
Quitter Nom_connecteur
Quitte le connecteur sélectionné. Le processus du connecteur est arrêté.
Lancer Nom_connecteur
Relance le connecteur sélectionné. Cette action est disponible uniquement si vous avez défini la propriété OADAutoRestartAgent du connecteur par True. Voir Procédure de définition de redémarrage automatique et à distance d'un connecteur.

Procédure de démarrage manuel d'un connecteur sous Windows

Lorsque vous installez IBM WebSphere Business Integration Adapters, un raccourci est créé pour chaque connecteur installé, dans le menu du programme IBM WebSphere. Le connecteur est défini dans le référentiel d'InterChange Server Express et il est chargé lorsque vous chargez le référentiel.

Le démarrage d'InterChange Server Express initialise automatiquement chaque connecteur défini dans le référentiel. Le connecteur est disponible pour utilisation dès qu'InterChange Server Express s'exécute.

Remarque :
Pour qu'un connecteur soit fonctionnel lors de sa première utilisation, vous devez le configurer avant de le démarrer. Consultez le guide des cartes relatives aux connecteurs que vous utilisez pour connaître les instructions de configuration.

Exécutez l'une des étapes suivantes pour démarrer le connecteur :

Vous pouvez personnaliser le démarrage pour chaque connecteur en modifiant le raccourci du connecteur ou le fichier start_connecteur.bat. Utilisez les paramètres de démarrage du connecteur indiqués dans le tableau 7 pour personnaliser le démarrage d'un connecteur. -

Tableau 7. Paramètres de démarrage de connecteur
Paramètre Fonction
-b Déclenche l'exécution de l'agent d'adaptateur en processus d'arrière-plan. Cela évite que l'agent ne tente de lire le caractère 'q' (quit) dans les entrées système. Les agents qui lisent les informations dans les entrées système réduisent les performances des agents qui s'exécutent dans un sous-système iSeries.
-c Fichier_config Nom du fichier de configuration à utiliser lors du démarrage. Si le nom du fichier contient un chemin relatif, le script de démarrage recherche le fichier dans le répertoire d'installation du produit. Ce paramètre est requis uniquement si vous utilisez un fichier de configuration de connecteur local. Si tel n'est pas le cas, entrez le nom du fichier de configuration utilisé par IBM WebSphere InterChange Server Express (par défaut, InterchangeSystem.cfg).
-c Déclenche l'utilisation du fichier de configuration par défaut si le fichier de configuration spécifié par l'utilisateur n'existe pas.
-d Spécifie le nom du fichier de bibliothèque du connecteur C++, lequel est une bibliothèque de liens dynamiques (DLL). Ce nom de DLL ne contient pas l'extension de fichier .dll. Le script de démarrage spécifie cette option pour tous les connecteurs C++.
-f Fréquence_interrog. La fréquence d'interrogation est le nombre de millisecondes entre deux actions d'interrogation.
  • Pour indiquer le nombre de millisecondes, entrez une valeur pour Fréquence_interrogation.
  • Pour que le connecteur exécute une interrogation uniquement lorsque vous entrez la valeur p dans la fenêtre d'invite de commande du connecteur, indiquez l'option -fkey.
  • Si un connecteur est configuré pour traiter uniquement les demandes d'objet métier et non les événements d'application, l'interrogation n'est pas nécessaire ; vous pouvez désactiver l'interrogation en spécifiant l'option -fno.
La valeur de ce paramètre remplace toutes les définitions de référentiel. Vous pouvez indiquer -fkey ou -fno, mais pas les deux options simultanément.
-j Indique que le connecteur est écrit en Java. Ce paramètre est facultatif si vous indiquez l'option -l Nom_classe.
-l Nom_classe Indique le nom de la classe globale du connecteur Java, laquelle est une extension de la classe de base du connecteur. Le script de démarrage spécifie cette option pour tous les connecteurs Java.
-n Nom_connecteur Indique le nom du connecteur à démarrer.
-p mot_de_passe Indique le mot de passe utilisé par le connecteur pour accéder à InterChange Server Express.
-s Nom_serveur Indique le nom du serveur. Ce paramètre est requis. Ce nom respecte la distinction majuscules/minuscules.
-t Active la propriété de connecteur SingleThreadAppCalls. Cette propriété garantit que tous les appels effectués par l'architecture du connecteur vers le code de connecteur spécifique d'une application comportent un flux déclenché par événement. La valeur par défaut est false. Important : ne modifiez pas la valeur d'origine de cette propriété. Le paramètre approprié est défini pour chaque connecteur selon son modèle d'unité d'exécution. Définissez cette option uniquement lorsque vous démarrez un connecteur que vous avez créé.
-x Props_connecteur Transmet les propriétés de connecteur spécifiques d'une application au connecteur. Utilisez le format prop_name=valeur pour chaque valeur entrée.

Procédure de démarrage manuel d'un connecteur sous OS/400 et i5/OS

Les agents de connecteur s'exécutant sur un système OS/400 et i5/OS sont généralement démarrés et arrêtés de l'une des trois façons ci-après.

Exécutez l'une des étapes suivantes pour démarrer manuellement un connecteur sous OS/400 et i5/OS :

Procédure de démarrage manuel d'un connecteur sous Linux

Exécutez l'une des étapes suivantes pour démarrer manuellement un connecteur sous Linux :

Arrêt d'un connecteur

Cette section traite des points suivants :

Procédure d'arrêt d'un connecteur dans System Monitor

Procédure d'arrêt d'un connecteur dans System Manager

L'arrêt d'un connecteur interrompt les processus du connecteur. Avant d'arrêter un connecteur, mettez en pause ou arrêtez tout objet de collaboration utilisant le connecteur (vous devez configurer la collaboration pour qu'elle prenne en charge la mise en pause ; voir la documentation relative à la collaboration pour plus d'instructions). Si la case Mettre en attente lorsqu'une erreur grave se produit est cochée dans la fenêtre Propriétés générales de collaboration, la collaboration se met automatiquement en pause lorsqu'une erreur grave se produit. Les derniers événements non traités de ces collaborations sont alors déplacés dans la file d'attente de soumission des événements.

Vous pouvez effectuer un arrêt "définitif" ou "temporaire" du connecteur. Vous pouvez contrôler le type d'arrêt en activant ou désactivant le redémarrage automatique (par défaut) :

Pour plus d'instructions sur l'activation ou la désactivation du redémarrage automatique, voir Procédure de définition de redémarrage automatique et à distance d'un connecteur.

Les instructions relatives à l'arrêt d'un connecteur varient selon l'outil utilisé pour surveiller le système :

Procédure d'arrêt d'un connecteur dans System Monitor

Pour arrêter un connecteur dans System Monitor, procédez comme suit :

  1. Dans la vue Aperçu général du système, sélectionnez l'objet de collaboration relatif au connecteur à arrêter, en cochant la case à sa gauche, puis cliquez sur le bouton Mettre en pause, dans l'angle supérieur gauche de la vue (voir figure 29). Répétez cette opération pour chaque collaboration associée au connecteur.
  2. Cochez la case en regard du connecteur à arrêter et cliquez sur le bouton Arrêter, dans l'angle supérieur gauche de la vue (voir figure 29).
Procédure d'arrêt d'un connecteur dans System Manager

Pour arrêter un connecteur dans System Manager, procédez comme suit :

  1. Développez le dossier Objets de collaboration, dans la vue Gestion de composant InterChange Server (voir figure 32).
  2. Cliquez, à l'aide du bouton droit de la souris, sur l'objet de collaboration associé au connecteur et cliquez sur Mettre en pause Nom_Collaboration. Répétez cette opération pour chaque collaboration associée au connecteur.

    Sur l'icône de l'objet de collaboration, deux lignes verticales apparaissent.

  3. A partir du dossier Connecteurs ouvert dans la vue Gestion de composant InterChange Server, cliquez, à l'aide du bouton droit de la souris, sur le connecteur, puis cliquez sur Arrêter Nom_Connecteur.
Attention :
N'utilisez pas Ctrl+C ni la commande CL ENDJOB pour arrêter un connecteur. Cette méthode arrête en effet le connecteur de manière incorrecte. En outre, si vous utilisez la séquence de touches Ctrl+C, la commande CL ENDJOB ou "q", ou encore d'autres méthodes manuelles pour procéder à l'arrêt, et si le programme Object Activation Daemon (OAD) est activé, OAD redémarre immédiatement le connecteur.

Redémarrage d'un connecteur

Les procédures décrites dans cette section relancent le connecteur après que vous avez utilisé l'action d'arrêt du connecteur dans System Monitor ou dans System Manager, dans la vue Gestion de composant InterChange Server. Cette action est disponible uniquement si vous avez activé le redémarrage automatique et à distance pour le connecteur (voir Procédure de définition de redémarrage automatique et à distance d'un connecteur).

Cette section traite des points suivants :

Procédure d'utilisation de System Monitor pour redémarrer un connecteur

Procédure d'utilisation de System Manager pour redémarrer un connecteur

Procédure d'utilisation de System Monitor pour redémarrer un connecteur

Pour redémarrer un connecteur dans System Monitor, procédez comme suit :

  1. Dans la vue Aperçu général du système (voir figure 27), cochez la case à gauche du connecteur que vous souhaitez redémarrer.
  2. Cliquez sur le bouton Redémarrer l'agent dans l'angle supérieur gauche de la vue (voir figure 29).
Procédure d'utilisation de System Manager pour redémarrer un connecteur

Pour redémarrer un connecteur dans System Manager, procédez comme suit :

  1. Développez le dossier Connecteurs dans la vue Gestion de composant InterChange System, (voir figure 28).
  2. Cliquez, à l'aide du bouton droit de la souris, sur le connecteur à redémarrer, puis cliquez sur Lancer Nom_Connecteur.

Procédure de définition de redémarrage automatique et à distance d'un connecteur

A l'aide du programme Object Activation Daemon (OAD), déclenché par IBM WebSphere MQ, vous pouvez activer un connecteur afin qu'il prenne en charge la fonction de redémarrage automatique et à distance, ce qui lui permet de vérifier les conditions suivantes :

Cette section traite des points suivants :

Procédure de définition de redémarrage automatique et à distance d'un connecteur sous Windows

Procédure de définition de redémarrage automatique et à distance d'un connecteur sous Linux

Procédure de redémarrage automatique et à distance d'un connecteur sous OS/400 et i5/OS

Procédure d'activation des connecteurs pour MQ-triggered OAD

Procédure de définition de redémarrage automatique et à distance d'un connecteur sous Windows

Pour définir le redémarrage automatique et à distance d'un connecteur sur une plateforme Windows, procédez comme suit :

  1. Installez IBM WebSphere MQ.

    Pour utiliser le programme MQ-triggered OAD, vous devez installer MQ-trigger Monitor et configurer certaines files d'attente. Ce moniteur fait partie de l'installation du logiciel WebSphere MQ. Ces files d'attente sont créées et configurées par un script spécial mqtriggersetup.bat .

    Important :
    WebSphere MQ-trigger Monitor doit être installé sur le poste où se trouve l'agent de connecteur. Si plusieurs agents de connecteur se trouvent sur un même poste, installez un seul exemplaire de MQ-trigger Monitor.
  2. Lancez MQ-trigger Monitor.
    Pour lancer MQ-triggered OAD, vous devez démarrer MQ-trigger Monitor, de l'une des façons suivantes :
  3. Configurez un connecteur pour le redémarrage automatique et à distance. Voir Procédure d'activation des connecteurs pour MQ-triggered OAD ci-après.
  4. Exécutez le script mqtriggersetup.bat (situé dans le répertoire bin) pour chaque connecteur devant être redémarré, par exemple :
    mqtriggersetup.bat WebSphereICS.queue.manager JDBC WebSphereICS D:/IBM/WebSphereServer/connectors/JDBC/start_JDBC.bat
Procédure de définition de redémarrage automatique et à distance d'un connecteur sous Linux

Pour définir le redémarrage automatique et à distance d'un connecteur sur une plateforme Linux, procédez comme suit :

Les arguments du fichier sont les suivants :

Par exemple :

mqtriggersetup 
 WebSphereICS.queue.manager 
 JDBC 
 /home/smbadmin/IBM/WebSphereItemSync/connectors/JDBC/start_JDBC.sh 
 JDBC WebSphereICS
Procédure de redémarrage automatique et à distance d'un connecteur sous OS/400 et i5/OS

Pour activer le redémarrage automatique et à distance d'un connecteur sur une plateforme OS/400 et i5/OS, procédez comme suit :

  1. Exécutez mqtriggersetup.sh avec les arguments requis pour ajouter et configurer une file d'attente afin de transférer l'événement déclencheur. Ce fichier se trouve dans le répertoire d'installation du produit, par exemple, /QIBM/ProdData/WBIServer44/bin. Les arguments du fichier sont les suivants : Par exemple :
    mqtriggersetup.sh 
     Nom_Instance.QUEUE.MANAGER 
     JDBC 
     /QIBM/UserData/WBIServer44/QWBIDFT44/connectors/JDBC/start_JDBC.sh 
     Nom_Instance 
     QWBIJDBCC 
    Nom_Instance désigne le nom de l'instance d'InterChange Server Express, en lettres majuscules.
  2. Activez WebSphere MQ Trigger Monitor. Par exemple :
    STRMQMTRM INITQNAME(INITIATION.QUEUE)
     MQMNAME(Nom_Instance.QUEUE.MANAGER)
    Nom_Instance désigne le nom de l'instance d'InterChange Server Express, en lettres majuscules.
  3. Octroyez au profil utilisateur QMQM le droit *USE sur les objets suivants :
    Description du travail (*JOBD) de l'adaptateur (par exemple, QWBISVR44/QWBIJDBCC pour JDBC)
Procédure d'activation des connecteurs pour MQ-triggered OAD

Pour lancer Connector Configurator Express pour le connecteur avant de définir les propriétés OAD, procédez comme suit :

  1. Lancez InterChange Server Express.
  2. Ouvrez System Manager.
  3. Cliquez deux fois sur le connecteur, sous Bibliothèques des composants d'intégration. La fenêtre Connector Configurator Express s'ouvre.
  4. Sur l'onglet Propriétés standard, définissez les propriétés standard illustrées dans le tableau 8.

    Tableau 8. Configuration des propriétés standard dans Connector Configurator Express
    Nom Valeurs possibles Description Valeurs par défaut
    OADAutoRestartAgent true ou false Si cette propriété est activée, MQ-triggered OAD tente automatiquement de redémarrer le connecteur après un arrêt anormal. Elle permet également de démarrer l'agent de connecteur à distance. Cette valeur est dynamique. false
    OADMaxNumRetry Nombre Nombre maximal de tentatives. 10 000
    OADRetryTimeInterval Minutes Durée en minutes entre chaque nouvelle tentative. Si l'agent de connecteur ne démarre pas pendant ce laps de temps, une nouvelle tentative de redémarrage est effectuée. 10

A partir de Connector Configurator Express, vous pouvez effectuer les actions suivantes :

Procédure d'utilisation d'OAD sous forme de service Windows

Remarque :
Cette rubrique s'applique uniquement aux plateformes Windows.

Si vous configurez un connecteur pour le redémarrage automatique ou à distance à l'aide d'OAD, ne configurez pas le connecteur pour une exécution sous forme de service Windows automatique. Installez WebSphere MQ Trigger Monitor pour qu'il s'exécute comme un service Windows. Lorsque le système démarre, OAD démarre automatiquement en tant que service Windows ; lorsqu'InterChange Server Express redémarre, il lance le connecteur via le programme OAD.

Important :
Par défaut, les connecteurs sont installés en tant que services Windows nécessitant un démarrage manuel. La fonction de redémarrage à distance ne s'exécute pas si le service Windows du connecteur est modifié de manuel en automatique.

Pour installer WebSphere MQ Trigger Monitor en tant que service Windows, procédez comme suit

  1. Sélectionnez Démarrer > Programmes > IBM WebSphere MQ > WebSphere MQ Services.
  2. A l'aide du bouton droit de la souris, cliquez sur le gestionnaire de files d'attente utilisé par WebSphere Business Integration Server Express, puis cliquez sur New > Trigger Monitor. La boîte de dialogue Create Trigger Monitor Service apparaît.
  3. Cliquez sur l'onglet Parameters. Dans la zone de nom de file d'attente, entrez la chaîne "INITIATION.QUEUE". Dans la colonne Description, Trigger Monitor apparaît dans la liste des services pour ce gestionnaire de files d'attente.
  4. Exécutez l'outil de configuration des services Windows. Sélectionnez InterChange Server Express dans la liste des composants de service.
  5. Dans la zone des dépendances de service, entrez le nom du service Windows OAD.

Après avoir effectué ces opérations, vous pouvez utiliser l'outil de configuration de services de Windows pour lancer et arrêter le programme démon.

Procédure de configuration du contrôle des flux pour les connecteurs

Le contrôle des flux est un service configurable vous permettant de gérer le flux des files d'attente de connecteurs et d'objets de collaboration. Les paramètres de configuration du contrôle des flux peuvent être définis pour l'ensemble du système, pour des composants individuels ou les deux. Si vous définissez les deux configurations, celle des composants individuels est prioritaire sur celle du système. Pour plus d'instructions sur la configuration du contrôle de flux sur l'ensemble du système, voir Procédure de configuration du contrôle des flux sur l'ensemble du système. Cette section décrit le mode de configuration du contrôle des flux au niveau des connecteurs.

Remarque :
Les modifications de configuration des connecteurs ou des objets de collaboration individuels sont dynamiques, ce qui signifie qu'il est inutile de réamorcer le système InterChange Server Express. Les modifications de configuration sur l'ensemble du système pour le contrôle des flux requièrent le réamorçage d'InterChange Server Express.

Pour surveiller le mode de fonctionnement du contrôle de flux dans le système, vous pouvez afficher le moniteur et la vue Contrôle de flux fournis avec System Monitor ou vous pouvez afficher les Statistiques sur les objets de collaboration ou les connecteurs à partir de System Manager dans la vue Gestion de composant InterChange Server. Pour plus d'informations sur l'utilisation du moniteur et de la vue Contrôle des flux dans System Monitor, voir Procédure de révision des moniteurs par défaut et Procédure d'utilisation des vues par défaut. Pour plus d'informations sur l'affichage du contrôle des flux dans la vue Gestion de composant InterChange Server, voir Procédure de visualisation des statistiques sur les objets de collaboration ou Procédure de visualisation des statistiques de connecteur.

Pour configurer le contrôle des flux sur un connecteur, procédez comme suit :

  1. Dans System Manager, naviguez vers le connecteur pour lequel vous souhaitez configurer le contrôle des flux, puis cliquez deux fois sur ce connecteur. La fenêtre Connector Configurator Express apparaît (voir figure 30).
    Figure 30. Connector Configurator Express, onglet Propriétés standard
  2. Dans l'onglet Propriétés standard, cliquez dans la cellule Valeur de la propriété MaxEventCapacity.
  3. Remplacez la valeur par le nombre maximal d'événements que vous souhaitez mettre en file d'attente pour un connecteur. La valeur admise de cette propriété est comprise entre 1 et 2147483647.
  4. Cliquez sur Fichier > Sauvegarde> Dans le projet. Le message suivant apparaît dans la partie inférieure de la fenêtre Connector Configurator Express : Le connecteur 'Nom_connecteur' a été correctement sauvegardé.
  5. Redéployez le connecteur.

Procédure de modification des profils utilisateur pour les agents d'adaptateur sous OS/400 et i5/OS

Par défaut, les agents d'adaptateur sous OS/400 et i5/OS s'exécutent sous le profil utilisateur QWBISVR44. Ce profil utilisateur dispose donc du droit de lecture et éventuellement de mise à jour sur les informations d'application. Si vous ne pouvez pas accorder ce droit au profil QWBISVR44, vous pouvez modifier le profil utilisateur associé au processus de l'agent d'adaptateur.

Pour modifier le profil utilisateur du processus de l'agent d'adaptateur, procédez comme suit :

  1. Modifiez la description du travail de l'agent d'adaptateur à l'aide de la commande CL CHGJOBD comme suit :
    CHGJOBD JOBD(QWBISVR44/nom_desc_travail) USER(nouvel_id)
    nom_desc_travail désigne le nom de la description du travail pour l'agent d'adaptateur et nouvel_id le profil utilisateur sous lequel l'agent d'adaptateur doit s'exécuter. Le profil utilisateur nouvel_id doit préalablement disposer des droits sur les informations de votre application.
  2. Accordez les droits sur la description du travail de l'adaptateur pour votre profil utilisateur à l'aide de la commande CL suivante :
    GRTOBJAUT OBJ(QWBISVR44/nom_desc_travail) OBJTYPE(*JOBD) USER(nouvel_id)
    nom_desc_travail désigne le nom de la description du travail pour l'agent d'adaptateur et nouvel_id le profil utilisateur sous lequel l'agent d'adaptateur doit s'exécuter.
  3. Accordez les droits sur la bibliothèque QWBISVR44 pour votre profil utilisateur à l'aide de la commande CL suivante :
    GRTOBJAUT OBJ(QWBISVR44) OBJTYPE(*LIB) USER(nouvel_id)
    nouvel_id est le profil utilisateur sous lequel l'agent d'adaptateur doit s'exécuter.
  4. Accordez les droits sur la description du sous-système QWBISVR44 pour votre profil utilisateur à l'aide de la commande CL suivante :
    GRTOBJAUT OBJ(QWBISVR44/QWBISVR44) OBJTYPE(*JOBD) USER(nouvel_id)
    nouvel_id est le profil utilisateur sous lequel l'agent d'adaptateur doit s'exécuter.
  5. Accordez les droits sur la classe QWBISVR44 de la bibliothèque QWBISVR44 pour votre profil utilisateur à l'aide de la commande CL suivante :
    GRTOBJAUT OBJ(QWBISVR44/QWBISVR44) OBJTYPE(*CLS) USER(nouvel_id)
    nouvel_id est le profil utilisateur sous lequel l'agent d'adaptateur doit s'exécuter.
  6. Accordez les droits sur le répertoire du connecteur où se trouve le script de démarrage de l'adaptateur correspondant à votre profil utilisateur, à l'aide de la commande CL suivante :
    CHGAUT OBJ('/chemin_script_de_démarrage') USER(nouvel_id) DTAAUT(*RWX)
    chemin_script_de_démarrage est le chemin d'accès au script de démarrage de l'adaptateur et nouvel_id le profil utilisateur sous lequel l'agent d'adaptateur doit s'exécuter.

Copyright IBM Corp. 2004, 2005