

AWS Il servizio di modernizzazione del mainframe (esperienza Managed Runtime Environment) non è più aperto a nuovi clienti. Per funzionalità simili a AWS Mainframe Modernization Service (esperienza Managed Runtime Environment), esplora AWS Mainframe Modernization Service (Self-Managed Experience). I clienti esistenti possono continuare a utilizzare il servizio normalmente. [Per ulteriori informazioni, consulta AWS Modifica della disponibilità di Mainframe Modernization.](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Utilità batch M2SFTP
<a name="m2sftp"></a>

M2SFTP è un programma di utilità JCL progettato per eseguire trasferimenti sicuri di file tra sistemi utilizzando il Secure File Transfer Protocol (SFTP). Il programma utilizza il client Putty SFTP per eseguire i trasferimenti di file `psftp` effettivi. Il programma funziona in modo simile a un programma di utilità FTP per mainframe e utilizza l'autenticazione di utenti e password.

**Nota**  
L'autenticazione a chiave pubblica non è supportata.

Per convertire l'FTP del mainframe in JCLs modo che utilizzi SFTP, cambia in. `PGM=FTP` `PGM=M2SFTP`

**Topics**
+ [Piattaforme supportate](#m2sftp-platforms)
+ [Installazione delle dipendenze](#m2sftp-dependencies)
+ [Configurare M2SFTP per Mainframe Modernization Managed AWS](#m2sftp-configure-managed)
+ [Configura M2SFTP per il runtime di modernizzazione AWS del mainframe su Amazon EC2 (comprese le applicazioni) WorkSpaces](#m2sftp-configure-customer-infra)
+ [Esempio JCLs](#m2sftp-jcl)
+ [Riferimento ai comandi del client Putty SFTP (PSFTP)](#m2sftp-cmd-ref)
+ [Fasi successive](#m2sftp-next)

## Piattaforme supportate
<a name="m2sftp-platforms"></a>

È possibile utilizzare M2SFTP su una delle seguenti piattaforme:
+ AWS Software Mainframe Modernization Rocket (precedentemente Micro Focus) gestito
+ Rocket Software Runtime (su Amazon EC2)
+ Tutte le varianti dei prodotti Rocket Software Enterprise Developer (ED) e Rocket Software Enterprise Server (ES).

## Installazione delle dipendenze
<a name="m2sftp-dependencies"></a>

**Per installare il client SFTP Putty su Windows**
+ Scarica il client [SFTP PuTTY e](https://www.putty.org/) installalo.

**Per installare il client SFTP Putty su Linux:**
+ Esegui il seguente comando per installare il client Putty SFTP:

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

## Configurare M2SFTP per Mainframe Modernization Managed AWS
<a name="m2sftp-configure-managed"></a>

Se le applicazioni migrate sono in esecuzione su AWS Mainframe Modernization Managed, sarà necessario configurare M2SFTP come segue.
+ Imposta le variabili di ambiente Rocket Enterprise Server appropriate per MFFTP. Ecco alcuni esempi:
  + `MFFTP_TEMP_DIR`
  + `MFFTP_SENDEOL`
  + `MFFTP_TIME`
  + `MFFTP_ABEND`

  Puoi impostare quante o quante di queste variabili desideri. Puoi impostarle nel tuo JCL usando l'`ENVAR DD`istruzione. Per ulteriori informazioni su queste variabili, consultate [MFFTP Control Variables](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-3F94BBC8-CB97-4642-A4A7-4235C0C079E2.html) nella documentazione di Micro Focus.

Per testare la configurazione, consulta. [Esempio JCLs](#m2sftp-jcl)

## Configura M2SFTP per il runtime di modernizzazione AWS del mainframe su Amazon EC2 (comprese le applicazioni) WorkSpaces
<a name="m2sftp-configure-customer-infra"></a>

Se le applicazioni migrate sono in esecuzione sul runtime di modernizzazione del AWS mainframe su Amazon EC2, configura M2SFTP come segue.

1. Modificate il [percorso del programma Micro Focus JES per includere la posizione binaria](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-BC8A1796-9EDE-48EB-8363-31C9BDE7F96B.html) per le utilità batch. Se è necessario specificare più percorsi, utilizzate i due punti (`:`) per separare i percorsi su Linux e il punto e virgola () su Windows. `;`
   + Linux: `/opt/aws/m2/microfocus/utilities/64bit`
   + Windows (32 bit): `C:\AWS\M2\MicroFocus\Utilities\32bit`
   + Windows (64 bit): `C:\AWS\M2\MicroFocus\Utilities\64bit`

1. Imposta le variabili di ambiente Rocket Enterprise Server appropriate per MFFTP. Ecco alcuni esempi:
   + `MFFTP_TEMP_DIR`
   + `MFFTP_SENDEOL`
   + `MFFTP_TIME`
   + ``MFFTP\$1ABEND

   È possibile impostare quante o quante di queste variabili si desidera. Puoi impostarle nel tuo JCL usando l'`ENVAR DD`istruzione. Per ulteriori informazioni su queste variabili, consultate [MFFTP Control Variables](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-3F94BBC8-CB97-4642-A4A7-4235C0C079E2.html) nella documentazione di Micro Focus.

Per testare la configurazione, consulta. [Esempio JCLs](#m2sftp-jcl)

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

Per testare l'installazione, è possibile utilizzare uno dei seguenti file JCL di esempio.

**M2 .jcl SFTP1**

Questo JCL mostra come chiamare M2SFTP per inviare un file a un server SFTP remoto. Notate le variabili di ambiente impostate nell'istruzione. `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 SFTP2 .jcl**

Questo JCL mostra come chiamare M2SFTP per ricevere un file da un server SFTP remoto. Notate le variabili di ambiente impostate nell'istruzione. `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**  
Consigliamo vivamente di archiviare le credenziali FTP in un file NETRC e di limitare l'accesso ai soli utenti autorizzati.

## Riferimento ai comandi del client Putty SFTP (PSFTP)
<a name="m2sftp-cmd-ref"></a>

Il client PSFTP non supporta tutti i comandi FTP. L'elenco seguente mostra tutti i comandi supportati da PSFTP.


| Comando | Description | 
| --- | --- | 
|  \$1  |  Esegui un comando locale  | 
|  addio  |  Termina la tua sessione SFTP  | 
|  cd  |  Cambia la tua directory di lavoro remota  | 
|  chmod  |  Modifica le autorizzazioni e le modalità dei file  | 
|  close  |  Termina la sessione SFTP ma non uscire da PSFTP  | 
|  del  |  Eliminare i file sul server remoto  | 
|  dir  |  Elenca i file remoti  | 
|  Esci  |  Termina la sessione SFTP  | 
|  get  |  Scarica un file dal server sul tuo computer locale  | 
|  aiuto  |  Offri aiuto  | 
|  LCD  |  Cambia la directory di lavoro locale  | 
|  lpwd  |  Stampa la cartella di lavoro locale  | 
|  ls  |  Elenca i file remoti  | 
|  mget  |  Scarica più file contemporaneamente  | 
|  mkdir  |  Crea directory sul server remoto  | 
|  Imput  |  Carica più file contemporaneamente  | 
|  mv  |  Spostare o rinominare i file sul server remoto  | 
|  aperto  |  Connect a un host  | 
|  put  |  Carica un file dal tuo computer locale al server  | 
|  pwd  |  Stampa la tua directory di lavoro remota  | 
|  Esci  |  Termina la sessione SFTP  | 
|  rimpiango  |  Continua a scaricare i file  | 
|  ren  |  Sposta o rinomina i file sul server remoto  | 
|  riportare  |  Continua a caricare i file  | 
|  rm  |  Eliminare i file sul server remoto  | 
|  rmdir  |  Rimuove le directory sul server remoto  | 

## Fasi successive
<a name="m2sftp-next"></a>

Per caricare e scaricare file in Amazon Simple Storage Service utilizzando SFTP, puoi usare M2SFTP insieme a AWS Transfer Family, come descritto nei seguenti post di blog.
+ [Utilizzo delle directory logiche AWS SFTP per creare un semplice servizio di distribuzione dei dati](https://aws.amazon.com/blogs/storage/using-aws-sftp-logical-directories-to-build-a-simple-data-distribution-service/)
+ [Abilita l'autenticazione tramite password per l'utilizzo AWS Transfer for SFTPGestione dei segreti AWS](https://aws.amazon.com/blogs/storage/enable-password-authentication-for-aws-transfer-for-sftp-using-aws-secrets-manager/)