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 Integración gestionada con Control-M
En esta sección se describe cómo Control-M se integra y respalda los trabajos por lotes que se ejecutan en un AWS Mainframe Modernization entorno gestionado implementado con un motor de ejecución de Micro Focus. Si va a implementar un entorno AWS Replatform with Micro Focus personalizado en Amazon EC2, consulte [AWS Mainframe Modernization la sección sobre la integración de Amazon EC2](aws-mainframe-modernization-ec2.md) con Control-M.
En esta sección se presuponen los siguientes requisitos previos:
+ Un activo Cuenta de AWS.
+ La aplicación de mainframe se migra y se ejecuta en un entorno de tiempo de ejecución gestionado por AWS Replatform with Micro Focus con varios trabajos por lotes definidos.
+ Para este piloto, la aplicación de BankDemo ejemplo está configurada en. AWS Mainframe Modernization Para obtener instrucciones de configuración, consulte el [tutorial: Managed Runtime for Micro Focus](https://docs.aws.amazon.com/m2/latest/userguide/tutorial-runtime.html).
En los siguientes temas se describe la step-by-step configuración necesaria para la integración entre Control-M Scheduler y el AWS Mainframe Modernization entorno para los distintos tipos de flujos de trabajo de integración:
+ [Implemente los recursos de Control-M](deploy-control-m-resources.md)
+ [Crear un perfil de conexión de Control-M para AWS Mainframe Modernization](connection-profile.md)
+ [Crear trabajos y programas en Control-M Planning](jobs-schedules-control-m.md)
+ [Monitorear trabajos](monitor-jobs.md)
# Implemente los recursos de Control-M
Los dos primeros pasos para integrar la modernización del mainframe de AWS con Control-M son implementar el complemento y el tipo de trabajo.
## Implemente el complemento Control-M AWS Mainframe Modernization
Los complementos proporcionan integración y soporte para las aplicaciones y los servicios que gestiona Control-M. Para el AWS Mainframe Modernization servicio gestionado, implemente el complemento. AWS Mainframe Modernization
El despliegue del complemento es una actividad poco frecuente. Si instala el complemento por primera vez, siga los pasos de la documentación de [Control-M](https://docs.bmc.com/docs/ctm_integrations/control-m-for-aws-mainframe-modernization-1244652367.html). Si ya tiene un complemento que desee utilizar, omita este paso y [cree un perfil de conexión](connection-profile.md).
## 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](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)
1. 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.
1. Inicie sesión en Application Integrator.
1. En la pestaña **Inicio**, seleccione **Importar el tipo de trabajo desde un archivo** y seleccione la ubicación de `AIJOB.ctmai`.
1. Si desea realizar alguna modificación en el ejemplo suministrado, familiarícese con Application Integrator.
1. 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 para AWS Mainframe Modernization
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](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_centralized_connection_profile.htm), puede usar la interfaz gráfica de usuario (GUI) disponible en el dominio de **configuración** de la interfaz web de Control-M, o puede usar JSON.](https://docs.bmc.com/docs/automation-api/monthly/connection-profiles-1116950312.html) Para obtener información sobre el perfil de conexión del AWS Mainframe Modernization complemento, consulte la documentación de [Control-M](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Mainframe_Modernization_Connection_Profiles.htm#AWSMainframeModernizationConnectionProfileParameters).
El siguiente código es un ejemplo del uso 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
}
}
```
Cree un archivo JSON similar al del ejemplo e impleméntelo mediante el servicio de implementación de la [API Control-M Automation](https://docs.bmc.com/docs/automation-api/monthly/deploy-service-1116950327.html). Por ejemplo, si el código JSON se guarda en un archivo denominado`cp-MANAGED-M2-REPLATFORM.json`, la sintaxis de la `ctm` CLI para implementar este perfil de conexión es la siguiente:
```
ctm deploy cp-MANAGED-M2-REPLATFORM.json
```
La respuesta de la API de automatización de Control-M será similar a la siguiente:
```
[
{
"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"
]
}
]
```
# Crear trabajos y programas en Control-M Planning
Ahora que ha implementado el tipo de trabajo y un perfil de conexión para la conectividad de AWS, puede empezar a crear y ejecutar trabajos.
Cada trabajo de AWS Mainframe Modernization servicio consta de un conjunto de atributos, divididos en cuatro secciones. Cada sección puede tener muchos atributos. La siguiente lista muestra 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
+ Programación:
+ Meses y días en los que se puede ejecutar este trabajo
+ Calendarios, como períodos contables empresariales, feriados u otras fechas especiales que no se pueden definir algorítmicamente
+ Ventanas de tiempo
+ Comportamiento cíclico
+ 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 se pueden crear e implementar [en la GUI](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_Job.htm) o [en JSON](https://docs.bmc.com/docs/automation-api/monthly/code-reference-1116950299.html), e implementar mediante Control-M Automation API.
En las siguientes secciones, se examinan algunos escenarios de flujo de trabajo comunes:
+ [Iniciar los trabajos en función del código de estado de los trabajos anteriores](status-code.md)
+ [Automatizar la ejecución de los trabajos con una frecuencia programada](scheduled.md)
+ [El trabajo base se ejecuta en función de eventos](event-based.md)
# Iniciar los trabajos en función del estado de los trabajos anteriores
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 la GUI web de Control-M
Para iniciar un trabajo desde la interfaz de usuario de Control-M, haga lo siguiente:
1. **En el dominio de **planificación**, añada un nuevo espacio de trabajo.** Esto abre un lienzo con un objeto de carpeta vacía.
1. Seleccione el tipo de AWS Mainframe Modernization trabajo (si utiliza la plantilla de tipo de trabajo proporcionada, se denomina [M2JOB](https://github.com/aws-samples/aws-mainframe-modernization-controlm-integration/blob/main/assets/AWS-jobs.json)) y arrástrelo a la carpeta.
1. Cuando el color del tipo de 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. A continuación, necesitará los valores del **Nombre del trabajo** para configurar los tipos de trabajo. Puede encontrar los valores del **nombre del trabajo** en la pantalla de definición de la **aplicación** de la AWS Mainframe Modernization consola o ejecutando la [ListBatchJobDefinitions API](https://docs.aws.amazon.com/m2/latest/APIReference/API_ListBatchJobDefinitions.html). Para este programa piloto, repita los pasos 2 a 4 para varios trabajos y asigne el nombre que desee a cada uno de ellos. Algunos nombres de ejemplo son `CBANK``CURRENCY`, I`NVFUNDS`, `BROKERAGE``RISKMGMT`, y. `BANK-SERVICE-Managed-M2`
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 `CBANK` y arrástrelo hasta él`CURRENCY`. Esta acción convierte a `CBANK` la predecesora de`CURRENCY`. De forma predeterminada, ahora `CBANK` debe completarse correctamente antes de que CURRENCY pueda ejecutarse.
La siguiente captura de pantalla muestra la vista de planificación de Control-M del flujo de trabajo básico.
![\[Job flow a la izquierda y propiedades a la derecha.\]](http://docs.aws.amazon.com/es_es/prescriptive-guidance/latest/control-m-batch-scheduler/images/workflow-control-m-web-1.png)
*Imagen proporcionada por cortesía de BMC Software, Inc. ©2022*
## Mediante JSON
El mismo flujo se puede codificar 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"
]
}
}
}
```
Para implementar este flujo, usa el servicio de implementación:
```
ctm deploy folder-MANAGED-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 los días en que se puede ejecutar 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).
+ La programación del tiempo de ejecución determina cuándo se ejecutará un trabajo el día en que pueda ejecutarse (por ejemplo, cada hora, una vez que haya recursos específicos disponibles o solo después de una confirmación manual).
Puede configurar la programación básica y de tiempo de ejecución en la pestaña de **Programación**.
# El trabajo base se ejecuta en función de eventos
La transferencia de archivos gestionada (MFT) de Control-M es un FTP/SFTP cliente y un servidor que puede usar para ver y transferir archivos entre un host local y un host remoto. Para obtener más información sobre la definición de un trabajo de File Transfer, consulte la [Documentación de Control-M](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/File_Transfer_Job.htm).
En este piloto, se utiliza el trabajo de File Transfer para ver un evento de creación de archivos con la extensión .poc en la carpeta `/bmcfile` en un bucket de S3 con el nombre `bmc-poc-bucket`. Cuando se produce ese evento, se inicia el trabajo de Control-M para ejecutar el siguiente trabajo. Si lo desea, puede pasar la ruta completa, incluido el nombre del bucket.
# Monitorear trabajos
Puede supervisar y validar el procesamiento de los trabajos dentro del dominio de monitorización de Control-M y a través de él Consola de administración de AWS, lo que garantiza una observación y verificación exhaustivas en ambas plataformas.
## 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.
Para seguir los pasos detallados, consulte 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 correctamente con todos los trabajos en verde. En el lado derecho, el flujo de trabajo solo se ha realizado parcialmente porque el trabajo `CURRRENCY` devolvió el estado **Fallido**, que se indica con el color rojo. El flujo de trabajo se detuvo allí, dejando los trabajos restantes en el estado de **programación de espera**.
![\[Los diagramas de los flujos de trabajo están a la izquierda y las propiedades de los trabajos a la derecha.\]](http://docs.aws.amazon.com/es_es/prescriptive-guidance/latest/control-m-batch-scheduler/images/monitor-jobs.png)
*Imagen proporcionada por cortesía de BMC Software, Inc. ©2022*
## Supervisión en la consola
Para ver la información sobre el trabajo y el registro AWS, inicie sesión en la [AWS Mainframe Modernization consola y Consola de administración de AWS, a continuación, navegue hasta ella](https://console.aws.amazon.com/m2/home?region=us-east-1#/applications).
![\[Los trabajos y los estados se muestran en la consola de modernización de mainframe de AWS.\]](http://docs.aws.amazon.com/es_es/prescriptive-guidance/latest/control-m-batch-scheduler/images/monitor-jobs-aws-management-console.png)
Esta vista no incluye las dependencias ni ninguna carga de trabajo que no esté gestionada por el servicio. AWS Mainframe Modernization