Configuration de la coordination globale avec Sybase

Configurez votre environnemen IBM® App Connect Enterprise e afin de coordonner globalement les transactions de flux de messages avec les mises à jour des bases de données d' Sybase, sous le contrôle d'un gestionnaire de files d'attente.

1. Exécutez la commande mqsimanagexalinks .
2. Configurez le gestionnaire de file d'attente du nœud d'intégration en lui fournissant les informations relatives au gestionnaire de ressources d' XA s pour chaque base de données impliquée dans la transaction que le gestionnaire de file d'attente coordonnera à l'échelle globale.

   Sous Linux® et UNIX:

   1. Ouvrez le fichier qm.ini du gestionnaire de files d'attente dans un éditeur de texte.
      Le fichier qm.ini se trouve dans /var/mqm/qmgrs/queue_manager_name/qm.ini, où nom_gestionnaire_files d'attente est le nom du noeud d'intégration associé au gestionnaire de files d'attente.
   2. A la fin du fichier qm.ini , collez la strophe suivante:

      XAResourceManager:
          Name=SYBASEXA
          SwitchFile=UKasedtc95.so
          XAOpenString=-NSYBASEDB -AMyServerName,MyPortNumber -Uuid -Ppwd -K2
          XACloseString=
          ThreadOfControl=THREAD
      

   3. Sur la ligne XAOpenString , remplacez les valeurs suivantes par les valeurs appropriées à votre configuration:
      • MyServerName est le nom de l'hôte de l' TCP/IP qui héberge le serveur ASE Sybase.
      • MyPortNumber est le port d' TCP/IP s sur lequel le serveur ASE de Sybase est à l'écoute.
      • uid doit être le nom d'utilisateur utilisé par le noeud d'intégration pour se connecter à la base de données.
        Vous pouvez définir le nom d'utilisateur utilisé par le noeud d'intégration de différentes manières ; veillez à spécifier le nom correct dans ce fichier. Le noeud d'intégration détermine le nom d'utilisateur en vérifiant les conditions suivantes dans l'ordre indiqué:

        1. Un nom d'utilisateur et un mot de passe spécifiques pour ce nom de source de données (DSN), que vous avez définis en exécutant la commande mqsisetdbparms .
        2. Un nom d'utilisateur et un mot de passe par défaut pour tous les DSN que vous avez définis en exécutant la commande mqsisetdbparms .
        3. Nom d'utilisateur du service de noeud d'intégration, que vous définissez avec le paramètre -i dans la commande mqsicreatebroker
      • pwd est le mot de passe associé au nom d'utilisateur.
   4. Acceptez les valeurs par défaut pour toutes les autres lignes de la strophe.
      Par exemple :

      • Sous AIX®:

        XAResourceManager:
            Name=SYBASEXA
            SwitchFile=UKasedtc95.so
            XAOpenString=-NSYBASEDB -Adiaz,4100 -Uwbrkuid -Pwbrkpw -K2
            XACloseString=
            ThreadOfControl=THREAD
        

   Sous Windows:
   1. Dans le menu Démarrer, ouvrez l'Explorateur de fichiers de l' IBM MQ.
   2. Ouvrez la boîte de dialogue Propriétés, puis ouvrez les gestionnaires de ressources d' XA.
   3. Dans la zone SwitchFile , entrez le nom du fichier de commutation, ukase95.dll.
   4. Dans la zone XAOpenString , collez la chaîne suivante:

      -NSYBASEDB -AMyServerName,MyPortNumber -WWinsock -Uuid -Ppwd -K2

   5. Dans la zone XAOpenString , remplacez les valeurs par les valeurs appropriées à votre configuration:
      • install_dir correspond à l'emplacement où IBM App Connect Enterprise est installé.
      • MyServerName est le nom de l'hôte de l' TCP/IP qui héberge le serveur ASE Sybase.
      • MyPortNumber est le port d' TCP/IP s sur lequel le serveur ASE de Sybase est à l'écoute.
      • uid doit être le nom d'utilisateur utilisé par le noeud d'intégration pour se connecter à la base de données.
        Vous pouvez définir le nom d'utilisateur utilisé par le noeud d'intégration de différentes manières ; veillez à spécifier le nom correct dans ce fichier. Le noeud d'intégration détermine le nom d'utilisateur en vérifiant les conditions suivantes dans l'ordre indiqué:

        1. Un nom d'utilisateur et un mot de passe spécifiques pour ce nom de source de données (DSN), que vous avez définis en exécutant la commande mqsisetdbparms .
        2. Un nom d'utilisateur et un mot de passe par défaut pour tous les DSN que vous avez définis en exécutant la commande mqsisetdbparms .
        3. Nom d'utilisateur du service de noeud d'intégration, que vous définissez avec le paramètre -i dans la commande mqsicreatebroker
      • pwd est le mot de passe associé au nom d'utilisateur.
      Par exemple :

      -NSYBASEDB -Adiaz,4100 -WWinsock -Uwbrkuid -Pwbrkpw -K2

   6. Acceptez les valeurs par défaut pour toutes les autres zones de la page.
3. Le fichier de commutation de l' Sybase e est fourni par IBM App Connect Enterprise et utilise l'enregistrement statique XA (voir « Configuration des bases de données pour la coordination globale des transactions »).
4. Arrêtez, puis redémarrez le gestionnaire de files d'attente pour appliquer les modifications, car qm.ini est en lecture seule pendant que le gestionnaire de files d'attente est en cours d'exécution. Avant de redémarrer le gestionnaire de files d'attente, vérifiez que les variables d'environnement ODBCINI et ODBCSYSINI ont été exportées et que l'ID utilisateur sous lequel les processus du gestionnaire de files d'attente s'exécuteront dispose d'un accès en lecture aux fichiers odbc.ini et odbcinst.ini .
   Pour arrêter et redémarrer le gestionnaire de files d'attente, entrez les commandes suivantes, où nom_gestionnaire_files d'attente est le nom du gestionnaire de files d'attente:

   endmqm queue_manager_name
   strmqm queue_manager_name

   Lorsque le gestionnaire de files d'attente redémarre, recherchez dans le journal du gestionnaire de files d'attente tous les avertissements associés au redémarrage. Les fichiers journaux se trouvent dans /var/mqm/qmgrs/queue_manager_name/errors, où nom_gestionnaire_files_attente est le nom du gestionnaire de files d'attente que vous avez redémarré.

   Lorsque le gestionnaire de files d'attente redémarre correctement, les modifications que vous avez apportées à qm.ini sont appliquées.
5. Arrêtez, puis redémarrez le gestionnaire de files d'attente pour appliquer les modifications.
   Pour arrêter et redémarrer le gestionnaire de files d'attente, entrez les commandes suivantes, où nom_gestionnaire_files d'attente est le nom du gestionnaire de files d'attente:

   endmqm queue_manager_name
   strmqm -si queue_manager_name

   Lorsque le gestionnaire de files d'attente redémarre, recherchez dans le journal du gestionnaire de files d'attente tous les avertissements associés au redémarrage. Les fichiers journaux se trouvent dans install_dir\WebSphere MQ\Qmgrs\QMGR\errors, où install_dir correspond à l'emplacement où le nœud d'intégration est installé et QMGR au nom de votre gestionnaire de files d'attente d' IBM MQ.

   Lorsque le gestionnaire de files d'attente redémarre correctement, les modifications que vous avez apportées sont appliquées.