

AWS El servicio de modernización de mainframes (experiencia en entornos de ejecución gestionados) ya no está abierto a nuevos clientes. Para obtener prestaciones similares a las del Servicio de Modernización de AWS Mainframe (experiencia en entornos de ejecución gestionados), explore el Servicio de Modernización de AWS Mainframe (experiencia autogestionada). Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener más información, consulte Cambio en la disponibilidad de la modernización del [AWS mainframe.](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Utilidad por lotes M2SFTP
<a name="m2sftp"></a>

M2SFTP es un programa de utilidades de JCL diseñado para realizar transferencias de archivos seguras entre sistemas que utilizan el protocolo de transferencia segura de archivos (SFTP). El programa utiliza el cliente SFTP de Putty, `psftp`, para realizar las transferencias reales de archivos. El programa funciona de manera similar a un programa de utilidades de FTP para unidades centrales y utiliza la autenticación de usuario y contraseña.

**nota**  
No se admite la autenticación de clave pública.

Para convertir el FTP de su ordenador central JCLs a SFTP, cambie a. `PGM=FTP` `PGM=M2SFTP`

**Topics**
+ [Plataformas admitidas](#m2sftp-platforms)
+ [Instalación de dependencias](#m2sftp-dependencies)
+ [Configure M2SFTP para gestionar la modernización del AWS mainframe](#m2sftp-configure-managed)
+ [Configurar M2SFTP para el tiempo de ejecución de modernización de AWS mainframe en Amazon EC2 (incluidas las aplicaciones) WorkSpaces](#m2sftp-configure-customer-infra)
+ [Ejemplo JCLs](#m2sftp-jcl)
+ [Referencia de comandos del cliente SFTP de Putty (PSFTP)](#m2sftp-cmd-ref)
+ [Siguientes pasos](#m2sftp-next)

## Plataformas admitidas
<a name="m2sftp-platforms"></a>

Puede utilizar M2SFTP en cualquiera de las siguientes plataformas:
+ AWS Modernización del mainframe gestionada por Rocket Software (anteriormente Micro Focus)
+ Rocket Software Runtime (en Amazon EC2)
+ Todas las variantes de los productos Rocket Software Enterprise Developer (ED) y Rocket Software Enterprise Server (ES).

## Instalación de dependencias
<a name="m2sftp-dependencies"></a>

**Para instalar el cliente SFTP de Putty en Windows**
+ Descargue el cliente [SFTP de PuTTY](https://www.putty.org/) e instálelo.

**Para instalar el cliente SFTP de Putty en Linux:**
+ Ejecute el siguiente comando para instalar el cliente SFTP de Putty.

  ```
    sudo yum -y install putty
  ```

## Configure M2SFTP para gestionar la modernización del AWS mainframe
<a name="m2sftp-configure-managed"></a>

Si sus aplicaciones migradas se ejecutan en AWS Mainframe Modernization Managed, tendrá que configurar M2SFTP de la siguiente manera.
+ Establezca las variables de entorno de Rocket Enterprise Server adecuadas para el MFFTP. A continuación se muestran algunos ejemplos:
  + `MFFTP_TEMP_DIR`
  + `MFFTP_SENDEOL`
  + `MFFTP_TIME`
  + `MFFTP_ABEND`

  Puede configurar tantas variables como desee. Puede configurarlas en su JCL mediante la instrucción `ENVAR DD`. Para obtener más información sobre estas variables, consulte [MFFTP Control Variables](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-3F94BBC8-CB97-4642-A4A7-4235C0C079E2.html) en la documentación de Micro Focus.

Para probar la configuración, consulte [Ejemplo JCLs](#m2sftp-jcl).

## Configurar M2SFTP para el tiempo de ejecución de modernización de AWS mainframe en Amazon EC2 (incluidas las aplicaciones) WorkSpaces
<a name="m2sftp-configure-customer-infra"></a>

Si las aplicaciones migradas se ejecutan en el entorno de ejecución de modernización de AWS mainframe en Amazon EC2, configure M2SFTP de la siguiente manera.

1. Cambie la [ruta del programa JES de Micro Focus](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-BC8A1796-9EDE-48EB-8363-31C9BDE7F96B.html) para incluir la ubicación binaria de las utilidades por lotes. Si necesita especificar varias rutas, utilice dos puntos (`:`) para separarlas en Linux y punto y coma (`;`) en 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. Establezca las variables de entorno de Rocket Enterprise Server adecuadas para el MFFTP. A continuación se muestran algunos ejemplos:
   + `MFFTP_TEMP_DIR`
   + `MFFTP_SENDEOL`
   + `MFFTP_TIME`
   + ``MFFTP\$1ABEND

   Puede configurar tantas variables como desee. Puede configurarlas en su JCL mediante la instrucción `ENVAR DD`. Para obtener más información sobre estas variables, consulte [MFFTP Control Variables](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-3F94BBC8-CB97-4642-A4A7-4235C0C079E2.html) en la documentación de Micro Focus.

Para probar la configuración, consulte [Ejemplo JCLs](#m2sftp-jcl).

## Ejemplo JCLs
<a name="m2sftp-jcl"></a>

Para probar la instalación, puede utilizar uno de los siguientes archivos JCL de ejemplo.

**M2 SFTP1 .jcl**

Este JCL muestra cómo llamar a M2SFTP para enviar un archivo a un servidor SFTP remoto. Observe las variables de entorno que se establecen en la instrucción `ENVVAR DD`.

```
//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 .jcl SFTP2**

Este JCL muestra cómo llamar a M2SFTP para recibir un archivo de un servidor SFTP remoto. Observe las variables de entorno establecidas en la instrucción `ENVVAR DD`.

```
//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**  
Recomendamos encarecidamente almacenar las credenciales de FTP en un archivo NETRC y restringir el acceso únicamente a los usuarios autorizados.

## Referencia de comandos del cliente SFTP de Putty (PSFTP)
<a name="m2sftp-cmd-ref"></a>

El cliente PSFTP no admite todos los comandos de FTP. La siguiente lista muestra todos los comandos compatibles con PSFTP.


| Comando | Description (Descripción) | 
| --- | --- | 
|  \$1  |  Ejecuta un comando local  | 
|  bye  |  Finaliza su sesión de SFTP  | 
|  cd  |  Cambia su directorio de trabajo remoto  | 
|  chmod  |  Cambia los permisos y modos de los archivos  | 
|  close  |  Finaliza la sesión de SFTP pero no cierra PSFTP  | 
|  del  |  Elimina archivos en el servidor remoto  | 
|  dir  |  Lista los archivos remotos  | 
|  exit  |  Finaliza su sesión de SFTP  | 
|  introducción  |  Descarga el archivo del servidor en el equipo local.  | 
|  help  |  Brinda ayuda  | 
|  lcd  |  Cambia el directorio de trabajo local  | 
|  lpwd  |  Imprime el directorio de trabajo local  | 
|  ls  |  Lista los archivos remotos  | 
|  mget  |  Descarga varios archivos a la vez  | 
|  mkdir  |  Crea directorios en el servidor remoto  | 
|  mput  |  Carga varios archivos a la vez  | 
|  mv  |  Mueve o cambia el nombre de los archivos en el servidor remoto  | 
|  open  |  Conectarse a un host  | 
|  put  |  Carga un archivo del equipo local al servidor.  | 
|  pwd  |  Imprime su directorio de trabajo remoto  | 
|  quit  |  Finaliza su sesión de SFTP  | 
|  reget  |  Continúa descargando archivos  | 
|  ren  |  Mueve los archivos en el servidor remoto o les cambia el nombre  | 
|  reput  |  Continúa descargando archivos  | 
|  rm  |  Elimina archivos en el servidor remoto  | 
|  rmdir  |  Elimina directorios en el servidor remoto  | 

## Siguientes pasos
<a name="m2sftp-next"></a>

Para cargar y descargar archivos en Amazon Simple Storage Service mediante SFTP, puede utilizar M2SFTP junto con el AWS Transfer Family, tal y como se describe en las siguientes entradas del blog.
+ [Uso de directorios lógicos de AWS SFTP para crear un servicio de distribución de datos sencillo](https://aws.amazon.com/blogs/storage/using-aws-sftp-logical-directories-to-build-a-simple-data-distribution-service/)
+ [Habilite la autenticación por contraseña para su uso AWS Transfer for SFTPAWS Secrets Manager](https://aws.amazon.com/blogs/storage/enable-password-authentication-for-aws-transfer-for-sftp-using-aws-secrets-manager/)