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 Intégration gérée avec 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 AWS Mainframe Modernization environnement géré déployé avec un moteur d'exécution Micro Focus. Si vous implémentez un environnement de AWS replateforme personnalisé avec Micro Focus sur Amazon EC2, consultez [AWS Mainframe Modernization la section sur l'intégration d'Amazon EC2](aws-mainframe-modernization-ec2.md) à Control-M. Cette section suppose les prérequis suivants : + Un actif Compte AWS. + L'application mainframe est migrée et exécutée dans un environnement d'exécution géré AWS Replatform avec Micro Focus avec plusieurs tâches par lots définies. + Pour ce pilote, l' BankDemo exemple d'application est configuré dans AWS Mainframe Modernization. Pour les instructions de configuration, voir [Tutoriel : Managed Runtime for Micro Focus](https://docs.aws.amazon.com/m2/latest/userguide/tutorial-runtime.html). Les rubriques suivantes décrivent la step-by-step configuration requise pour l'intégration entre Control-M Scheduler et l' AWS Mainframe Modernization environnement pour différents types de flux de travail d'intégration : + [Déployer les ressources Control-M](deploy-control-m-resources.md) + [Create a Control-M connection profile for AWS Mainframe Modernization](connection-profile.md) + [Create jobs and schedules in Control-M Planning](jobs-schedules-control-m.md) + [Monitor jobs](monitor-jobs.md) # Déployer les ressources Control-M Les deux premières étapes de l'intégration d'AWS Mainframe Modernization à Control-M consistent à déployer le plug-in et le type de tâche. ## Déployez le plug-in AWS Mainframe Modernization Control-M Les plug-ins assurent l'intégration et le support des applications et des services orchestrés par Control-M. Pour le AWS Mainframe Modernization service géré, déployez le AWS Mainframe Modernization plug-in. Le déploiement du plug-in est une activité peu fréquente. Si vous installez le plug-in pour la première fois, suivez les étapes décrites dans la documentation de [Control-M](https://docs.bmc.com/docs/ctm_integrations/control-m-for-aws-mainframe-modernization-1244652367.html). Si vous souhaitez utiliser un plug-in existant, ignorez cette étape et [créez un profil de connexion](connection-profile.md). ## 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](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) : 1. 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. 1. Connectez-vous à Application Integrator. 1. Sur l'onglet **Accueil**, sélectionnez **Importer le type de tâche depuis un fichier**, puis sélectionnez l'emplacement de `AIJOB.ctmai`. 1. Si vous souhaitez apporter des modifications à l'exemple fourni, familiarisez-vous avec Application Integrator. 1. 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éez un profil de connexion Control-M pour AWS Mainframe Modernization 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 les profils de connexion](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_centralized_connection_profile.htm), vous pouvez utiliser l'interface utilisateur graphique (GUI) disponible dans le domaine **Configuration** de l'interface Web Control-M, ou vous pouvez utiliser le JSON.](https://docs.bmc.com/docs/automation-api/monthly/connection-profiles-1116950312.html) Pour plus d'informations sur le profil de connexion du AWS Mainframe Modernization plug-in, consultez la documentation [Control-M](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Mainframe_Modernization_Connection_Profiles.htm#AWSMainframeModernizationConnectionProfileParameters). Le code suivant est un exemple d'utilisation de JSON : ``` { "MANAGED-M2-REPLATFORM": { "Type": "ConnectionProfile:AWS Mainframe Modernization", "Mainframe Modernization URL": "https://m2.{{AwsRegion}}.amazonaws.com", "Connection Timeout": "30", "AWS Region": "us-west-2", "Authentication": "NoSecret", "IAM Role": "--- IAM Role name ---", "AWS Logs URL": "https://logs.{{AwsRegion}}.amazonaws.com", "Description": "", "Centralized": true } } ``` Créez un fichier JSON similaire à l'exemple et déployez-le à l'aide du service de [déploiement de l'API Control-M Automation](https://docs.bmc.com/docs/automation-api/monthly/deploy-service-1116950327.html). Par exemple, si le code JSON est enregistré dans un fichier nommé`cp-MANAGED-M2-REPLATFORM.json`, la syntaxe de la `ctm` CLI pour déployer ce profil de connexion est la suivante : ``` ctm deploy cp-MANAGED-M2-REPLATFORM.json ``` La réponse de l'API Control-M Automation sera similaire à la suivante : ``` [ { "deploymentFile": "cp-Managed-M2-REPLATFORM.json", "deploymentState": "DEPLOYED_CONNECTION_PROFILES", "deploymentStatus": "ENDED_OK", "successfulFoldersCount": 0, "successfulSmartFoldersCount": 0, "successfulSubFoldersCount": 0, "successfulJobsCount": 0, "successfulConnectionProfilesCount": 1, "successfulDriversCount": 0, "isDeployDescriptorValid": false, "deployedConnectionProfiles": [ "MANAGED-M2-REPLATFORM" ] } ] ``` # Création de tâches et de calendriers dans Control-M Planning Maintenant que le type de tâche est déployé et que vous disposez d'un profil de connexion pour la connectivité AWS, vous pouvez commencer à créer et à exécuter des tâches. Chaque tâche de AWS Mainframe Modernization service 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 + Un lien vers la documentation + 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 + Prérequis : + 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 [dans l'interface graphique utilisateur](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_Job.htm) ou [au format JSON](https://docs.bmc.com/docs/automation-api/monthly/code-reference-1116950299.html) et déployées à l'aide de l'API Control-M Automation. Les sections suivantes examinent certains scénarios de flux de travail courants : + [Initiate jobs based on the status code of previous jobs](status-code.md) + [Automate job runs on a scheduled frequency](scheduled.md) + [Base job runs on events](event-based.md) # Initiate jobs based on the status of previous jobs 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 l'interface graphique Web de Control-M Pour lancer une tâche depuis l'interface utilisateur Control-M, procédez comme suit : 1. Dans le domaine **de planification**, ajoutez un nouvel **espace de travail**. Cela permet d'ouvrir un canevas contenant un objet de dossier vide. 1. Sélectionnez le type de AWS Mainframe Modernization tâche (si vous utilisez le modèle de type de tâche fourni, celui-ci s'appelle [M2JOB](https://github.com/aws-samples/aws-mainframe-modernization-controlm-integration/blob/main/assets/AWS-jobs.json)) et faites-le glisser vers le dossier. 1. Lorsque la couleur du type de 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. Ensuite, vous avez besoin des valeurs du **nom de la tâche** pour configurer les types de tâches. Vous pouvez trouver les valeurs du **nom du Job** sur l'écran de définition de l'**application** de la AWS Mainframe Modernization console ou en exécutant l'[ListBatchJobDefinitions API](https://docs.aws.amazon.com/m2/latest/APIReference/API_ListBatchJobDefinitions.html). Pour ce pilote, répétez les étapes 2 à 4 pour plusieurs tâches, en attribuant à chacune d'elles le nom de votre choix. Les exemples de noms sont `CBANK` `CURRENCY``NVFUNDS`, I`BROKERAGE`,`RISKMGMT`, et`BANK-SERVICE-Managed-M2`. 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 `CBANK` ci-dessous et faites-le glisser dessus`CURRENCY`. Cette action fait `CBANK` du prédécesseur de`CURRENCY`. Par défaut, `CBANK` il doit désormais être terminé avec succès pour que CURRENCY puisse être exécuté. La capture d'écran suivante montre la vue Control-M Planning du flux de travail de base. ![\[Le flux de tâches sur la gauche et les propriétés sur la droite.\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/control-m-batch-scheduler/images/workflow-control-m-web-1.png) *Image fournie avec l'aimable autorisation de BMC Software, Inc. ©2022* ## Utilisation de JSON Le même flux peut être codé en JSON : ``` { "Defaults": { "Application": "AWSM2", "SubApplication": "Replatform-Managed", "Job": { "Host": "ctm-worker", "Output": {} } }, "jog-managed-m2": { "Type": "Folder", "ControlmServer": "psctm", "OrderMethod": "Manual", "SiteStandard": "_z_DemoBusinessFlows", "CBANK": { "Type": "Job:AWS Mainframe Modernization", "ConnectionProfile": "MANAGED-M2-REPLATFORM", "JCL Name": "iefbr14", "Retrieve CloudWatch Logs": "checked", "Action": "Start Batch Job", "Application Version": "1" }, "CURRENCY": { "Type": "Job:AWS Mainframe Modernization", "ConnectionProfile": "MANAGED-M2-REPLATFORM", "JCL Name": "iefbr14", "Retrieve CloudWatch Logs": "checked", "Action": "Start Batch Job", "Application Version": "1" }, "BROKERAGE": { "Type": "Job:AWS Mainframe Modernization", "ConnectionProfile": "MANAGED-M2-REPLATFORM", "JCL Name": "iefbr14", "Retrieve CloudWatch Logs": "checked", "Action": "Start Batch Job", "Application Version": "1" }, "INVFUNDS": { "Type": "Job:AWS Mainframe Modernization", "ConnectionProfile": "MANAGED-M2-REPLATFORM", "JCL Name": "iefbr14", "Retrieve CloudWatch Logs": "checked", "Action": "Start Batch Job", "Application Version": "1" }, "RISKMGMT": { "Type": "Job:AWS Mainframe Modernization", "ConnectionProfile": "MANAGED-M2-REPLATFORM", "JCL Name": "iefbr14", "Retrieve CloudWatch Logs": "checked", "Action": "Start Batch Job", "Application Version": "1" }, "BANK-SERVICE-Managed-M2": { "Type": "Job:SLAManagement", "ServiceName": "Bank Service - Managed M2", "RunAs": "ctmagent", "CompleteBy": { "Time": "12:00", "Days": "0" } }, "leftbranch": { "Type": "Flow", "Sequence": [ "CURRENCY", "RISKMGMT", "BANK-SERVICE-Managed-M2" ] }, "middlebranch": { "Type": "Flow", "Sequence": [ "CBANK", "CURRENCY", "INVFUNDS", "BANK-SERVICE-Managed-M2" ] }, "rightbranch": { "Type": "Flow", "Sequence": [ "CURRENCY", "BROKERAGE", "BANK-SERVICE-Managed-M2" ] } } } ``` Pour déployer ce flux, utilisez le service de déploiement : ``` ctm deploy folder-MANAGED-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). + La planification de l'exécution détermine le moment où une tâche sera exécutée le jour où elle peut être exécutée (par exemple, toutes les heures, une fois que des ressources spécifiées sont disponibles, ou uniquement après confirmation manuelle). Vous pouvez définir la planification de base et la planification de l'exécution sur l'onglet **Planification**. # Baser l'exécution des tâches sur des événements Control-M Managed File Transfer (MFT) est un FTP/SFTP client et un serveur que vous pouvez utiliser pour surveiller et transférer des fichiers entre un hôte local et un hôte distant. Pour plus d'informations sur la définition d'une tâche de transfert de fichiers, veuillez consulter la [documentation Control-M](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/File_Transfer_Job.htm). Ce pilote utilise la tâche de transfert de fichiers pour détecter tout événement de création de fichier portant l'extension .poc dans le dossier `/bmcfile` d'un compartiment S3 nommé `bmc-poc-bucket`. Lorsque cet événement se produit, la tâche Control-M est lancée pour exécuter la tâche suivante. Vous pouvez éventuellement transmettre le chemin complet, y compris le nom du compartiment. # Surveillance des tâches Vous pouvez surveiller et valider le traitement des tâches dans le domaine de surveillance Control-M et par le biais de celui-ci AWS Management Console, en garantissant une observation et une vérification complètes sur ces deux plateformes. ## 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. Pour suivre les étapes détaillées, consultez la [section Points de vue de la section Surveillance](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 succès avec toutes les tâches en vert. Sur le côté droit, le flux de travail n'est que partiellement réussi car la tâche a `CURRRENCY` renvoyé le statut **Echec**, indiqué par la couleur rouge. Le flux de travail s'est arrêté là, laissant les tâches restantes dans l'état **Calendrier d'attente**. ![\[Schémas des flux de travail à gauche, propriétés des tâches à droite.\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/control-m-batch-scheduler/images/monitor-jobs.png) *Image fournie avec l'aimable autorisation de BMC Software, Inc. ©2022* ## Surveillance sur la console Pour consulter les informations relatives aux tâches et à la connexion AWS AWS Management Console, connectez-vous à la [AWS Mainframe Modernization console, puis accédez à celle-ci](https://console.aws.amazon.com/m2/home?region=us-east-1#/applications). ![\[Tâches et statuts répertoriés sur la console AWS Mainframe Modernization.\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/control-m-batch-scheduler/images/monitor-jobs-aws-management-console.png) Cette vue n'inclut pas les dépendances ni aucune charge de travail non gérée par le AWS Mainframe Modernization service.