Activer la surveillance des événements entrants pour WebSphere Business Monitor

WebSphere Business Monitor vous permet d'activer la surveillance dans vos applications J2C entrantes.

Avant de commencer

Important : N'installez pas plusieurs adaptateurs de ressources de manière autonome sur le même serveur d'exécution, surtout s'ils sont destinés au même type de système d'information d'entreprise (par exemple, CICS ECI 8.0.0.0 et CICS ECI 8.0.0.1). En effet, tous les adaptateurs de ressources autonomes partagent le même chargeur de classes et, par conséquent, deux adaptateurs du même type mais de versions différentes ne peuvent pas cohabiter.
Important : La surveillance des événements entrants n'est utilisable dans vos applications que si WebSphere Business Monitor est installé dans votre environnement. Pour plus d'informations sur l'installation de WebSphere Business Monitor, voir : WebSphere Business Monitor. WebSphere Business Monitor v7 fonctionne avec WebSphere Application Server V7.x. Il n'est pas pris en charge dans WebSphere Application Server version v8.0. Pour plus d'informations sur les logiciels requis et leur configuration, voir la documentation de WebSphere Business Monitor. Pour savoir comment désactiver le moniteur d'événements, voir Désactivation du moniteur d'événements.

Procédure

  1. Sélectionnez Fichier > Nouveau > Autre > J2C.
  2. Sélectionnez Bean J2C puis cliquez sur Suivant.
  3. Sur la page Sélection des adaptateurs de ressources, sélectionnez le type d'adaptateur de ressources IMS que vous souhaitez utiliser.

    Adaptateurs de ressources disponibles prenant en charge WebSphere Business Monitor :

    • JD Edwards version 6.2.0.2 et 7.0.0.0.
    • Oracle version 6.2.0.2 et 7.0.0.0.
    • PeopleSoft version 6.2.0.1.
    • SAP version 6.2.0.2 et 7.0.0.0.
    • Siebel version 6.2.0.2 et 7.0.0.0.
    Sélection de l'adaptateur de ressources
  4. Lorsque vous avez sélectionné l'adaptateur de ressources approprié, cliquez sur Suivant.
  5. Dans la zone Projet de connecteur de la page d'importation de connecteur, acceptez le nom proposé par défaut ou tapez un autre nom pour votre projet. Dans la zone Serveur cible, sélectionnez WebSphere Application Serve V7 et cliquez sur Suivant.
    Page Importation de connecteur
  6. Dans la page des paramètres du connecteur, cliquez sur Parcourir pour sélectionnez tous les fichiers système SAP :
    • sapjco3.jar
    • sapjco3.dll
  7. Dans la page Style de l'adaptateur, sélectionnez Entrant et cliquez sur Activer la surveillance des événements entrants, puis cliquez sur Suivant.
    Page Style de l'adaptateur
  8. Dans la page de configuration des événements et de JMS, vous pouvez configurer le fournisseur JMS de la surveillance des événements.
    Informations de connexion
    1. Dans la zone Type d'événement, sélectionnez WebSphere Business Monitor.
    2. Dans la zone Nom JNDI de la fabrique de connexions de file d'attente, acceptez la valeur de jms/cei/EventQueueConnectionFactory proposée par défaut.
    3. Dans la zone Nom JNDI de la file d'attente, acceptez la valeur de jms/cei/EventQueue proposée par défaut.
    4. Cliquez sur Avancé pour définir les propriétés avancées :
      1. Configuration du fournisseur JNDI distant : vous permet de configurer la rubrique distante (ou la file d'attente distante pour la prise en charge de WebSphere Business Monitor).
        Remarque : Si le bus dans la cellule locale a le même nom que le bus dans une cellule distante, l'application se connecte toujours à la cellule locale. Elle n'utilise jamais les noeuds finaux de fournisseur spécifiés dans la fabrique de connexions ; les données que vous entrez à propos de la configuration de rubrique distante sont donc ignorées. Pour plus d'informations sur la configuration de rubrique distante, voir Configuration d'une connexion à un serveur d'amorçage autre que celui par défaut.
        1. Dans la zone Hôte de l'URL du fournisseur de noms, tapez la partie hôte de l'URL de votre serveur distant.
        2. Dans la zone Port de l'URL du fournisseur de noms, tapez le numéro de port de votre serveur distant.
      2. Dans la zone Nom d'utilisateur pour la configuration de l'authentification des connexions, indiquez votre nom d'utilisateur.
      3. Dans la zone Mot de passe pour la configuration de l'authentification des connexions, indiquez votre mot de passe.
  9. Cliquez sur Next.
  10. Dans la page Configuration de la découverte, indiquez les informations de connexion à votre serveur SAP :
    1. nom d'hôte (obligatoire) : le nom d'hôte du serveur SAP.
    2. numéro de système (obligatoire) : le numéro de système du serveur SAP.
    3. nom de serveur : le nom du serveur SAP.
    4. numéro de port : le numéro de port du serveur SAP.
    5. nom d'utilisateur (obligatoire) : le nom d'utilisateur pour la connexion au serveur SAP.
    6. mot de passe (obligatoire) : le mot de passe pour la connexion au serveur SAP.

      Pour définir les propriétés SAP avancées, cliquez sur Afficher les propriétés avancées.

  11. Dans la page Découverte et sélection d'objets, sélectionnez Découvrir les IDoc à partir du système et cliquez sur Filtrer :
    Page de découverte d'objets
  12. Dans la page des propriétés du filtrage de la détection d'IDoc à partir du système, entrez ORDER* dans la zone Masque des objets à trouver, et cliquez sur OK :
  13. Sélectionnez ORDERS05 et cliquez sur ADD :
    Ajouter un objet
  14. Dans la page des paramètres de configuration d'ORDERS05, acceptez les valeurs proposées par défaut et cliquez sur OK, puis cliquez sur Suivant :
    Page des propriétés de configuration
  15. Dans la page Configuration des propriétés composites, en regard de la zone Opérations de maintenance pour l'IDoc sélectionné, cliquez sur Ajouter et sélectionnez les actions que vous voulez effectuer sur les objets :
    Configuration des propriétés composites
  16. Dans la page Configuration des propriétés composites, en regard de la zone IDoc values to identify selected operations, cliquez sur Sélectionner les valeurs que vous voulez utiliser, puis cliquez sur OK.
  17. Dans la zone Dossier de la page Configuration des propriétés composites, entrez le nom du dossier où stocker l'objet métier généré, puis cliquez sur Suivant.
    Remarque : Créez un dossier qui contiendra les fichiers schéma qui sont générés pour faciliter l'exportation de ces fichiers et créer le modèle de moniteur. Les fichiers sont générés dans un sous-dossier eventMonitor du dossier que vous avez spécifié. Si vous ne spécifiez pas de nom de dossier, les fichiers schéma sont générés à la racine de votre projet, sans dossier conteneur.
  18. Dans la page Création et configuration du déploiement d'un bean J2C, entrez le nom de votre projet EJB (WBMSAPProject) et cliquez sur Nouveau pour créer un projet EJB. Dans la page du projet EJB :
    1. Vérifiez que WBMSAPProject figure bien dans la zone Nom du projet.
    2. Dans la zone Environnement d'exécution cible, sélectionnez WebSphere Application Server v7.
    3. Sélectionnez Appartenance à un EAR et entrez WBMSAPProjectEAR dans Nom du projet EAR.
    4. Acceptez les autres paramètres par défaut et cliquez sur Terminer.
      Page du projet EJB
  19. Dans la page Création et configuration du déploiement d'un bean J2C, vous pouvez créer une interface locale EJB, une classe auxiliaire, un bean session et un bean géré par message, destinés à contenir vos processus entrants. Notez qu'un EJB, un bean session et un bean géré par message sont tous créés automatiquement. Dans un modèle entrant, les beans gérés par message sont conçus pour recevoir des messages d'un système EIS externe. Tous les adaptateurs de ressources doivent implémenter javax.resource.spi.ResourceAdapter, qui a cinq méthodes. Le serveur d'applications accède à ces méthodes pour gérer le cycle de vie de l'adaptateur de ressources et fournit des notifications lorsqu'un noeud final de message est déployé ou dont le déploiement est annulé. Pour recevoir un message d'un système EIS spécifique, le destinataire (bean géré par message) doit afficher son intérêt à utiliser ce message en implémentant un écouteur de message. La classe ActivationSpec représente la configuration requise par l'adaptateur de ressources pour établir la connexion entre le système EIS et un bean géré par message. Les adaptateurs de ressources utilisent la classe ActivationSpec du bean MDB déployé pour créer et gérer une relation entre le système EIS et le MDB à l'aide de l'adaptateur de ressources. Pour configurer la classe ActivationSpec, en regard de la zone Nom JNDI, cliquez sur Nouveau.
    Création d'un bean J2C
  20. Dans la page de sélection de serveur, sélectionnez WebSphere Business Monitor Server v6.2 sur WebSphere Application Server, et cliquez sur Suivant :
    Page de sélection du serveur
  21. Dans la page Nouvelle spécification d'activation J2C, entrez les informations de connexion au système SAP et cliquez sur Terminer, et, de retour à la page Création et configuration du déploiement d'un bean J2C, cliquez sur Terminer.
    Page Spécification d'activation J2C
  22. Sélectionnez votre projet EJB, puis Projet > Nettoyer pour générer et recompiler les fichiers.
  23. Les artefacts suivants sont créés en même temps que cette application :
    • les fichiers de définition de schéma XML (.xsd) à utiliser pour les définitions d'événements ; ces fichiers sont situés dans le dossier eventMonitor
    • les enregistrements de données se trouvent dans le dossier ejbModule. Dans chacune des classes d'enregistrement de données, vous trouverez la définition de schéma correspondante
    • les classes Java™
      fichiers Java
      Tableau 1.
      WBMEJB.java Classe d'interface
      WBMEJBMDB.java MDB J2C
      WBMEJBMDBEventInterceptor.java Classe d'intercepteur d'événement
      WBMEJBMDBHelper.java Classe d'intercepteur d'événement
      WBMEJB.java Bean session
      Le bean J2C est à l'écoute des événements entrants et il se sert de l'intercepteur pour intercepter les événements et les transmettre au serveur via une file d'attente JMS.
  24. Déployez vers un serveur WebSphere Business Monitor ou un serveur distant l'application de l'adaptateur contenant le bean géré par message pour qu'elle puisse être à l'écoute des événements provenant du système EIS et qu'elle publie les événements vers l'infrastructure CEI. Pour des informations sur la publication d'événements vers WebSphere Business Monitor, voir Surveillance des événements du système EIS avec le serveur WebSphere Business Monitor.

Résultats


Commentaires