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

Article
11/08/2023

S’applique à : Azure Logic Apps (Standard)

Pour accéder et exécuter des applications mainframe IBM sur des systèmes CICS (Customer Information Control System) à partir de flux de travail Standard dans Azure Logic Apps, vous pouvez utiliser le connecteur intégré d’appel du programme CICS, basé sur un fournisseur de services. CICS fournit un moniteur de programme de transaction (TP) avec un gestionnaire de transactions intégré (TM). Le connecteur communique avec les programmes de transaction IBM CICS à l’aide de TCP/IP. Le connecteur CICS 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 CICS :

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

Pourquoi utiliser ce connecteur

Les systèmes CICS é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 CICS à l’aide de TCP/IP, HTTP et APPC LU6.2. Les clients ont utilisé l’intégrateur de transactions HIS (TI) pour intégrer des systèmes CICS à Windows local depuis de nombreuses années. Le connecteur d’appel de programme CICS utilise des modèles de programmation TCP/IP et HTTP pour interagir avec les programmes de transaction CICS.

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

Pour étendre ces scénarios de cloud hybride, le connecteur CICS 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 utilise un modèle de programmation qui détermine les caractéristiques de l’échange de données entre le mainframe et le flux de travail. Le Concepteur HIS convertit ces informations en métadonnées que le connecteur CICS 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) à 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 CICS. 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 CICS 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 CICS, qui inclut actuellement uniquement l’action suivante :

Appeler un programme CICS

Paramètre	Obligatoire	Type	Description
Nom HIDX	Oui	Chaîne	Sélectionnez le fichier CICS HIDX 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 CICS
Fichier HIDX (Host Integration Designer) qui fournit les métadonnées nécessaires au connecteur d’appel du programme CICS 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 CICS gère ce 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 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 TI pour créer le fichier HIDX.
Flux de travail d’application logique standard dans lequel vous souhaitez intégrer le système CICS

Le connecteur CICS 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 CICS. 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 CICS à votre flux de travail.

Plus loin dans ce guide, lorsque vous ajoutez une action cics Program Call connector à 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 CICS

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 CICS, suivez ces étapes générales pour ajouter l’action de connecteur intégré de l’appel du programme CICS nommée Appeler un programme CICS.

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 du système CICS :

Paramètre	Obligatoire	Value	Description
Nom de connexion	Oui	<connection-name>	Nom de votre connexion
Modèle de programmation	Oui	<Modèle de programmation CICS>	Modèle de programmation CICS sélectionné. Pour plus d’informations, consultez Modèles de programmation et choix du modèle de programmation approprié.
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.
Nom commun du certificat de serveur	Non	<server-cert-common-name>	Nom du certificat TLS (Transport Security Layer) à utiliser
Utiliser le format d’en-tête de requête IBM	Non	Vrai ou faux	Le serveur attend des en-têtes ELM ou TRM au format IBM

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 CICS HIDX 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

Screenshot shows CICS action with selected HIDX file and method.

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).