Déploiement d'un exit utilisateur

Déployez votre exit utilisateur sur le noeud d'intégration.

Avant de commencer

  • Ecrivez et compilez le code d'exit utilisateur. Voir Développement d'un exit utilisateur.
  • Vérifiez que l'exit:
    1. Se trouve dans une bibliothèque dont l'extension est .lel
    2. Exporte les fonctions bipInitializeUserExits et bipTerminateUserExits

A propos de cette tâche

Vous pouvez définir l'état de l'exit utilisateur de manière dynamique sur actif ou inactif, en fonction du flux de messages, sans redémarrer le noeud d'intégration.

Vous pouvez définir l'état de l'exit utilisateur de manière dynamique sur actif ou inactif pour un serveur d'intégration indépendant ou un serveur d'intégration géré par un noeud d'intégration. Il n'est pas nécessaire de redémarrer le noeud d'intégration.

Vous pouvez définir l'état de l'exit utilisateur de manière dynamique sur actif ou inactif pour un noeud d'intégration. Vous devez démarrer le noeud d'intégration.

Pour déployer l'exit utilisateur:

Procédure

  1. Installez le code d'exit utilisateur sur un noeud d'intégration.

    La bibliothèque contenant le code d'exit utilisateur doit être installée sur un système de fichiers accessible par le noeud d'intégration. Par exemple, le fichier doit disposer du droit de lecture et d'exécution pour l'ID utilisateur sous lequel le noeud d'intégration s'exécute. Le noeud d'intégration recherche dans les emplacements suivants les bibliothèques qui contiennent des exits utilisateur:

    • Le userExitPath propriété du nœud d’intégration.
      La propriété du nœud d'intégration userExitPath définit une liste de répertoires séparés par des deux-points (points-virgules sur les fenêtres). Vous pouvez définir cette propriété à l'aide de l'une des méthodes suivantes:
      • Met le userExitPath propriété lorsque vous créez un nouveau nœud d'intégration, utilisez la propriété -X drapeau sur lemqsicreatebroker commande.
      • Met le userExitPath propriété pour un nœud d'intégration existant, utilisez la -X drapeau sur lemqsichangeflowuserexits commande.
      • Met le userExitPath propriété pour un nœud d'intégration existant en modifiant l'entrée dans lenode.conf.yaml fichier pour le nœud d'intégration.
    • La variable d'environnement MQSI_USER_EXIT_PATH.

      Ajoutez le répertoire qui contient les fichiers d'extension à la variable d'environnement MQSI_USER_EXIT_PATH associée à l'environnement dans lequel le noeud d'intégration s'exécute.

    Si la userExitPath propriété et variable d'environnement MQSI_USER_EXIT_PATH sont tous deux définis, la variable d'environnement est prioritaire. Tous les répertoires de la variable d'environnement sont recherchés dans l'ordre dans lequel ils apparaissent dans la variable. Ensuite, tous les répertoires de la propriété de noeud d'intégration sont recherchés dans l'ordre dans lequel ils apparaissent dans la propriété.

  2. Chargez la bibliothèque d'exit utilisateur dans les processus du noeud d'intégration.
    Lorsque la bibliothèque d'exit utilisateur est installée sur le noeud d'intégration, vous devez la charger de l'une des manières suivantes:
    • Arrêtez et redémarrez le noeud d'intégration.
    • Exécutez la commande mqsireload pour redémarrer les processus du serveur d'intégration.
  3. Activez l'exit utilisateur.

    Les exits utilisateur peuvent être actifs ou inactifs et sont inactifs par défaut. Vous pouvez modifier l'état d'un exit utilisateur de manière dynamique en mettant à jour le fichier node.conf.yaml ou en utilisant la commande mqsichangeflowuserexits . Vous devez redémarrer le noeud d'intégration.

    Pour définir l'état d'exit utilisateur par défaut pour un noeud d'intégration:

    1. Arrêtez le noeud d'intégration.
    2. Définissez la propriété --active-user-exit-list du noeud d'intégration à l'aide de l'une des méthodes suivantes:
      • Modifier le activeUserExitList propriété dans lenode.conf.yaml déposer.
      • Utilisez l'indicateur -x dans la commande mqsichangeflowuserexits .
    3. Démarrez le noeud d'intégration et consultez le journal système pour vous assurer que tous les serveurs d'intégration démarrent sans erreur.
      Si vous spécifiez des noms d'exit utilisateur qui ne sont pas fournis par une bibliothèque chargée par le serveur d'intégration, un message BIP2314 est consigné dans le journal système. Tous les flux qui se trouvent dans les serveurs d'intégration ne démarrent pas.
    4. Facultatif: Si un message BIP2314 est consigné dans le journal système et que les flux des serveurs d'intégration ne démarrent pas, effectuez l'une des actions suivantes:
      • Indiquez une bibliothèque dans le chemin d'exit utilisateur qui implémente l'exit. Exécutez ensuite la commande mqsireload ou redémarrez le noeud d'intégration pour charger un exit à partir de la bibliothèque.
      • Exécutez la commande mqsichangeflowuserexits pour supprimer l'exit des listes active et inactive.

    Vous pouvez également remplacer l'état d'exit utilisateur par défaut pour un noeud d'intégration. Vous pouvez utiliser la commande mqsichangeflowuserexits pour activer ou désactiver des exits utilisateur par noeud d'intégration, par serveur d'intégration ou par flux de messages. L'ordre de priorité est le flux de messages, puis le serveur d'intégration, puis le noeud d'intégration. Lorsque plusieurs exits sont actifs pour un flux, le noeud d'intégration les démarre dans l'ordre défini par la commande mqsichangeflowuserexits .