Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # AWS Mainframe Modernization sobre la integración de Amazon EC2 con Control-M En esta sección, se describe cómo Control-M se integra y admite los trabajos por lotes que se ejecutan en un entorno de ejecución personalizado de AWS Mainframe Modernization implementado en una instancia EC2. Si va a implementar el entorno de ejecución AWS Replatform con Micro Focus totalmente gestionado, consulte la sección [AWS Mainframe Modernization Integración gestionada con Control-M](aws-mainframe-modernization-managed.md). En esta sección se asumen los siguientes requisitos previos: + Una cuenta de AWS activa. + Una nube privada virtual (VPC) donde se crearán las instancias de EC2. + La aplicación de mainframe se migra y se ejecuta en un entorno AWS Replatform with Micro Focus en una instancia EC2 y es compatible con el motor de ejecución de Micro Focus con varios trabajos por lotes definidos. Para este programa piloto, siga las instrucciones que se indican en Cómo cambiar la [plataforma de las aplicaciones con Micro Focus](https://docs.aws.amazon.com/m2/latest/userguide/replatforming-m2.html). La documentación incluye todas las tareas e información adicional sobre la configuración y el funcionamiento del entorno de ejecución AWS Replatform with Micro Focus en Amazon EC2. En los siguientes temas se describe la configuración necesaria para la integración entre Control-M y el entorno AWS Replatform with Micro Focus: + [Implemente los recursos de Control-M y Micro Focus](deploy-resources-environment.md) + [Cree un perfil de conexión de Control-M](create-control-m-connection-profile.md) + [Crear trabajos y programas en Control-M Planning](create-jobs-schedules-control-m-planning.md) + [Administre las ejecuciones de tareas en Control-M mediante la supervisión](monitor.md) # Implemente los recursos de Control-M y Micro Focus Los dos primeros pasos para integrar la modernización del mainframe de AWS con Control-M son implementar un agente de Control-M y, a continuación, implementar un complemento en el agente. El tercer paso consiste en implementar el tipo de trabajo en Control-M Application Integrator. ## Implemente un agente de Control-M en una instancia EC2 Cuando se utiliza una plataforma AWS Replatform personalizada con Micro Focus en un entorno de ejecución de Amazon EC2, se invoca `MFBSIFJCL` la utilidad. La utilidad funciona en el host que se lanzó con la oferta de Micro Focus Enterprise Server del. AWS Marketplace Para ejecutar la `MFBSIFJCL` utilidad, también debe implementar un agente de Control-M en ese host. Para obtener instrucciones, consulte la documentación de [Control-M](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Agent_Installation.htm). **nota** Puede descargar los medios de instalación necesarios desde el sitio de descargas de [productos electrónicos de BMC](https://www.bmc.com/support/resources/product-downloads.html). ## Implemente el complemento Micro Focus en el Control-M Agent Los complementos proporcionan integración y soporte para las aplicaciones y los servicios que gestiona Control-M. El despliegue de complementos es una actividad poco frecuente. Si ya tiene un complemento que desee utilizar, omita este paso y cree un perfil de conexión. En Amazon EC2, el servicio AWS Mainframe Modernization Replatform with Micro Focus expone el motor Micro Focus. Para la integración AWS Mainframe Modernization, Control-M utiliza el complemento Micro Focus. Para obtener más información, consulte la documentación de [Control-M](https://docs.bmc.com/docs/ctm_integrations/control-m-for-micro-focus-1193641959.html). Debe implementar este complemento en un agente que esté instalado en un host en el que se ejecute Micro Focus Enterprise Server. ## Implemente un tipo de AWS Mainframe Modernization trabajo en Control-M Application Integrator La implementación del tipo de trabajo suele ser una actividad que se realiza una sola vez. Si ya cuenta con un tipo de trabajo existente que desea utilizar, omita este paso y continúe con el siguiente para [crear un perfil de conexión](create-control-m-connection-profile.md). El tipo de trabajo de ejemplo [AIJOB.ctmai](https://github.com/aws-samples/aws-mainframe-modernization-controlm-integration/blob/main/assets/AIJOB.ctmai) se suministra en el repositorio de git. [Para implementar un tipo de trabajo, debe realizar los siguientes pasos con Application Integrator:](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Application_Integrator.htm) + Clone el GitHub repositorio [aws-mainframe-modernization-controlmde integración](https://github.com/aws-samples/aws-mainframe-modernization-controlm-integration) y descargue el `AIJOB.ctmai` archivo en una ubicación del sistema de archivos a la que pueda acceder Application Integrator. + Inicie sesión en Application Integrator. + En la pestaña **Inicio**, seleccione **Importar el tipo de trabajo desde un archivo** y seleccione la ubicación de `AIM2JOB.ctmai`. + Si desea realizar alguna modificación en el ejemplo suministrado, familiarícese con Application Integrator. + Implemente el tipo de trabajo al seguir las instrucciones de la [Documentación de Control-M](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Deploying_and_Publishing_a_Plug-in.htm). # Cree un perfil de conexión Control-M Los perfiles de conexión definen los atributos de conexión y las credenciales de seguridad para una instancia específica de una aplicación. Varios trabajos pueden hacer referencia a cada perfil de conexión. Puede tener perfiles independientes para cada combinación única de una aplicación y credenciales. Para definir los perfiles de conexión, puede usar el [dominio de configuración](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_centralized_connection_profile.htm) de la interfaz web de Control-M o puede usar JSON. El siguiente código es un ejemplo del uso 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": "*****" } } ``` El código de ejemplo está en el archivo `ConnectionProfile-Custom-M2-Replatform.json` del GitHub repositorio. Para implementar el código, utilice el servicio de despliegue de la API de Control-M Automation: ``` ctm deploy ConnectionProfile-Custom-M2-Replatform.json ``` La respuesta de la API de automatización de Control-M será similar a la siguiente: ``` [ { "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 " ] } ] ``` # Crear trabajos y programas en Control-M Planning Ahora que ha implementado el complemento y un perfil de conexión para la conectividad de Micro Focus, puede empezar a crear y ejecutar trabajos. Cada trabajo de Control-M for Micro Focus consta de un conjunto de atributos repartidos en cuatro secciones. Cada sección puede tener muchos atributos. En la siguiente lista se muestran algunos de los atributos que se utilizan con más frecuencia. + General: + El nombre del trabajo + La aplicación y la subaplicación a las que pertenece el trabajo + El JCL a enviar + Un enlace a la documentación operativa proporcionada en el sitio + Programación: + Meses y días en los que se puede ejecutar este trabajo + Calendarios, como los períodos contables de una empresa, los feriados u otras fechas especiales que no se pueden definir algorítmicamente + Ventanas de tiempo + Comportamiento cíclico, como correr cada hora + Requisitos previos + Dependencias ascendentes (por lo general trabajos, que se deben completar de forma correcta antes de que este trabajo pueda ejecutarse) + Recursos que podrían necesitarse + Acción del usuario que podría necesitarse + Acciones que realiza Control-M al finalizar el trabajo: + Determinar el éxito o el fracaso del trabajo (normalmente en función de los códigos de finalización del trabajo, pero puede anular esa configuración para utilizar el texto de salida o comprobar un estado específico) + Notificaciones, como por correo electrónico, en caso de error o éxito + Estado de publicación de las dependencias descendentes Al igual que con los perfiles de conexión, los trabajos pueden crearse e implementarse [mediante Control-M Web](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_Job.htm) o [escribirse en JSON](https://docs.bmc.com/docs/automation-api/monthly/code-reference-1116950299.html) e implementarse mediante la API de automatización de Control-M. En las siguientes secciones, se examinan algunos escenarios de flujo de trabajo comunes: + [Inicie los trabajos mediante un flujo de trabajo](initiate-jobs.md) + [Automatizar la ejecución de los trabajos con una frecuencia programada](automate-jobs.md) # Inicie los trabajos mediante un flujo de trabajo Cree un flujo de trabajos denominado flujo de trabajo. Los trabajos del flujo de trabajo se encuentran interconectados y dependen de la finalización exitosa de los trabajos anteriores. ## Uso de Control-M Web Para iniciar un trabajo desde la interfaz de usuario de Control-M, haga lo siguiente: 1. En el dominio de planificación, agregue un espacio de trabajo nuevo. Esto abre un lienzo con un objeto de carpeta vacía. 1. En la barra de menús, seleccione **Añadir trabajo**, elija el trabajo de Micro Focus Windows o Micro Focus Linux y arrástrelo hasta el anverso de la carpeta. 1. Cuando el color del trabajo cambie a verde, suéltelo. El panel de la derecha contiene las secciones **General**, **Programación**, **Requisitos previos** y **Acciones**. Para crear el trabajo, consulte las instrucciones estándar en la documentación de [Control-M](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_Job.htm). 1. [Para obtener instrucciones sobre cómo crear un trabajo de Control-M para Micro Focus, consulte la documentación de Control-M.](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Jobs_for_Mainframe_Modernization.htm#MicroFocusJob) Para este programa piloto, repita los pasos 2 a 4 para cinco trabajos, nombrando cada uno de ellos de a. `aws-mf-job1` `aws-mf-job5` 1. Para conectar estas tareas al flujo que desee, elija el triángulo de condición situado debajo del objeto de la tarea y arrástrelo hasta la siguiente tarea. Por ejemplo, elija el triángulo de condición situado debajo `aws-mf-job1` y arrástrelo hasta él`aws-mf-job2`. Esta acción convierte a `aws-mf-job1` la predecesora de`aws-mf-job2`. De forma predeterminada, ahora `aws-mf-job1` debe completarse correctamente antes `aws-mf-job2` de que pueda ejecutarse. En el siguiente diagrama, se muestra la vista de Control-M Planning del flujo de trabajo básico. ![\[Diagrama de flujo de trabajo, con las propiedades en el panel derecho.\]](http://docs.aws.amazon.com/es_es/prescriptive-guidance/latest/control-m-batch-scheduler/images/control-m-web-planning.png) *Imagen proporcionada por cortesía de BMC Software, Inc. ©2022* ## Mediante JSON El mismo flujo se puede codificar en JSON. En el GitHub repositorio, el código de ejemplo está en el archivo`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" ] } } } ``` Para implementar este flujo, usa la API de automatización Control-M: ``` ctm deploy Folder-Custom-M2-Replatform.json ``` # Automatizar la ejecución de los trabajos con una frecuencia programada Con el flujo que creó en los pasos anteriores, puede agregar la programación básica y de tiempo de ejecución. + La programación básica define qué días puede ejecutarse un trabajo (por ejemplo, todos los días de la semana, solo los días laborables, al final del mes o al final del trimestre). Puede configurar la programación básica en la pestaña [Programación](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Job_scheduling.htm). + La programación del tiempo de ejecución determina cuándo se ejecuta un trabajo el día en que puede ejecutarse (por ejemplo, después de que se completen los trabajos anteriores, cada hora, después de que estén disponibles los recursos específicos o solo después de una confirmación manual). Puede definir parte de la programación del tiempo de ejecución en la sección **Programación** y otras en la sección **Requisitos previos**. # Monitorear trabajos Puede supervisar y verificar los trabajos en el dominio de supervisión de Control-M y en la interfaz de usuario de administración [web común de Micro Focus Enterprise Server](https://www.microfocus.com/documentation/visual-cobol/vc70/CSWin/GUID-C7A333B6-1DFB-49AC-8DB3-4023C6FCDEFB.html). ## Control-M Monitoring Los envíos y ejecuciones de trabajos se pueden monitorear en el Dominio de Control-M Monitoring. De forma predeterminada, los trabajos AWS Mainframe Modernization de servicio aparecerán junto con todos los demás trabajos de Control-M. Si desea ver solo los trabajos de AWS Mainframe Modernization servicio sin ninguna otra carga de trabajo (ni ningún otro requisito de filtrado), puede crear un Viewpoint. Los puntos de vista muestran no solo la información del trabajo, sino que también las relaciones con las dependencias ascendentes y descendentes. Además, si su flujo de trabajo incluye AWS Mainframe Modernization y otros tipos de trabajos de Control-M, puede ver y administrar todo el flujo en el dominio de supervisión. Puede seguir los pasos detallados visitando la [sección Puntos de vista de la supervisión en la documentación de Control-M](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Viewpoints.htm). En la siguiente captura de pantalla, se muestran los resultados de dos flujos de trabajo. En el lado izquierdo, el flujo de trabajo se ha completado de forma correcta con los cinco trabajos en verde. En el lado derecho, el flujo de trabajo solo se ha realizado parcialmente, ya que `aws-mf-job3` devolvió el estado **Fallido** y el flujo de trabajo se detuvo allí, quedando `aws-mf-job5` en estado de programación de **espera**. ![\[Diagramas de flujo de trabajo en la parte izquierda, que supervisan los resultados en la pestaña Salida del panel derecho.\]](http://docs.aws.amazon.com/es_es/prescriptive-guidance/latest/control-m-batch-scheduler/images/monitor-jobs-2.png) *Imagen proporcionada por cortesía de BMC Software, Inc. ©2022*