Intégrer des programmes IMS sur des mainframes IBM à des flux de travail Standard dans Azure Logic Apps

Article
01/10/2024

S’applique à : Azure Logic Apps (Standard)

Pour accéder et exécuter des applications mainframe IBM sur des systèmes IMS (Information Management System) à partir de flux de travail Standard dans Azure Logic Apps, vous pouvez utiliser le connecteur intégré d’appel du programme IMS, basé sur un fournisseur de services. IMS fournit un moniteur de programme de transaction (TP) avec une base de données transactionnelle intégrée (TM) et hiérarchique. Le connecteur communique avec les programmes de transaction IBM IMS à l’aide de Connecter IMS, qui est un composant réseau IMS TM. Ce composant fournit des communications hautes performances pour les systèmes IMS entre un ou plusieurs clients TCP/IP et un ou plusieurs systèmes IMS. Le connecteur IMS est disponible dans toutes les régions Azure Logic Apps, à l’exception d’Azure Government et de Microsoft Azure gérés par 21Vianet.

Ce guide pratique décrit les aspects suivants sur le connecteur IMS :

Pourquoi utiliser le connecteur IMS dans Azure Logic Apps
Prérequis et configuration pour l’utilisation du connecteur IMS
Étapes d’ajout d’actions de connecteur IMS à votre flux de travail d’application logique standard

Pourquoi utiliser ce connecteur

Les systèmes IMS étaient l’un des premiers systèmes stratégiques qui s’exécutent sur des ordinateurs mainframes. Microsoft Host Integration Server (HIS) fournit une connectivité aux systèmes IMS en suivant deux modèles : IMS Connecter et APPC LU6.2. Les clients ont utilisé l’intégrateur de transactions HIS (TI) pour intégrer leurs systèmes IMS à Windows local depuis de nombreuses années. Le connecteur d’appel de programme IMS utilise le modèle Connecter IMS pour interagir avec les programmes de transaction IMS via TCP/IP.

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

Pour étendre ces scénarios de cloud hybride, le connecteur IMS 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 transactionnel mainframe. Pour cette tâche, le Concepteur HIS convertit ces informations en métadonnées que le connecteur IMS utilise lors de l’exécution d’une action dans votre flux de travail.

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 flux de travail peut accéder aux métadonnées de votre application lorsque vous ajoutez une action de connecteur IMS. 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 IMS 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

La section suivante décrit les opérations pour le connecteur IMS, qui inclut actuellement uniquement l’action suivante :

Appeler un programme IMS

Paramètre	Obligatoire	Type	Description
Nom HIDX	Oui	Chaîne	Sélectionnez le fichier HIDX IMS que vous souhaitez utiliser.
Nom de la méthode	Oui	Chaîne	Sélectionnez la méthode dans le fichier HIDX à utiliser.
Paramètres avancés	Non	Variable	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.

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.

Limites

Actuellement, ce connecteur nécessite que vous chargez votre fichier HIDX directement dans votre ressource d’application logique Standard, et non dans un compte d’intégration.

Prérequis

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 mainframe qui héberge le système IMS
Fichier HIDX (Host Integration Designer) qui fournit les métadonnées nécessaires au connecteur d’appel du programme IMS pour exécuter votre programme mainframe.

Pour créer ce fichier HIDX, téléchargez et installez le concepteur HIS pour Azure Logic Apps. Le seul prérequis est Microsoft .NET Framework 4.8.

Pour appeler un programme mainframe, votre flux de travail doit comprendre le type, les paramètres et les valeurs de retour du programme mainframe. Le connecteur IMS gère le processus et les conversions de données, qui sont nécessaires pour fournir des données d’entrée du flux de travail au programme mainframe et pour envoyer les données de sortie générées à partir du programme mainframe 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 valeurs de retour que vous pouvez utiliser dans votre flux de travail. L’outil vous permet également d’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 TI pour créer le fichier HIDX.
Flux de travail d’application logique standard à utiliser pour l’intégration au système IMS

Le connecteur IMS 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 les actions du connecteur IMS. Pour commencer, créez un flux de travail vide dans votre ressource d’application logique Standard.

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 :

Accédez au dossier dans lequel vous avez enregistré votre fichier HIDX, puis copiez le fichier.
Dans le Portail Azure, chargez le fichier HIDX en tant que mappage à votre ressource d’application logique Standard.
À présent, ajoutez une action IMS à votre flux de travail.

Plus loin dans ce guide, lorsque vous ajoutez une action de connecteur d’appel de programme IMS à votre flux de travail pour la première fois, vous êtes invité à créer une connexion entre votre flux de travail et le système mainframe. Une fois que vous avez 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 IMS

Dans le Portail Azure, ouvrez votre ressource et flux de travail d’application logique Standard dans le concepteur.
Si vous n’avez pas encore ajouté 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.
Pour ajouter une action de connecteur IMS, suivez ces étapes générales pour ajouter l’action de connecteur intégré d’appel du programme IMS nommée Appeler un programme IMS.

Une fois le volet d’informations de connexion affiché, fournissez les informations suivantes :

Paramètre	Obligatoire	Value	Description
Nom de connexion	Oui	<connection-name>	Nom de votre connexion
ID système IMS	Oui	<IMS-system-ID>	Nom du système IMS dans lequel le modèle Connecter IMS dirige les requêtes entrantes
Nom de sortie ITOC	Non	<ITOC-exit-name>	Nom de la routine de sortie utilisée par IMS pour gérer les requêtes entrantes
Nom du mod MFS	Non	<MFS-Mod-Name>	Nom associé au descripteur de sortie de message IMS sortant
Utiliser la sortie de sécurité HWSO1	Non	Vrai ou faux	Le serveur utilise la sortie de sécurité HWSO1.
Nom commun du certificat de serveur	Non	<server-cert-common-name>	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 d’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 de serveur	Oui	<server-name>	Nom du serveur
Délai d'expiration	Non	<délai d’expiration>	Délai d’expiration 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	Vrai ou faux	Sécurisez la connexion avec TLS (Transport Security Layer).
Valider le certificat du serveur	Non	Vrai ou faux	Validez le certificat du serveur.

Par exemple :

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

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

Paramètre	Obligatoire	Value	Description
Nom HIDX	Oui	<HIDX-file-name>	Sélectionnez le fichier HIDX IMS que vous souhaitez utiliser.
Nom de la méthode	Oui	<method-name>	Sélectionnez la méthode dans le fichier HIDX à utiliser.
Paramètres avancés	Non	Variable	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

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

Tester votre workflow

Pour exécuter votre flux de travail, dans le menu flux de travail, sélectionnez Vue d’ensemble. Dans la barre d’outils Vue d’ensemble, sélectionnez Exécuter >Exécuter.

Une fois votre flux de travail terminé, l’historique des exécutions de votre flux de travail s’affiche. Les étapes réussies montrent case activée marques, tandis que les étapes infructueuses affichent un point d’exclamation ( !).
Pour réviser les entrées et les sorties de chaque étape, développez l’étape à vérifier.
Pour réviser les sorties, sélectionnez See raw outputs (Afficher les sorties brutes).

Partager via