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á. # Utilitário em lote M2SFTP O M2SFTP é um programa utilitário JCL projetado para realizar transferências seguras de arquivos entre sistemas usando o Secure File Transfer Protocol (SFTP). O programa usa o cliente Putty SFTP, `psftp`, para realizar as transferências reais de arquivos. O programa funciona de forma semelhante a um programa utilitário de FTP de mainframe e usa autenticação de usuário e senha. **nota** A autenticação de chave pública não é compatível. Para converter seu mainframe FTP JCLs para usar SFTP, mude para. `PGM=FTP` `PGM=M2SFTP` **Topics** + [Plataformas compatíveis](#m2sftp-platforms) + [Instalar as dependências](#m2sftp-dependencies) + [Configurar o M2SFTP para AWS a modernização gerenciada do mainframe](#m2sftp-configure-managed) + [Configurar o M2SFTP para o tempo de execução da modernização do AWS mainframe no Amazon EC2 (incluindo aplicativos) WorkSpaces](#m2sftp-configure-customer-infra) + [Amostra JCLs](#m2sftp-jcl) + [Referência de comando do cliente Putty SFTP (PSFTP)](#m2sftp-cmd-ref) + [Próximas etapas](#m2sftp-next) ## Plataformas compatíveis Você pode usar o M2SFTP em qualquer uma das seguintes plataformas: + AWS Software de modernização de mainframe Rocket (anteriormente Micro Focus) gerenciado + Rocket Software Runtime (no Amazon EC2) + Todas as variantes dos produtos Rocket Software Enterprise Developer (ED) e Rocket Software Enterprise Server (ES). ## Instalar as dependências **Para instalar o cliente Putty SFTP no Windows** + Faça o download do cliente [PuTTY SFTP](https://www.putty.org/) e instale-o. **Para instalar o cliente Putty SFTP no Linux:** + Execute o seguinte comando para instalar o cliente SFTP do Putty: ``` sudo yum -y install putty ``` ## Configurar o M2SFTP para AWS a modernização gerenciada do mainframe Se seus aplicativos migrados estiverem sendo executados no AWS Mainframe Modernization Managed, você precisará configurar o M2SFTP da seguinte forma. + Defina as variáveis de ambiente apropriadas do Rocket Enterprise Server para MFFTP. Aqui estão alguns exemplos: + `MFFTP_TEMP_DIR` + `MFFTP_SENDEOL` + `MFFTP_TIME` + `MFFTP_ABEND` Você pode definir quantas ou quantas dessas variáveis quiser. Você pode configurá-los em seu JCL usando a `ENVAR DD` instrução. Para obter mais informações sobre essas variáveis, consulte Variáveis de [controle do MFFTP](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-3F94BBC8-CB97-4642-A4A7-4235C0C079E2.html) na documentação da Micro Focus. Para testar sua configuração, consulte [Amostra JCLs](#m2sftp-jcl). ## Configurar o M2SFTP para o tempo de execução da modernização do AWS mainframe no Amazon EC2 (incluindo aplicativos) WorkSpaces Se seus aplicativos migrados estiverem sendo executados em tempo de execução de modernização de AWS mainframe no Amazon EC2, configure o M2SFTP da seguinte forma. 1. Altere o [caminho do programa Micro Focus JES](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-BC8A1796-9EDE-48EB-8363-31C9BDE7F96B.html) para incluir a localização binária dos utilitários em lote. Se você precisar especificar vários caminhos, use dois pontos (`:`) para separar caminhos no Linux e ponto e vírgula (`;`) no Windows. + Linux: `/opt/aws/m2/microfocus/utilities/64bit` + Windows (32 bits): `C:\AWS\M2\MicroFocus\Utilities\32bit` + Windows (64 bits): `C:\AWS\M2\MicroFocus\Utilities\64bit` 1. Defina as variáveis de ambiente apropriadas do Rocket Enterprise Server para MFFTP. Aqui estão alguns exemplos: + `MFFTP_TEMP_DIR` + `MFFTP_SENDEOL` + `MFFTP_TIME` + ``MFFTP\$1ABEND Você pode definir quantas ou quantas dessas variáveis quiser. Você pode configurá-los em seu JCL usando a `ENVAR DD` instrução. Para obter mais informações sobre essas variáveis, consulte Variáveis de [controle do MFFTP](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-3F94BBC8-CB97-4642-A4A7-4235C0C079E2.html) na documentação da Micro Focus. Para testar sua configuração, consulte [Amostra JCLs](#m2sftp-jcl). ## Amostra JCLs Para testar a instalação, você pode usar um dos seguintes arquivos JCL de exemplo. **M2 SFTP1 .jcl** Este JCL mostra como chamar o M2SFTP para enviar um arquivo para um servidor SFTP remoto. Observe as variáveis de ambiente definidas na `ENVVAR DD` instrução. ``` //M2SFTP1 JOB 'M2SFTP1',CLASS=A,MSGCLASS=X,TIME=1440 //* //* Copyright Amazon.com, Inc. or its affiliates.* //* All Rights Reserved.* //* //*-------------------------------------------------------------------** //* Sample SFTP JCL step to send a file to SFTP server* //*-------------------------------------------------------------------** //* //STEP01 EXEC PGM=M2SFTP, // PARM='127.0.0.1 (EXIT=99 TIMEOUT 300' //* //SYSFTPD DD * RECFM FB LRECL 80 SBSENDEOL CRLF MBSENDEOL CRLF TRAILINGBLANKS FALSE /* //NETRC DD * machine 127.0.0.1 login sftpuser password sftppass /* //SYSPRINT DD SYSOUT=* //OUTPUT DD SYSOUT=* //STDOUT DD SYSOUT=* //INPUT DD * type a locsite notrailingblanks cd files put 'AWS.M2.TXT2PDF1.PDF' AWS.M2.TXT2PDF1.pdf put 'AWS.M2.CARDDEMO.CARDDATA.PS' AWS.M2.CARDDEMO.CARDDATA.PS1.txt quit /* //ENVVAR DD * MFFTP_VERBOSE_OUTPUT=ON MFFTP_KEEP=N /* //* // ``` **M2 SFTP2 .jcl** Este JCL mostra como chamar o M2SFTP para receber um arquivo de um servidor SFTP remoto. Observe as variáveis de ambiente definidas na `ENVVAR DD` declaração. ``` //M2SFTP2 JOB 'M2SFTP2',CLASS=A,MSGCLASS=X,TIME=1440 //* //* Copyright Amazon.com, Inc. or its affiliates.* //* All Rights Reserved.* //* //*-------------------------------------------------------------------** //* Sample SFTP JCL step to receive a file from SFTP server* //*-------------------------------------------------------------------** //* //STEP01 EXEC PGM=M2SFTP //* //SYSPRINT DD SYSOUT=* //OUTPUT DD SYSOUT=* //STDOUT DD SYSOUT=* //INPUT DD * open 127.0.0.1 sftpuser sftppass cd files locsite recfm=fb lrecl=150 get AWS.M2.CARDDEMO.CARDDATA.PS.txt + 'AWS.M2.CARDDEMO.CARDDATA.PS2' (replace quit /* //ENVVAR DD * MFFTP_VERBOSE_OUTPUT=ON MFFTP_KEEP=N /* //* // ``` **nota** É altamente recomendável armazenar as credenciais de FTP em um arquivo NETRC e restringir o acesso somente a usuários autorizados. ## Referência de comando do cliente Putty SFTP (PSFTP) O cliente PSFTP não suporta todos os comandos de FTP. A lista a seguir mostra todos os comandos que o PSFTP suporta. | Command | Description | | --- | --- | | \$1 | Executar um comando local | | tchau | Conclua sua sessão de SFTP | | cd \$1 | Altere seu diretório de trabalho remoto | | chmod | Alterar permissões e modos de arquivo | | feche | Conclua sua sessão de SFTP, mas não saia do PSFTP | | del | Excluir arquivos no servidor remoto | | dir | Listar arquivos remotos | | exit | Conclua sua sessão de SFTP | | obter | Baixe um arquivo do servidor para sua máquina local | | help | Dê ajuda | | lcd | Alterar diretório de trabalho local | | lpwd | Imprimir diretório de trabalho local | | ls | Listar arquivos remotos | | ímã | Baixe vários arquivos de uma só vez | | mkdir | Crie diretórios no servidor remoto | | entrada | Faça upload de vários arquivos de uma só vez | | mv | Mover ou renomear arquivo (s) no servidor remoto | | aberto | Conecte-se a um host | | put | Upload um arquivo da sua máquina local para o servidor | | PWD | Imprima seu diretório de trabalho remoto | | sair | Conclua sua sessão de SFTP | | arrepender | Continue baixando arquivos | | arrancar | Mover ou renomear arquivo (s) no servidor remoto | | reputação | Continuar carregando arquivos | | /rm | Excluir arquivos no servidor remoto | | rmdir | Remover diretórios no servidor remoto | ## Próximas etapas Para carregar e baixar arquivos no Amazon Simple Storage Service usando SFTP, você pode usar o M2SFTP em conjunto com o AWS Transfer Family, conforme descrito nas postagens do blog a seguir. + [Usando diretórios lógicos AWS SFTP para criar um serviço simples de distribuição de dados](https://aws.amazon.com/blogs/storage/using-aws-sftp-logical-directories-to-build-a-simple-data-distribution-service/) + [Ativar a autenticação por senha para AWS Transfer for SFTP usar AWS Secrets Manager](https://aws.amazon.com/blogs/storage/enable-password-authentication-for-aws-transfer-for-sftp-using-aws-secrets-manager/)