Intégrer des programmes COBOL et RPG sur des systèmes IBM midrange avec des flux de travail Standard dans Azure Logic Apps

S’applique à : Azure Logic Apps (Standard)

Pour accéder et exécuter des programmes COBOL et RPG sur des systèmes IBM midrange à partir de flux de travail Standard dans Azure Logic Apps, vous pouvez utiliser le connecteur intégré IBM i Program Call basé sur un fournisseur de services. Le système d’exploitation IBM i fournit un serveur DPC (Distributed Program Calls). Le connecteur communique avec le serveur IBM i DPC pour exécuter des programmes COBOL et RPG à l’aide de TCP/IP. Le connecteur IBM i est disponible dans toutes les régions Azure Logic Apps, à l’exception d’Azure Government et de Microsoft Azure gérés par 21Vianet.

Cet article décrit les aspects suivants sur le connecteur IBM i :

• Scénarios d’utilisation du connecteur IBM i dans Azure Logic Apps
• Prérequis et configuration pour l’utilisation du connecteur IBM i
• Étapes d’ajout d’actions de connecteur IBM i à votre flux de travail d’application logique standard

Passer en revue les scénarios d’utilisation du connecteur

Il y a plus de 50 ans, IBM a publié les premiers systèmes midrange. IBM les a annoncés comme « Petite taille, petite en prix et grande performance. C’est un système pour le moment et pour l’avenir. Au fil des années, les systèmes intermédiaires ont évolué et sont devenus omniprésents dans les entreprises de taille moyenne ou dans les grandes entreprises pour étendre les environnements mainframe. Systèmes midrange qui exécutent IBM i, généralement Power Systems, prennent en charge TCP/IP et SNA.

Le système IBM i inclut la fonctionnalité serveur DPC qui permet à la plupart des applications IBM i d’interagir avec des clients tels qu’Azure Logic Apps à l’aide du modèle de demande-réponse lancé par le client uniquement avec des modifications minimales. DPC est un protocole documenté qui prend en charge l’intégration de programme à programme sur un système IBM i, auquel les applications clientes peuvent facilement accéder à l’aide du protocole réseau TCP/IP.

Microsoft Host Integration Server (HIS) fournit une connectivité aux systèmes IBM i à l’aide de TCP/IP et APPC LU6.2. Depuis de nombreuses années, les clients ont utilisé his Transaction Integrator pour intégrer des systèmes IBM i locaux et Windows. Le connecteur IBM i Program Call utilise le modèle de programmation TCP/IP pour interagir avec les programmes IBM i COBOL et RPG.

Le diagramme suivant montre comment le connecteur IBM i interagit avec un système IBM i :

Pour étendre ces scénarios de cloud hybride, le connecteur IBM i dans un flux de travail Standard fonctionne avec le concepteur HIS pour Logic Apps, que vous pouvez utiliser pour créer une définition de programme ou une carte de programme du programme COBOL ou RPG. Pour cette tâche, le Concepteur HIS utilise un modèle de programmation qui détermine les caractéristiques de l’échange de données entre la plage moyenne et le flux de travail. His Designer convertit ces informations en métadonnées que le connecteur IBM i utilise lors de l’exécution d’une action dans votre workflow.

Après avoir généré le fichier de métadonnées en tant que fichier HIDX (Host Integration Designer XML) à partir du concepteur HIS, vous pouvez ajouter ce fichier en tant qu’artefact de mappage à votre ressource d’application logique standard. Ainsi, votre workflow peut accéder aux métadonnées de votre application lorsque vous ajoutez une action ibm i connector. Le connecteur lit le fichier de métadonnées à partir de votre ressource d’application logique et présente dynamiquement les paramètres à utiliser avec le connecteur IBM i dans votre flux de travail. Vous pouvez ensuite fournir des paramètres à l’application hôte, et le connecteur retourne les résultats à votre flux de travail. Par conséquent, vous pouvez intégrer vos applications héritées à Azure, Microsoft, d’autres applications, services et systèmes pris en charge par Azure Logic Apps.

Référence technique du connecteur

Actuellement, une opération est disponible pour le connecteur IBM i : appelez un programme IBM i. Le tableau suivant récapitule l’utilisation de cette action :

Cette opération inclut également des paramètres avancés, qui apparaissent après avoir sélectionné une méthode, pour vous permettre de sélectionner et d’utiliser avec la méthode sélectionnée. Ces paramètres varient en fonction de votre fichier HIDX et de la méthode que vous sélectionnez.

Prerequisites

• Un compte et un abonnement Azure. Si vous n’avez pas d’abonnement Azure, inscrivez-vous pour bénéficier d’un compte Azure gratuit.

• Accès au serveur midrange qui héberge le système IBM i.

• Fichier HIDX (Host Integration Designer XML) qui fournit les métadonnées nécessaires au connecteur IBM i Program Call pour exécuter votre programme midrange.

  Pour créer ce fichier HIDX, téléchargez et installez le concepteur HIS pour Azure Logic Apps. La seule configuration requise est Microsoft .NET Framework 4.8.

  Pour appeler un programme midrange, votre flux de travail doit comprendre le type, les paramètres et les valeurs de retour du programme midrange. Le connecteur IBM i gère ce processus et les conversions de données. Ces conversions requises fournissent des données d’entrée du flux de travail au programme midrange et envoient toutes les données de sortie générées à partir du programme midrange au flux de travail. Le connecteur fournit également la définition de données tabulaires et la traduction de pages de codes. Pour ce processus, Azure Logic Apps exige que vous fournissiez ces informations en tant que métadonnées.

  Pour créer ces métadonnées, utilisez le Concepteur HIS pour Logic Apps. Avec cet outil, vous pouvez créer manuellement les méthodes, paramètres et retourner des valeurs que vous utilisez dans votre flux de travail. Vous pouvez également importer des définitions de programme COBOL ou RPG (copybooks) qui fournissent ces informations.

  L’outil génère un fichier HIDX (Host Integration Designer XML) qui fournit les métadonnées nécessaires pour le connecteur. Si vous utilisez HIS, vous pouvez utiliser le Concepteur d’intégrateur de transactions (TI) HIS pour créer le fichier HIDX.

• Flux de travail d’application logique standard dans lequel vous souhaitez intégrer le système IBM i.

  Le connecteur IBM i n’a pas de déclencheurs. Utilisez donc n’importe quel déclencheur pour démarrer votre flux de travail, tel que le déclencheur périodicité ou le déclencheur de requête . Vous pouvez ensuite ajouter l’action IBM i Connector. Pour commencer, créez un flux de travail vide dans votre ressource d’application logique Standard.

Limites

Actuellement, le connecteur IBM i exige que vous chargez votre fichier HIDX directement dans votre ressource d’application logique Standard, et non dans un compte d’intégration.

Définir et générer des métadonnées

Après avoir téléchargé et installé his designer pour Azure Logic Apps, procédez comme suit pour générer le fichier HIDX à partir de l’artefact de métadonnées.

Charger le fichier HIDX

Pour que votre flux de travail utilise le fichier HIDX, procédez comme suit :

1. Accédez au dossier dans lequel vous avez enregistré votre fichier HIDX, puis copiez le fichier.

2. Dans le portail Azure, ouvrez votre ressource d’application logique Standard.

3. Dans le menu de l’application logique, sous Artefacts, chargez le fichier HIDX en tant que carte vers la ressource de l’application logique.

4. Passez à la section suivante pour ajouter une action IBM i à votre workflow.

Plus loin dans ce guide, lorsque vous ajoutez une action de connexion IBM i Program Call à votre flux de travail pour la première fois, une invite vous demande de créer une connexion entre votre flux de travail et le système intermédiaire. Après avoir créé la connexion, vous pouvez sélectionner votre fichier HIDX précédemment ajouté, la méthode à exécuter et les paramètres à utiliser.

Ajouter une action IBM i

Procédez comme suit pour ajouter une action IBM i et configurer les paramètres nécessaires :

1. Sur le portail Azure, ouvrez votre application logique Standard et votre flux de travail dans le concepteur.

2. Si vous n’avez pas de déclencheur pour démarrer votre flux de travail, suivez ces étapes générales pour ajouter le déclencheur souhaité.

   Cet exemple continue avec le déclencheur de requête nommé Lorsqu’une requête HTTP est reçue :

   

3. Pour ajouter une action de connecteur IBM i, suivez ces étapes générales pour ajouter l’action de connecteur intégré IBM i Program Call nommée Appeler un programme IBM i.

4. Une fois le volet d’informations de connexion affiché, fournissez les informations suivantes, telles que le nom du serveur hôte et les informations de configuration ibm i system :

   Paramètre	Obligatoire	Valeur	Descriptif
   Nom de la connexion	Oui	< nom-connexion>	Nom de votre connexion.
   Nom commun du certificat de serveur	Non	< nom-commun-cert-serveur>	Nom du certificat TLS (Transport Security Layer) à utiliser.
   Page de codes	Non	< page de codes>	Numéro de page de codes à utiliser pour convertir du texte.
   Mot de passe	Non	< mot de passe>	Mot de passe utilisateur facultatif pour l’authentification de connexion.
   Numéro de port	Oui	< port-number>	Numéro de port à utiliser pour l’authentification de connexion.
   nom du serveur	Oui	< nom du serveur>	Nom du serveur.
   Délai d'expiration	Non	< Timeout>	Délai d’attente en secondes pendant l’attente des réponses du serveur.
   nom d’utilisateur	Non	< nom d’utilisateur>	Nom d’utilisateur facultatif pour l’authentification de connexion.
   Utiliser TLS	Non	True ou false	Sécurisez la connexion avec TLS (Transport Security Layer).
   Valider le certificat du serveur	Non	True ou false	Validez le certificat du serveur.

   Par exemple:

   

5. Lorsque vous avez terminé, sélectionnez Créer nouveau.

6. Une fois le volet d’informations d’action affiché, dans la section Paramètres , fournissez les informations requises :

   Paramètre	Obligatoire	Valeur	Descriptif
   Nom HIDX	Oui	< HIDX-file-name>	Sélectionnez le fichier IBM i HIDX que vous souhaitez utiliser.
   Nom de la méthode	Oui	< nom de méthode>	Sélectionnez la méthode dans le fichier HIDX que vous souhaitez utiliser.
   Paramètres avancés	Non	Varie	Cette liste s’affiche après avoir sélectionné une méthode pour pouvoir ajouter d’autres paramètres à utiliser avec la méthode sélectionnée. Les paramètres disponibles varient en fonction de votre fichier HIDX et de la méthode que vous sélectionnez.

   Par exemple:

   Sélectionner un fichier et une méthode HIDX

   

   Sélectionner des paramètres avancés

   

7. Lorsque vous avez terminé, enregistrez votre flux de travail. Dans la barre d’outils du Concepteur, sélectionnez Enregistrer.

Tester votre workflow

Procédez comme suit pour vérifier votre flux de travail et confirmer les sorties :

1. Pour exécuter votre flux de travail, dans la barre d’outils du concepteur, sélectionnez Exécuter>.

   Une fois votre flux de travail terminé, l’historique des exécutions du flux de travail s’affiche. Les étapes réussies affichent des crochets, tandis que les étapes infructueuses affichent un point d’exclamation (!).

2. Pour passer en revue les entrées et sorties de chaque étape, développez cette étape.

3. Pour passer en revue les sorties, sélectionnez Afficher les sorties brutes.

Contenu connexe

• Vérifier l’état du flux de travail, afficher l’historique des exécutions et configurer des alertes dans Azure Logic Apps
• Afficher les métriques pour l’intégrité et les performances des flux de travail dans Azure Logic Apps
• Surveiller et collecter des données de diagnostic pour les flux de travail dans Azure Logic Apps
• Activer et afficher des données de télémétrie améliorées dans Application Insights pour les flux de travail Standard dans Azure Logic Apps