Utilidad por lotes M2SFTP

Modo de enfoque

Utilidad por lotes M2SFTP - AWS Modernización de mainframe

Plataformas admitidas Instalación de dependencias Configure M2SFTP para gestionar la modernización del AWS mainframe Configurar M2SFTP para el tiempo de ejecución de modernización de AWS mainframe en Amazon EC2 (incluida la versión 2.0) AppStream Ejemplo JCLs Referencia de comandos del cliente SFTP de Putty (PSFTP)Pasos a seguir a continuación

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 PGM=FTP a. PGM=M2SFTP

Temas

Plataformas admitidas
Instalación de dependencias
Configure M2SFTP para gestionar la modernización del AWS mainframe
Configurar M2SFTP para el tiempo de ejecución de modernización de AWS mainframe en Amazon EC2 (incluida la versión 2.0) AppStream
Ejemplo JCLs
Referencia de comandos del cliente SFTP de Putty (PSFTP)
Pasos a seguir a continuación

Plataformas admitidas

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

Para instalar el cliente SFTP de Putty en Windows

Descargue el cliente SFTP de PuTTY 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

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 en la documentación de Micro Focus.

Para probar la configuración, consulte Ejemplo JCLs.

Configurar M2SFTP para el tiempo de ejecución de modernización de AWS mainframe en Amazon EC2 (incluida la versión 2.0) AppStream

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.

Cambie la ruta del programa JES de Micro Focus 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
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 en la documentación de Micro Focus.

Para probar la configuración, consulte Ejemplo JCLs.

Ejemplo JCLs

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)

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

Comando	Descripción
!	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

Pasos a seguir a continuación

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.