Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # AWS Mainframe Modernization sur l'intégration d'Amazon EC2 à Control-M Cette section décrit comment Control-M s'intègre et prend en charge les tâches par lots exécutées dans un environnement d'exécution AWS Mainframe Modernization personnalisé déployé sur une instance EC2. Si vous implémentez l'environnement d'exécution entièrement géré AWS Replatform avec Micro Focus, consultez la section [AWS Mainframe Modernization Intégration gérée avec Control-M](aws-mainframe-modernization-managed.md). Cette section suppose les prérequis suivants : + Un compte AWS actif. + Un cloud privé virtuel (VPC) dans lequel les instances EC2 seront créées. + L'application mainframe est migrée et s'exécute dans un environnement AWS Replatform avec Micro Focus sur une instance EC2 et prend en charge le moteur d'exécution Micro Focus avec plusieurs tâches par lots définies. Pour ce projet pilote, suivez les instructions de la section [Replateformage des applications avec Micro Focus](https://docs.aws.amazon.com/m2/latest/userguide/replatforming-m2.html). La documentation inclut toutes les tâches et des informations supplémentaires sur la configuration et le fonctionnement de l'environnement d'exécution AWS Replatform with Micro Focus sur Amazon EC2. Les rubriques suivantes traitent de la configuration requise pour l'intégration entre Control-M et l'environnement AWS Replatform with Micro Focus : + [Déployer les ressources Control-M et Micro Focus](deploy-resources-environment.md) + [Création d'un profil de connexion Control-M](create-control-m-connection-profile.md) + [Create jobs and schedules in Control-M Planning](create-jobs-schedules-control-m-planning.md) + [Gérez les exécutions de tâches dans Control-M à l'aide de la surveillance](monitor.md) # Déployer les ressources Control-M et Micro Focus Les deux premières étapes de l'intégration d'AWS Mainframe Modernization à Control-M consistent à déployer un agent Control-M, puis à déployer un plug-in sur l'agent. La troisième étape consiste à déployer le type de tâche dans Control-M Application Integrator. ## Déployer un agent Control-M sur une instance EC2 Lorsque vous utilisez une replateforme AWS personnalisée avec Micro Focus sur l'environnement d'exécution Amazon EC2, `MFBSIFJCL` l'utilitaire est invoqué. L'utilitaire fonctionne sur l'hôte qui a été lancé à l'aide de l'offre Micro Focus Enterprise Server du AWS Marketplace. Pour exécuter l'`MFBSIFJCL`utilitaire, vous devez également déployer un agent Control-M sur cet hôte. Pour obtenir des instructions, consultez la documentation de [Control-M.](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Agent_Installation.htm) **Note** Vous pouvez télécharger le support d'installation requis sur le [site de téléchargement des produits électroniques de BMC](https://www.bmc.com/support/resources/product-downloads.html). ## Déployez le plug-in Micro Focus sur l'agent Control-M Les plug-ins assurent l'intégration et le support des applications et des services orchestrés par Control-M. Le déploiement du plug-in est une activité peu fréquente. Si vous souhaitez utiliser un plug-in existant, ignorez cette étape et créez un profil de connexion. Sur Amazon EC2, le service AWS Mainframe Modernization Replatform with Micro Focus expose le moteur Micro Focus. Pour l'intégration AWS Mainframe Modernization, Control-M utilise le plug-in Micro Focus. Pour plus d'informations, consultez la documentation de [Control-M.](https://docs.bmc.com/docs/ctm_integrations/control-m-for-micro-focus-1193641959.html) Vous devez déployer ce plug-in sur un agent installé sur un hôte sur lequel Micro Focus Enterprise Server est exécuté. ## Déployer un type de AWS Mainframe Modernization tâche dans Control-M Application Integrator Le déploiement du type de tâche est généralement une activité ponctuelle. Si vous disposez déjà d'un type de tâche que vous souhaitez utiliser, sautez cette étape et passez à l'étape suivante de [création d'un profil de connexion](create-control-m-connection-profile.md). L'exemple de type de tâche [AIJOB.ctmai](https://github.com/aws-samples/aws-mainframe-modernization-controlm-integration/blob/main/assets/AIJOB.ctmai) est fourni dans le référentiel Git. Pour déployer un type de tâche, vous devez effectuer les étapes suivantes à l'aide d'[Application Integrator](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Application_Integrator.htm) : + Clonez le GitHub référentiel [aws-mainframe-modernization-controlm-integration](https://github.com/aws-samples/aws-mainframe-modernization-controlm-integration) et téléchargez le `AIJOB.ctmai` fichier dans un emplacement du système de fichiers accessible par Application Integrator. + Connectez-vous à Application Integrator. + Sur l'onglet **Accueil**, sélectionnez **Importer le type de tâche depuis un fichier**, puis sélectionnez l'emplacement de `AIM2JOB.ctmai`. + Si vous souhaitez apporter des modifications à l'exemple fourni, familiarisez-vous avec Application Integrator. + Déployez le type de tâche en suivant les instructions de la [documentation Control-M](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Deploying_and_Publishing_a_Plug-in.htm). # Création d'un profil de connexion Control-M Les profils de connexion définissent les attributs de connexion et les informations d'identification de sécurité pour une instance spécifique d'une application. Chaque profil de connexion peut être référencé par plusieurs tâches. Vous pouvez avoir des profils distincts pour chaque combinaison unique d'une application et d'informations d'identification. Pour définir des profils de connexion, vous pouvez utiliser le [domaine de configuration](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_centralized_connection_profile.htm) de l'interface Web Control-M ou vous pouvez utiliser JSON. Le code suivant est un exemple d'utilisation de JSON : ``` { "MICROFOCUS-WINDOWS": { "Type": "ConnectionProfile:Micro Focus Windows", "Centralized": true, "Description": "Micro Focus on Windows Connection Profile - file locations refer to the Enterprise Server host", "MFBSI Config Path": "C:\\microfocus\\ES\\mfbsi\\MFWIN\\mfbsi.cfg", "MFBSI Directory Path": "c:\\microfocus\\es\\mfbsi\\MFWIN", "Runtime Environment": "\"C:\\Program Files (x86)\\Micro Focus\\Enterprise Developer\\createenv.bat\"", "Run As": "dbauser", "RunAs-Pass": "*****" } } ``` L'exemple de code se trouve dans le fichier `ConnectionProfile-Custom-M2-Replatform.json` du GitHub dépôt. Pour déployer le code, utilisez le service de déploiement de l'API Control-M Automation : ``` ctm deploy ConnectionProfile-Custom-M2-Replatform.json ``` La réponse de l'API Control-M Automation sera similaire à la suivante : ``` [ { "deploymentFile": "cp-JOG-MF-WINDOWS.json", "deploymentState": "DEPLOYED_CONNECTION_PROFILES", "deploymentStatus": "ENDED_OK", "successfulFoldersCount": 0, "successfulSmartFoldersCount": 0, "successfulSubFoldersCount": 0, "successfulJobsCount": 0, "successfulConnectionProfilesCount": 1, "successfulDriversCount": 0, "isDeployDescriptorValid": false, "deployedConnectionProfiles": [ " MICROFOCUS-WINDOWS " ] } ] ``` # Création de tâches et de calendriers dans Control-M Planning Maintenant que le plug-in est déployé et que vous disposez d'un profil de connexion pour la connectivité Micro Focus, vous pouvez commencer à créer et à exécuter des tâches. Chaque tâche Control-M for Micro Focus comprend un ensemble d'attributs répartis en quatre sections. Chaque section peut avoir de nombreux attributs. La liste suivante présente certains des attributs les plus couramment utilisés. + Général : + Le nom de la tâche + L'application et la sous-application auxquelles appartient la tâche + Le JCL à soumettre + Lien vers la documentation opérationnelle fournie par le site + Planification : + Mois et jours pendant lesquels cette tâche est susceptible d'être exécutée + Calendriers tels que les périodes comptables d'entreprise, les jours fériés ou autres dates spéciales qui ne peuvent pas être définis de manière algorithmique + Fenêtres horaires + Comportement cyclique tel que courir toutes les heures + Conditions préalables + Dépendances en amont (généralement des tâches, qui doivent être finalisées pour que cette tâche puisse être exécutée) + Ressources qui pourraient être requises + Action de l'utilisateur qui pourrait être requise + Actions effectuées par Control-M à la fin de la tâche : + Déterminer le succès ou l'échec d'une tâche (généralement en fonction des codes d'achèvement de la tâche, mais vous pouvez annuler ce paramètre pour utiliser le texte de sortie ou vérifier un statut spécifique) + Notifications, telles que des e-mails, en cas d'échec ou de réussite + État de publication pour les dépendances en aval Comme pour les profils de connexion, les tâches peuvent être créées et déployées à [l'aide de Control-M Web](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_Job.htm) ou [écrites en JSON et déployées à](https://docs.bmc.com/docs/automation-api/monthly/code-reference-1116950299.html) l'aide de l'API Control-M Automation. Les sections suivantes examinent certains scénarios de flux de travail courants : + [Lancer des tâches à l'aide d'un flux de travail](initiate-jobs.md) + [Automate job runs on a scheduled frequency](automate-jobs.md) # Lancer des tâches à l'aide d'un flux de travail Créez un flux de tâches appelé flux de travail. Les tâches du flux de travail sont interconnectées et dépendent de la réussite des tâches précédentes. ## Utilisation de Control-M Web Pour lancer une tâche depuis l'interface utilisateur Control-M, procédez comme suit : 1. Dans le domaine Planification, ajoutez un nouvel espace de travail. Cela permet d'ouvrir un canevas contenant un objet de dossier vide. 1. Dans la barre de menu, choisissez **Ajouter une tâche**, choisissez la tâche Micro Focus Windows ou Micro Focus Linux, puis faites-la glisser sur la face du dossier. 1. Lorsque la couleur de la tâche passe au vert, supprimez-la. Le volet de droite contient les sections **Général**, **Planification**, **Conditions préalables** et **Actions**. Pour créer la tâche, consultez les instructions standard de la documentation [Control-M](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_Job.htm). 1. Pour obtenir des instructions sur la création d'une tâche Control-M pour Micro Focus, consultez la documentation [Control-M](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Jobs_for_Mainframe_Modernization.htm#MicroFocusJob). Pour ce projet pilote, répétez les étapes 2 à 4 pour cinq tâches, en les nommant de `aws-mf-job1` à`aws-mf-job5`. 1. Pour connecter ces tâches au flux souhaité, choisissez le triangle de conditions situé sous l'objet de la tâche et faites-le glisser vers la tâche suivante. Par exemple, choisissez le triangle de conditions `aws-mf-job1` ci-dessous et faites-le glisser dessus`aws-mf-job2`. Cette action fait `aws-mf-job1` du prédécesseur de`aws-mf-job2`. Par défaut, `aws-mf-job1` il doit désormais être terminé avec succès `aws-mf-job2` avant de pouvoir être lancé. Le schéma suivant montre la vue Planification de Control-M du flux de tâche de base. ![\[Schéma de flux de travail, avec propriétés dans le volet de droite.\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/control-m-batch-scheduler/images/control-m-web-planning.png) *Image fournie avec l'aimable autorisation de BMC Software, Inc. ©2022* ## Utilisation de JSON Le même flux peut être codé en JSON. Dans le GitHub dépôt, l'exemple de code se trouve dans le fichier `Folder-Custom-M2-Replatform.json` : ``` { "aws-custom-m2": { "Type": "Folder", "ControlmServer": "psctm", "OrderMethod": "Manual", "Application": "AWSM2", "SubApplication": "Replatform-Custom", "aws-mf-job1": { "Type": "Job:Micro Focus Windows", "ConnectionProfile": "MICROFOCUS-WINDOWS", "Enable JCL Variables": "unchecked", "Restart on Rerun": "unchecked", "Recapture ABEND Codes": "Ignore", "Recapture COND Codes": "Ignore", "Auto Adjust Restart": "Ignore", "Set MF_UCC11": "Ignore", "Restart with Modified JCL": "No", "Application": "AWSM2", "SubApplication": "Replatform-Custom", "Host": "microfocus-es-host", "Output": {} }, "aws-mf-job2": { "Type": "Job:Micro Focus Windows", "ConnectionProfile": "MICROFOCUS-WINDOWS", "Enable JCL Variables": "unchecked", "Restart on Rerun": "unchecked", "Recapture ABEND Codes": "Ignore", "Recapture COND Codes": "Ignore", "Auto Adjust Restart": "Ignore", "Set MF_UCC11": "Ignore", "Restart with Modified JCL": "No", "Application": "AWSM2", "SubApplication": "Replatform-Custom", "Host": "microfocus-es-host", "Output": {} }, "aws-mf-job3": { "Type": "Job:Micro Focus Windows", "ConnectionProfile": "MICROFOCUS-WINDOWS", "Enable JCL Variables": "unchecked", "Restart on Rerun": "unchecked", "Recapture ABEND Codes": "Ignore", "Recapture COND Codes": "Ignore", "Auto Adjust Restart": "Ignore", "Set MF_UCC11": "Ignore", "Restart with Modified JCL": "No", "Application": "AWSM2", "SubApplication": "Replatform-Custom", "Host": "microfocus-es-host", "Output": {} }, "aws-mf-job4": { "Type": "Job:Micro Focus Windows", "ConnectionProfile": "MICROFOCUS-WINDOWS", "Enable JCL Variables": "unchecked", "Restart on Rerun": "unchecked", "Recapture ABEND Codes": "Ignore", "Recapture COND Codes": "Ignore", "Auto Adjust Restart": "Ignore", "Set MF_UCC11": "Ignore", "Restart with Modified JCL": "No", "Application": "AWSM2", "SubApplication": "Replatform-Custom", "Host": "microfocus-es-host", "Output": {} }, "aws-mf-job5": { "Type": "Job:Micro Focus Windows", "ConnectionProfile": "MICROFOCUS-WINDOWS", "Enable JCL Variables": "unchecked", "Restart on Rerun": "unchecked", "Recapture ABEND Codes": "Ignore", "Recapture COND Codes": "Ignore", "Auto Adjust Restart": "Ignore", "Set MF_UCC11": "Ignore", "Restart with Modified JCL": "No", "Application": "AWSM2", "SubApplication": "Replatform-Custom", "Host": "microfocus-es-host", "Output": {} }, "leftbranch": { "Type": "Flow", "Sequence": [ "aws-mf-job1", "aws-mf-job2", "aws-mf-job3", "aws-mf-job5" ] }, "rightbranch": { "Type": "Flow", "Sequence": [ "aws-mf-job2", "aws-mf-job4", "aws-mf-job5" ] } } } ``` Pour déployer ce flux, utilisez l'API Control-M Automation : ``` ctm deploy Folder-Custom-M2-Replatform.json ``` # Automatisation de l'exécution des tâches à une fréquence planifiée À l'aide du flux que vous avez créé dans les étapes précédentes, vous pouvez ajouter une planification de base et une planification d'exécution. + La planification de base définit les jours pendant lesquels une tâche peut être exécutée (par exemple, tous les jours de la semaine, uniquement les jours ouvrables, en fin de mois ou en fin de trimestre). Vous pouvez définir la planification de base dans l'onglet [Planification](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Job_scheduling.htm). + La planification de l'exécution détermine le moment où une tâche est exécutée le jour où elle est éligible (par exemple, une fois les tâches précédentes terminées, toutes les heures, après la disponibilité de ressources spécifiées ou uniquement après confirmation manuelle). Vous pouvez définir une planification d'exécution dans la section **Planification** et d'autres dans la section **Prérequis**. # Surveillance des tâches Vous pouvez surveiller et vérifier les tâches dans le domaine Control-M Monitoring et dans l'interface [utilisateur d'administration Web commune de Micro Focus Enterprise Server](https://www.microfocus.com/documentation/visual-cobol/vc70/CSWin/GUID-C7A333B6-1DFB-49AC-8DB3-4023C6FCDEFB.html). ## Surveillance Control-M Les soumissions et les exécutions de tâches peuvent être surveillées dans le domaine Surveillance Control-M. Par défaut, les tâches AWS Mainframe Modernization de service apparaîtront avec toutes les autres tâches de type Control-M. Si vous souhaitez voir uniquement les tâches de AWS Mainframe Modernization service sans autre charge de travail (ni aucune autre exigence de filtrage), vous pouvez créer un point de vue. Les points de vue montrent non seulement des informations sur les tâches, mais aussi les relations avec les dépendances en amont et en aval. En outre, si votre flux de travail inclut AWS Mainframe Modernization d'autres types de tâches Control-M, vous pouvez voir et gérer l'ensemble du flux dans le domaine de surveillance. Vous pouvez suivre les étapes détaillées en consultant la [section Points de vue de Monitoring](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Viewpoints.htm) dans la documentation de Control-M. La capture d'écran suivante montre les résultats de deux flux de travail. Sur le côté gauche, le flux de travail est terminé avec les cinq tâches en vert. Sur le côté droit, le flux de travail n'est que partiellement réussi car il a `aws-mf-job3` renvoyé le statut **Échec**, et le flux de travail s'est arrêté là, restant `aws-mf-job5` dans l'état **Calendrier d'attente**. ![\[Diagrammes de flux de travail sur le côté gauche, suivi de la sortie dans l'onglet Sortie du volet droit.\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/control-m-batch-scheduler/images/monitor-jobs-2.png) *Image fournie avec l'aimable autorisation de BMC Software, Inc. ©2022*