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 na integração do Amazon EC2 com o Control-M Esta seção descreve como o Control-M se integra e oferece suporte a trabalhos em lote executados em um ambiente de execução personalizado do AWS Mainframe Modernization implantado em uma instância do EC2. Se você estiver implementando a AWS Replatform totalmente gerenciada com o ambiente de execução da Micro Focus, consulte a seção [AWS Mainframe Modernization Integração gerenciada com o Control-M](aws-mainframe-modernization-managed.md). Esta seção pressupõe os seguintes pré-requisitos: + Uma conta AWS ativa + Uma nuvem privada virtual (VPC) na qual as instâncias do EC2 serão criadas. + O aplicativo de mainframe é migrado e executado em um ambiente AWS Replatform with Micro Focus em uma instância EC2 e oferece suporte ao mecanismo de tempo de execução da Micro Focus com vários trabalhos em lotes definidos. Para este piloto, siga as instruções em [Replatforming applications with Micro Focus](https://docs.aws.amazon.com/m2/latest/userguide/replatforming-m2.html). A documentação inclui todas as tarefas e informações adicionais sobre como configurar e operar o ambiente de execução do AWS Replatform with Micro Focus no Amazon EC2. Os tópicos a seguir abordam a configuração necessária para a integração entre o Control-M e o ambiente AWS Replatform com Micro Focus: + [Implemente recursos do Control-M e da Micro Focus](deploy-resources-environment.md) + [Criar um perfil de conexão Control-M](create-control-m-connection-profile.md) + [Criar trabalhos e programações no Control-M Planning](create-jobs-schedules-control-m-planning.md) + [Gerencie execuções de trabalhos no Control-M usando o Monitoring](monitor.md) # Implemente recursos do Control-M e da Micro Focus As duas primeiras etapas na integração da AWS Mainframe Modernization com o Control-M são implantar um agente Control-M e, em seguida, implantar um plug-in no agente. A terceira etapa é implantar o tipo de tarefa no Control-M Application Integrator. ## Implante um agente Control-M em uma instância do EC2 Ao usar uma plataforma AWS personalizada com a Micro Focus no ambiente de execução do Amazon EC2, `MFBSIFJCL` o utilitário é invocado. O utilitário opera no host que foi lançado usando a oferta Micro Focus Enterprise Server da AWS Marketplace. Para executar o `MFBSIFJCL` utilitário, você também deve implantar um agente Control-M nesse host. Para obter instruções, consulte a documentação do [Control-M.](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Agent_Installation.htm) **nota** Você pode baixar a mídia de instalação necessária no [site de download de produtos eletrônicos da BMC](https://www.bmc.com/support/resources/product-downloads.html). ## Implante o plug-in Micro Focus no agente Control-M Os plug-ins fornecem integração e suporte para os aplicativos e serviços que o Control-M orquestra. A implantação do plug-in é uma atividade pouco frequente. Se você já tem um plug-in existente que deseja usar, pule esta etapa e crie um perfil de conexão. No Amazon EC2, o serviço AWS Mainframe Modernization Replatform with Micro Focus expõe o mecanismo da Micro Focus. Para integrar AWS Mainframe Modernization, o Control-M usa o plug-in Micro Focus. Para obter mais informações, consulte a documentação do [Control-M.](https://docs.bmc.com/docs/ctm_integrations/control-m-for-micro-focus-1193641959.html) Você deve implantar esse plug-in em um Agente que esteja instalado em um host em que o Micro Focus Enterprise Server esteja sendo executado. ## 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](create-control-m-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 tarefa, você deve executar as seguintes etapas usando o [Application Integrator:](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Application_Integrator.htm) + 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. + Faça login no Application Integrator. + Na guia **Início**, selecione **Importar tipo de trabalho do arquivo** e selecione a localização do `AIM2JOB.ctmai`. + Se desejar fazer alguma modificação no exemplo fornecido, familiarize-se com o Application Integrator. + 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). # Criar um perfil de conexão Control-M 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, você pode usar o [domínio de configuração](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_centralized_connection_profile.htm) da interface Web Control-M ou usar JSON. O código a seguir é um exemplo de 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": "*****" } } ``` O código de exemplo está no arquivo `ConnectionProfile-Custom-M2-Replatform.json` no GitHub repositório. Para implantar o código, use o serviço de implantação da API de automação Control-M: ``` ctm deploy ConnectionProfile-Custom-M2-Replatform.json ``` A resposta da API de automação Control-M será semelhante à seguinte: ``` [ { "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 " ] } ] ``` # Criar trabalhos e programações no Control-M Planning Agora que você tem o plug-in implantado e um perfil de conexão para conectividade da Micro Focus, você pode começar a criar e executar trabalhos. Cada tarefa do Control-M for Micro Focus 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 operacional fornecida pelo site + 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, como correr a cada hora + 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 [usando o Control-M Web](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_Job.htm) ou [escritos em JSON](https://docs.bmc.com/docs/automation-api/monthly/code-reference-1116950299.html) e implantados usando a API de automação Control-M. As seções a seguir examinam alguns cenários comuns de fluxo de trabalho: + [Inicie trabalhos usando um fluxo de trabalho](initiate-jobs.md) + [Automatizar execuções de trabalhos em uma frequência programada](automate-jobs.md) # Inicie trabalhos usando um fluxo de trabalho 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 o Control-M Web 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. Na barra Menu, escolha **Add Job**, escolha a tarefa Micro Focus Windows ou Micro Focus Linux e arraste-a até a face da pasta. 1. Depois que a cor da 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. Para obter instruções sobre como criar uma tarefa Control-M para Micro Focus, consulte a documentação do [Control-M](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Jobs_for_Mainframe_Modernization.htm#MicroFocusJob). Para esse piloto, repita as etapas de 2 a 4 para cinco tarefas, nomeando cada uma de a. `aws-mf-job1` `aws-mf-job5` 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 `aws-mf-job1` e arraste-o para cima`aws-mf-job2`. Essa ação é `aws-mf-job1` a antecessora de. `aws-mf-job2` Por padrão, agora `aws-mf-job1` deve ser concluído com êxito antes de `aws-mf-job2` se tornar elegível para execução. O diagrama a seguir mostra a visualização Control-M Planning do fluxo de trabalho básico. ![\[Diagrama de fluxo de trabalho, com propriedades no painel do lado direito.\]](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/control-m-batch-scheduler/images/control-m-web-planning.png) *Imagem fornecida por cortesia da BMC Software, Inc. ©2022* ## Usaar JSON O mesmo fluxo pode ser codificado em JSON. No GitHub repositório, o código de exemplo está no arquivo`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 implantar esse fluxo, use a API de automação Control-M: ``` ctm deploy Folder-Custom-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. + O agendamento básico define em quais dias um trabalho está qualificado para execução (por exemplo, todos os dias da semana, somente nos dias úteis, no final do mês ou no final do trimestre). Você pode definir o agendamento básico na guia [Agendamento.](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Job_scheduling.htm) + O agendamento do tempo de execução determina quando um trabalho é executado no dia em que está qualificado para execução (por exemplo, após a conclusão dos trabalhos predecessores, a cada hora, depois que os recursos especificados estiverem disponíveis ou somente após a confirmação manual). Você pode definir alguns agendamentos de tempo de execução na seção **Agendamento** e outros na seção **Pré-requisitos**. # Monitorar trabalhos Você pode monitorar e verificar trabalhos no domínio Control-M Monitoring e na interface de [usuário do Micro Focus Enterprise Server Common Web Administration](https://www.microfocus.com/documentation/visual-cobol/vc70/CSWin/GUID-C7A333B6-1DFB-49AC-8DB3-4023C6FCDEFB.html). ## 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 trabalhos do Control-M, você poderá ver e gerenciar todo o fluxo no domínio de monitoramento. Você pode seguir etapas detalhadas visitando 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 cinco trabalhos em verde. No lado direito, o fluxo de trabalho é bem-sucedido apenas parcialmente porque `aws-mf-job3` retornou o status **Falha** e o fluxo de trabalho parou aí, ficando `aws-mf-job5` no estado **Programação de Espera**. ![\[Diagramas de fluxo de trabalho no lado esquerdo, monitorando a saída na guia Saída no painel direito.\]](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/control-m-batch-scheduler/images/monitor-jobs-2.png) *Imagem fornecida por cortesia da BMC Software, Inc. ©2022*