As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# AWS Mainframe Modernization Integração gerenciada com o Control-M
Esta seção descreve como o Control-M se integra e oferece suporte a trabalhos em lote executados em um AWS Mainframe Modernization ambiente gerenciado implantado com um mecanismo de tempo de execução da Micro Focus. Se você estiver implementando uma AWS replataforma personalizada com o ambiente Micro Focus no Amazon EC2, consulte a seção sobre a integração [AWS Mainframe Modernization do Amazon EC2](aws-mainframe-modernization-ec2.md) com o Control-M.
Esta seção pressupõe os seguintes pré-requisitos:
+ Um ativo Conta da AWS.
+ O aplicativo de mainframe é migrado e executado em uma AWS plataforma com ambiente de tempo de execução gerenciado da Micro Focus com vários trabalhos em lotes definidos.
+ Para este piloto, o aplicativo de BankDemo exemplo está configurado em AWS Mainframe Modernization. Para obter instruções de configuração, consulte [Tutorial: Managed Runtime for Micro Focus](https://docs.aws.amazon.com/m2/latest/userguide/tutorial-runtime.html).
Os tópicos a seguir descrevem a step-by-step configuração necessária para a integração entre o Control-M Scheduler e o AWS Mainframe Modernization ambiente para diferentes tipos de fluxos de trabalho de integração:
+ [Implemente recursos do Control-M](deploy-control-m-resources.md)
+ [Criar um perfil de conexão do Control-M para o AWS Mainframe Modernization](connection-profile.md)
+ [Criar trabalhos e programações no Control-M Planning](jobs-schedules-control-m.md)
+ [Monitorar trabalhos](monitor-jobs.md)
# Implemente recursos do Control-M
As duas primeiras etapas na integração da AWS Mainframe Modernization com o Control-M são implantar o plug-in e o tipo de trabalho.
## Implemente o AWS Mainframe Modernization plug-in Control-M
Os plug-ins fornecem integração e suporte para os aplicativos e serviços que o Control-M orquestra. Para o AWS Mainframe Modernization serviço gerenciado, implante o AWS Mainframe Modernization plug-in.
A implantação do plug-in é uma atividade pouco frequente. Se estiver instalando o plug-in pela primeira vez, siga as etapas na documentação do [Control-M](https://docs.bmc.com/docs/ctm_integrations/control-m-for-aws-mainframe-modernization-1244652367.html). Se você tiver um plug-in existente que deseja usar, pule esta etapa e [crie um perfil de conexão](connection-profile.md).
## Implantar um tipo de AWS Mainframe Modernization tarefa no Control-M Application Integrator
A implantação do tipo de trabalho geralmente é uma atividade que deve ser realizada uma única vez. Se você já tem um tipo de trabalho existente que deseja usar, ignore esta etapa e prossiga para a próxima etapa de [criação de um perfil de conexão](connection-profile.md).
O tipo de trabalho de exemplo [AIJOB.ctmai](https://github.com/aws-samples/aws-mainframe-modernization-controlm-integration/blob/main/assets/AIJOB.ctmai) é fornecido no repositório git. Para implantar um tipo de trabalho, você deve executar as seguintes etapas usando o [Application Integrator:](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Application_Integrator.htm)
1. Clone o GitHub repositório [aws-mainframe-modernization-controlm-integration](https://github.com/aws-samples/aws-mainframe-modernization-controlm-integration) e baixe o `AIJOB.ctmai` arquivo em um local do sistema de arquivos que possa ser acessado pelo Application Integrator.
1. Faça login no Application Integrator.
1. Na guia **Início**, selecione **Importar tipo de trabalho do arquivo** e selecione a localização do `AIJOB.ctmai`.
1. Se desejar fazer alguma modificação no exemplo fornecido, familiarize-se com o Application Integrator.
1. Implante o tipo de tarefa seguindo as instruções na [documentação do Control-M](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Deploying_and_Publishing_a_Plug-in.htm).
# Crie um perfil de conexão Control-M para AWS Mainframe Modernization
Os perfis de conexão definem atributos de conexão e credenciais de segurança para uma instância específica de uma aplicação. Cada perfil de conexão pode ser referenciado por vários trabalhos. É possível ter perfis separados para cada combinação exclusiva de uma aplicação e credenciais.
[Para [definir perfis de conexão](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_centralized_connection_profile.htm), você pode usar a interface gráfica do usuário (GUI) disponível no domínio de **configuração** da interface Web Control-M ou usar o JSON.](https://docs.bmc.com/docs/automation-api/monthly/connection-profiles-1116950312.html) Para obter informações sobre o perfil de conexão do AWS Mainframe Modernization plug-in, consulte a documentação do [Control-M](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Mainframe_Modernization_Connection_Profiles.htm#AWSMainframeModernizationConnectionProfileParameters).
O código a seguir é um exemplo de 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
}
}
```
Crie um arquivo JSON semelhante ao exemplo e implante-o usando o serviço de implantação da [API de automação Control-M](https://docs.bmc.com/docs/automation-api/monthly/deploy-service-1116950327.html). Por exemplo, se o código JSON for salvo em um arquivo chamado`cp-MANAGED-M2-REPLATFORM.json`, a sintaxe da `ctm` CLI para implantar esse perfil de conexão é a seguinte:
```
ctm deploy cp-MANAGED-M2-REPLATFORM.json
```
A resposta da API de automação Control-M será semelhante à seguinte:
```
[
{
"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"
]
}
]
```
# Criar trabalhos e programações no Control-M Planning
Agora que você tem o tipo de trabalho implantado e um perfil de conexão para conectividade com a AWS, você pode começar a criar e executar trabalhos.
Cada tarefa de AWS Mainframe Modernization serviço consiste em um conjunto de atributos, em quatro seções. Cada seção pode ter muitos atributos. A lista a seguir mostra alguns dos atributos mais usados.
+ Geral:
+ O nome do trabalho.
+ A aplicação e a subaplicação às quais o trabalho pertence
+ O JCL a ser enviado
+ Um link para a documentação
+ Programação:
+ Meses e dias para os quais este trabalho está qualificado para execução
+ Calendários, como períodos contábeis comerciais, feriados ou outras datas especiais que não podem ser definidos algoritmicamente
+ Janelas de tempo
+ Comportamento cíclico
+ Pré-requisitos:
+ Dependências upstream (geralmente trabalhos que devem ser concluídos com êxito antes que esse trabalho se torne elegível para execução)
+ Recursos que podem ser necessários
+ Ação do usuário que pode ser necessária
+ Ações realizadas pelo Control-M após a conclusão do trabalho:
+ Determinar o sucesso ou o fracasso do trabalho (geralmente com base nos códigos de conclusão do trabalho, mas você pode substituir essa configuração para usar o texto de saída ou verificar um status específico)
+ Notificações, como e-mail, para falhas ou sucesso
+ Status de publicação para dependências posteriores
Assim como nos perfis de conexão, os trabalhos podem ser criados e implantados [na GUI](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_Job.htm) ou [em JSON](https://docs.bmc.com/docs/automation-api/monthly/code-reference-1116950299.html) e implantados usando a API de automação do Control-M.
As seções a seguir examinam alguns cenários comuns de fluxo de trabalho:
+ [Iniciar trabalhos com base no código de status de trabalhos anteriores](status-code.md)
+ [Automatizar execuções de trabalhos em uma frequência programada](scheduled.md)
+ [Execução de trabalhos base em eventos](event-based.md)
# Iniciar trabalhos com base no status de trabalhos anteriores
Crie um fluxo de trabalhos chamado fluxo de trabalho. Os trabalhos no fluxo de trabalho são interconectados com dependências após a conclusão bem-sucedida dos trabalhos anteriores.
## Usando a GUI da Web Control-M
Para iniciar um trabalho a partir da interface de usuário do Control-M, faça o seguinte:
1. No domínio **Planning**, adicione um novo **espaço de trabalho**. Isso abre uma tela com um objeto de pasta vazio.
1. Selecione o tipo de AWS Mainframe Modernization tarefa (se você estiver usando o modelo de tipo de tarefa fornecido, isso é chamado de [M2JOB](https://github.com/aws-samples/aws-mainframe-modernization-controlm-integration/blob/main/assets/AWS-jobs.json)) e arraste-o para a pasta.
1. Depois que a cor do tipo de tarefa mudar para verde, solte-a. **O painel à direita contém as seções **Geral**, **Programação**, **Pré-requisitos** e Ações.** Para criar a tarefa, consulte as instruções padrão na documentação do [Control-M.](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_Job.htm)
1. Em seguida, você precisa dos valores do **Job Name** para configurar os tipos de trabalho. Você pode encontrar os valores do **Job Name** na tela de definição do **aplicativo** do AWS Mainframe Modernization console ou executando a [ListBatchJobDefinitions API](https://docs.aws.amazon.com/m2/latest/APIReference/API_ListBatchJobDefinitions.html). Para esse piloto, repita as etapas de 2 a 4 para vários trabalhos, nomeando cada um com os nomes que você escolher. Os nomes de exemplo são `CBANK``CURRENCY`, `NVFUNDS``BROKERAGE`, I`RISKMGMT`,, `BANK-SERVICE-Managed-M2` e.
1. Para conectar essas tarefas ao fluxo desejado, escolha o triângulo de condição abaixo do objeto da tarefa e arraste-o para a próxima tarefa. Por exemplo, escolha o triângulo condicional abaixo `CBANK` e arraste-o para cima`CURRENCY`. Essa ação é `CBANK` a antecessora de. `CURRENCY` Por padrão, agora `CBANK` deve ser concluído com sucesso antes que CURRENCY se torne elegível para execução.
A captura de tela a seguir mostra a visualização Control-M Planning do fluxo de trabalho básico.
![\[Job flow à esquerda e propriedades à direita.\]](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/control-m-batch-scheduler/images/workflow-control-m-web-1.png)
*Imagem fornecida por cortesia da BMC Software, Inc. ©2022*
## Usaar JSON
O mesmo fluxo pode ser codificado em 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 implantar esse fluxo, use o serviço de implantação:
```
ctm deploy folder-MANAGED-M2-REPLATFORM.json
```
# Automatizar execuções de trabalhos em uma frequência programada
Usando o fluxo criado nas etapas anteriores, é possível adicionar programação básica e programação da hora de execução.
+ A programação básica define em quais dias um trabalho pode ser executado (por exemplo, todos os dias da semana, somente nos dias úteis, no final do mês ou no final do trimestre).
+ O agendamento do tempo de execução determina quando um trabalho será executado no dia em que está qualificado para execução (por exemplo, a cada hora, depois que os recursos especificados estiverem disponíveis ou somente após a confirmação manual).
É possível definir a programação básica e da hora de execução na guia **Programação**.
# Execução de trabalhos base em eventos
O Control-M Managed File Transfer (MFT) é um FTP/SFTP cliente e servidor que você pode usar para assistir e transferir arquivos entre um host local e um host remoto. Para obter mais informações sobre a definição de um trabalho de transferência de arquivos, consulte a [Documentação do Control-M](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/File_Transfer_Job.htm).
Esse piloto usa a tarefa de transferência de arquivos para observar um evento de criação de um arquivo com a extensão .poc na pasta `/bmcfile` em um bucket do S3 chamado `bmc-poc-bucket`. Quando esse evento ocorre, o trabalho do Control-M é iniciado para executar o próximo trabalho. Opcionalmente, é possível passar o caminho completo, incluindo o nome do bucket.
# Monitorar trabalhos
Você pode monitorar e validar o processamento de trabalhos no domínio de monitoramento Control-M e por meio do Console de gerenciamento da AWS, garantindo observação e verificação abrangentes em ambas as plataformas.
## Monitoramento do Control-M
Os envios e execuções de trabalhos podem ser monitorados no *Domínio de monitoramento Control-M*. Por padrão, os trabalhos AWS Mainframe Modernization de serviço aparecerão junto com todos os outros trabalhos do Control-M. *Se quiser ver somente os trabalhos de AWS Mainframe Modernization serviço sem nenhuma outra carga de trabalho (ou qualquer outro requisito de filtragem), você pode criar um Viewpoint.*
Os pontos de vista mostram não apenas as informações do trabalho, mas também as relações com as dependências anteriores e posteriores. Além disso, se seu fluxo de trabalho incluir AWS Mainframe Modernization outros tipos de tarefas do Control-M, você poderá ver e gerenciar todo o fluxo no domínio de monitoramento.
Para seguir as etapas detalhadas, consulte a [seção Pontos de vista do Monitoramento](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Viewpoints.htm) na documentação do Control-M.
A captura de tela a seguir mostra as saídas de dois fluxos de trabalho. No lado esquerdo, o fluxo de trabalho é concluído com êxito com todos os trabalhos em verde. No lado direito, o fluxo de trabalho é bem-sucedido apenas parcialmente porque o trabalho `CURRRENCY` retornou o status **Falha**, indicado pela cor vermelha. O fluxo de trabalho parou aí, deixando os trabalhos restantes no estado **Programação de Espera**.
![\[Diagramas dos fluxos de trabalho à esquerda, propriedades do trabalho à direita.\]](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/control-m-batch-scheduler/images/monitor-jobs.png)
*Imagem fornecida por cortesia da BMC Software, Inc. ©2022*
## Monitoramento no console
Para ver as informações do trabalho e do login AWS Console de gerenciamento da AWS, entre no e navegue até o [AWS Mainframe Modernization console](https://console.aws.amazon.com/m2/home?region=us-east-1#/applications).
![\[Trabalhos e status listados no console de modernização do AWS Mainframe.\]](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/control-m-batch-scheduler/images/monitor-jobs-aws-management-console.png)
Essa visualização não inclui dependências nem qualquer carga de trabalho que não seja gerenciada pelo AWS Mainframe Modernization serviço.