AWS O Mainframe Modernization Service (experiência em Managed Runtime Environment) não está mais aberto a novos clientes. Para recursos semelhantes ao AWS Mainframe Modernization Service (experiência em Managed Runtime Environment), explore o AWS Mainframe Modernization Service (experiência autogerenciada). Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte Alteração na [disponibilidade AWS da modernização do mainframe](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html).
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á.
# Instalar um agente do Transferência de Arquivos
Você pode usar este documento como um step-by-step guia para instalar um agente no mainframe de origem.
**nota**
Este guia é somente para programadores de sistemas de mainframe.
**Topics**
+ [Etapa 1: criar um conjunto de dados do zFS para o agente do M2](#allocate-dataset)
+ [Etapa 2: formatar o conjunto de dados como zFS](#format-dataset)
+ [Etapa 3: montar o sistema de arquivos](#mount-filesystem)
+ [Etapa 4: verificar a montagem](#verify-mount)
+ [Etapa 5: inserir OMVs](#enter-omvs)
+ [Etapa 6: definir a variável de ambiente do diretório de instalação do agente](#agent-directory)
+ [Etapa 7: definir a variável de ambiente do diretório de instalação do agente](#work-directory)
+ [Etapa 8: criar o diretório de trabalho](#create-work-directory)
+ [Etapa 9: copiar o arquivo tar do agente e copiar o diretório de trabalho](#agent-tar-package)
+ [Etapa 10: Concluir a instalação do agente](#finish-agent-installation)
## Etapa 1: criar um conjunto de dados do zFS para o agente do M2
Crie um zFS para a instalação do agente do M2 usando a JCL (Job Control Language) abaixo:
```
DEFINE EXEC PGM=IDCAMS
SYSPRINT DD SYSOUT=A
SYSIN DD *
DEFINE CLUSTER (NAME(yourhlq.M2AGENT.ZFS) -
VOLUMES(*) -
LINEAR CYL(1000 200))
```
## Etapa 2: formatar o conjunto de dados como zFS
Depois de criar o conjunto de dados, formate-o como um sistema de arquivos z/FS.
Uma maneira de fazer isso é utilizando-se a seguinte JCL:
```
FORMAT EXEC PGM=IOEAGFMT,
PARM=('-aggregate yourhlq.M2AGENT.ZFS -size 1200') ,
SYSPRINT DD SYSOUT=*
```
Envie esse trabalho e verifique se ele foi concluído com êxito.
## Etapa 3: montar o sistema de arquivos
Para montar o sistema de arquivos, use o comando `MOUNT`. É possível montar o sistema de arquivos na linha de comando no ISPF ou em lote.
Por exemplo:
```
MOUNT FILESYSTEM('yourhlq.M2AGENT.ZFS') TYPE(ZFS) MODE(RDWR) MOUNTPOINT('/usr/lpp/aws/m2-agent')
```
Você usará esse ponto de montagem na etapa 6.
**nota**
Definir o caminho de montagem é opcional e você deve usar um diretório existente para isso.
## Etapa 4: verificar a montagem
Verifique se o sistema de arquivos foi montado corretamente usando o comando `D OMVS,F` ou verificando no Unix System Service (USS).
## Etapa 5: inserir OMVs
Use o seguinte comando para inserir OMVs:
```
TSO OMVS
```
## Etapa 6: definir a variável de ambiente do diretório de instalação do agente
Use o seguinte comando para definir o ambiente do diretório de instalação do agente:
```
export AGENT_DIR=/usr/lpp/aws/m2-agent
```
**nota**
O ponto de montagem é definido na etapa 3.
## Etapa 7: definir a variável de ambiente do diretório de instalação do agente
Use o seguinte comando para definir a variável de ambiente do diretório de trabalho:
```
export WORK_DIR=$AGENT_DIR/tmp
```
## Etapa 8: criar o diretório de trabalho
Use o seguinte comando para definir a variável de ambiente do diretório de trabalho:
```
mkdir -p $WORK_DIR
```
## Etapa 9: copiar o arquivo tar do agente e copiar o diretório de trabalho
Baixe o arquivo tar do agente da AWS usando o [link do agente do M2](https://drm0z31ua8gi7.cloudfront.net/filetransfer/m2-agent-v1.0.0.tar).
O mecanismo de transferência dependerá do ambiente, mas garanta que o arquivo tar seja transferido no modo binário.
## Etapa 10: Concluir a instalação do agente
Siga estas etapas para concluir a instalação do agente.
1. Defina a variável de ambiente da versão m2-agent para a versão que está sendo instalada no momento usando o seguinte comando:
```
export M2_AGENT_VERSION=1.0.0
```
1. Crie o pacote tar do agente usando o seguinte comando:
```
tar -xpf m2-agent-$M2_AGENT_VERSION.tar -C $AGENT_DIR
```
1. Crie um link `current-version` simbólico para o diretório atual de instalação do agente com o seguinte comando:
```
ln -s $AGENT_DIR/m2-agent-v$M2_AGENT_VERSION $AGENT_DIR/current-version
```
1. Atualize e envie `CPY#PDS` para criar os conjuntos de dados do agente do recurso Transferência de Arquivos.
**nota**
O JCL usa o `SYS2.AWS.M2 HLQ`.
Para criar o agente do recurso Transferência de Arquivos, atualize as três variáveis simbólicas HLQ (qualificador de alto nível), `VOLSER` e `AGNTPATH` a serem usadas posteriormente no JCL:
```
oedit $AGENT_DIR/current-version/installation/CPY#PDS
```
**nota**
Essa JCL é personalizada para configurar certos aspectos da instalação do agente no mainframe. Ele aloca os conjuntos de dados necessários e depois copia arquivos específicos do sistema de arquivos Unix nesses conjuntos de dados.