O Mainframe Connector permite acionar e monitorar jobs do Cloud Run no mainframe. Por exemplo, é possível usar esse recurso para integrar sua ferramenta de extração, transformação e carregamento (ETL) com o Mainframe Connector usando trabalhos do Cloud Run.
Nesta página, explicamos como realizar as seguintes tarefas usando o conector de mainframe:
- Acionar um job do Cloud Run:inicie um job do Cloud Run no Mainframe Connector.
- Acessar os registros de jobs do Cloud Run:acesse os registros de jobs do Cloud Run localmente no seu mainframe para monitoramento.
- Cancelar um job do Cloud Run:cancele um job do Cloud Run em andamento.
Para mais informações sobre como criar e gerenciar jobs do Cloud Run, consulte a documentação do Cloud Run.
Antes de começar
- Instale o Mainframe Connector no seu mainframe, caso ainda não tenha feito isso.
- Para executar os comandos do Cloud Run, atribua os papéis a seguir à sua conta de usuário:
- Chamador do Cloud Run
- Executor de jobs do Cloud Run
- Executor de jobs do Cloud Run com substituições
- Leitor do Cloud Run
- Visualizador de registros Para mais informações sobre como atribuir papéis a uma conta de usuário, consulte Gerenciar o acesso usando o IAM.
Executar um job do Cloud Run usando o conector de mainframe
Para executar um job do Cloud Run usando o conector de mainframe, siga estas etapas:
Para acionar um job do Cloud Run no mainframe, use o comando
cloud run job run
do arquivo de linguagem de controle de jobs (JCL, na sigla em inglês) do mainframe://STEP01 EXEC BQSH //STDIN DD * cloud run job run JOB_NAME /*
Substitua JOB_NAME pelo job do Cloud Run que você quer executar.
É possível executar o comando
cloud run job run
no modo síncrono e assíncrono. Se você quiser acionar um job no modo síncrono e imprimir os registros de job conforme o job avança, use o comando anterior com a flag--tail_logs
.Para conferir os registros de uma execução de job específica do Cloud Run, use o comando
cloud run job logs
do arquivo JCL do mainframe://STEP01 EXEC BQSH //STDIN DD * cloud run job logs EXECUTION_ID /*
Substitua EXECUTION_ID pelo ID de execução do job do Cloud Run.
(Opcional) Para cancelar um job do Cloud Run, use o comando
cloud run job cancel
do arquivo JCL do mainframe:Example JCL //STEP01 EXEC BQSH //STDIN DD * cloud run job cancel EXECUTION_ID /*
Substitua EXECUTION_ID pelo ID de execução do job do Cloud Run que você quer cancelar.