AWS Le service de modernisation du mainframe (expérience de l'environnement d'exécution géré) n'est plus ouvert aux nouveaux clients. Pour des fonctionnalités similaires au service de modernisation AWS du mainframe (expérience de l'environnement d'exécution géré), explorez le service de modernisation AWS du mainframe (expérience autogérée). Les clients existants peuvent continuer à utiliser le service normalement. Pour plus d'informations, consultez la section [Modification de la disponibilité de la modernisation du AWS mainframe](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html).
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Utilitaire batch M2SFTP
M2SFTP est un utilitaire JCL conçu pour effectuer des transferts de fichiers sécurisés entre systèmes à l'aide du protocole SFTP (Secure File Transfer Protocol). Le programme utilise le client Putty SFTP pour effectuer `psftp` les transferts de fichiers réels. Le programme fonctionne de la même manière qu'un utilitaire FTP sur ordinateur central et utilise l'authentification par utilisateur et mot de passe.
**Note**
L'authentification par clé publique n'est pas prise en charge.
Pour convertir le FTP de votre mainframe JCLs en SFTP, remplacez `PGM=FTP` par. `PGM=M2SFTP`
**Topics**
+ [Plateformes prises en charge](#m2sftp-platforms)
+ [Installation des dépendances](#m2sftp-dependencies)
+ [Configuration du M2SFTP pour la gestion de la modernisation du AWS mainframe](#m2sftp-configure-managed)
+ [Configuration du M2SFTP pour l'exécution de la modernisation AWS du mainframe sur Amazon EC2 (applications incluses) WorkSpaces](#m2sftp-configure-customer-infra)
+ [Exemple JCLs](#m2sftp-jcl)
+ [Référence de commande client Putty SFTP (PSFTP)](#m2sftp-cmd-ref)
+ [Étapes suivantes](#m2sftp-next)
## Plateformes prises en charge
Vous pouvez utiliser M2SFTP sur l'une des plateformes suivantes :
+ AWS Modernisation du mainframe Rocket Software (anciennement Micro Focus) Géré
+ Rocket Software Runtime (sur Amazon EC2)
+ Toutes les variantes des produits Rocket Software Enterprise Developer (ED) et Rocket Software Enterprise Server (ES).
## Installation des dépendances
**Pour installer le client SFTP Putty sous Windows**
+ Téléchargez le client [SFTP PuTTY](https://www.putty.org/) et installez-le.
**Pour installer le client SFTP Putty sous Linux :**
+ Exécutez la commande suivante pour installer le client SFTP Putty :
```
sudo yum -y install putty
```
## Configuration du M2SFTP pour la gestion de la modernisation du AWS mainframe
Si vos applications migrées s'exécutent sur AWS Mainframe Modernization Managed, vous devez configurer M2SFTP comme suit.
+ Définissez les variables d'environnement Rocket Enterprise Server appropriées pour le MFFTP. Voici quelques exemples :
+ `MFFTP_TEMP_DIR`
+ `MFFTP_SENDEOL`
+ `MFFTP_TIME`
+ `MFFTP_ABEND`
Vous pouvez définir aussi peu ou autant de variables que vous le souhaitez. Vous pouvez les définir dans votre JCL à l'aide de l'`ENVAR DD`instruction. Pour plus d'informations sur ces variables, consultez la section Variables de [contrôle MFFTP](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-3F94BBC8-CB97-4642-A4A7-4235C0C079E2.html) dans la documentation de Micro Focus.
Pour tester votre configuration, consultez[Exemple JCLs](#m2sftp-jcl).
## Configuration du M2SFTP pour l'exécution de la modernisation AWS du mainframe sur Amazon EC2 (applications incluses) WorkSpaces
Si vos applications migrées s'exécutent sur le moteur d'exécution AWS Mainframe Modernization sur Amazon EC2, configurez M2SFTP comme suit.
1. Modifiez le [chemin du programme Micro Focus JES](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-BC8A1796-9EDE-48EB-8363-31C9BDE7F96B.html) pour inclure l'emplacement binaire des utilitaires de traitement par lots. Si vous devez spécifier plusieurs chemins, utilisez des deux-points (`:`) pour séparer les chemins sous Linux des points-virgules (`;`) sous 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. Définissez les variables d'environnement Rocket Enterprise Server appropriées pour le MFFTP. Voici quelques exemples :
+ `MFFTP_TEMP_DIR`
+ `MFFTP_SENDEOL`
+ `MFFTP_TIME`
+ ``MFFTP\$1ABEND
Vous pouvez définir aussi peu ou autant de variables que vous le souhaitez. Vous pouvez les définir dans votre JCL à l'aide de l'`ENVAR DD`instruction. Pour plus d'informations sur ces variables, consultez la section Variables de [contrôle MFFTP](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-3F94BBC8-CB97-4642-A4A7-4235C0C079E2.html) dans la documentation de Micro Focus.
Pour tester votre configuration, consultez[Exemple JCLs](#m2sftp-jcl).
## Exemple JCLs
Pour tester l'installation, vous pouvez utiliser l'un des exemples de fichiers JCL suivants.
**SFTP1M2.jcl**
Cette JCL montre comment appeler M2SFTP pour envoyer un fichier à un serveur SFTP distant. Notez les variables d'environnement définies dans l'`ENVVAR DD`instruction.
```
//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
/*
//*
//
```
**SFTP2M2.jcl**
Cette JCL montre comment appeler M2SFTP pour recevoir un fichier d'un serveur SFTP distant. Notez les variables d'environnement définies dans l'`ENVVAR DD`instruction.
```
//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
/*
//*
//
```
**Note**
Nous recommandons vivement de stocker les informations d'identification FTP dans un fichier NETRC et de restreindre l'accès aux seuls utilisateurs autorisés.
## Référence de commande client Putty SFTP (PSFTP)
Le client PSFTP ne prend pas en charge toutes les commandes FTP. La liste suivante répertorie toutes les commandes prises en charge par PSFTP.
| Commande | Description |
| --- | --- |
| \$1 | Exécuter une commande locale |
| au revoir | Terminez votre session SFTP |
| cd | Modifier votre répertoire de travail à distance |
| chmod | Modifier les autorisations et les modes des fichiers |
| close | Terminez votre session SFTP mais ne quittez pas PSFTP |
| del | Supprimer des fichiers sur le serveur distant |
| dir | Lister les fichiers distants |
| exit | Terminez votre session SFTP |
| get | Téléchargez un fichier depuis le serveur vers votre machine locale |
| help | Donnez de l'aide |
| lcd | Modifier le répertoire de travail local |
| lpwd | Imprimer le répertoire de travail local |
| ls | Lister les fichiers distants |
| mget | Téléchargez plusieurs fichiers à la fois |
| mkdir | Création de répertoires sur le serveur distant |
| mput | Téléchargez plusieurs fichiers à la fois |
| mv | Déplacer ou renommer un ou plusieurs fichiers sur le serveur distant |
| ouvrir | Se connecter à un hôte |
| put | Téléchargez un fichier depuis votre machine locale vers le serveur |
| mobylette | Imprimez votre répertoire de télétravail |
| quit | Terminez votre session SFTP |
| reget | Poursuivre le téléchargement des fichiers |
| ren | Déplacer ou renommer un ou plusieurs fichiers sur le serveur distant |
| réputation | Poursuivre le téléchargement des fichiers |
| rm | Supprimer des fichiers sur le serveur distant |
| rmdir | Supprimer des répertoires sur le serveur distant |
## Étapes suivantes
Pour charger et télécharger des fichiers dans Amazon Simple Storage Service à l'aide du protocole SFTP, vous pouvez utiliser le protocole M2SFTP conjointement avec le protocole AWS Transfer Family, comme décrit dans les articles de blog suivants.
+ [Utilisation de répertoires logiques AWS SFTP pour créer un service de distribution de données simple](https://aws.amazon.com/blogs/storage/using-aws-sftp-logical-directories-to-build-a-simple-data-distribution-service/)
+ [Activer l'authentification par mot de passe pour AWS Transfer for SFTP l'utilisation AWS Secrets Manager](https://aws.amazon.com/blogs/storage/enable-password-authentication-for-aws-transfer-for-sftp-using-aws-secrets-manager/)