

AWS Layanan Modernisasi Mainframe (Managed Runtime Environment experience) tidak lagi terbuka untuk pelanggan baru. Untuk kemampuan yang mirip dengan Layanan Modernisasi AWS Mainframe (pengalaman Lingkungan Runtime Terkelola), jelajahi Layanan Modernisasi AWS Mainframe (Pengalaman yang Dikelola Sendiri). Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Untuk informasi selengkapnya, lihat Perubahan [AWS ketersediaan Modernisasi Mainframe](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html).

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Utilitas batch M2SFTP
<a name="m2sftp"></a>

M2SFTP adalah program utilitas JCL yang dirancang untuk melakukan transfer file aman antar sistem menggunakan Secure File Transfer Protocol (SFTP). Program ini menggunakan klien Putty SFTP,`psftp`, untuk melakukan transfer file yang sebenarnya. Program ini bekerja mirip dengan program utilitas FTP mainframe dan menggunakan otentikasi pengguna dan kata sandi.

**catatan**  
Otentikasi kunci publik tidak didukung.

Untuk mengonversi FTP mainframe Anda JCLs untuk menggunakan SFTP, ubah ke. `PGM=FTP` `PGM=M2SFTP`

**Topics**
+ [Platform yang didukung](#m2sftp-platforms)
+ [Menginstal dependensi](#m2sftp-dependencies)
+ [Konfigurasikan M2SFTP untuk Modernisasi Mainframe Dikelola AWS](#m2sftp-configure-managed)
+ [Konfigurasikan M2SFTP untuk runtime Modernisasi AWS Mainframe di Amazon EC2 (termasuk Aplikasi) WorkSpaces](#m2sftp-configure-customer-infra)
+ [Sampel JCLs](#m2sftp-jcl)
+ [Referensi perintah klien Putty SFTP (PSFTP)](#m2sftp-cmd-ref)
+ [Langkah selanjutnya](#m2sftp-next)

## Platform yang didukung
<a name="m2sftp-platforms"></a>

Anda dapat menggunakan M2SFTP di salah satu platform berikut:
+ AWS Perangkat Lunak Roket Modernisasi Mainframe (sebelumnya Fokus Mikro) Dikelola
+ Runtime Perangkat Lunak Roket (di Amazon EC2)
+ Semua varian produk Rocket Software Enterprise Developer (ED) dan Rocket Software Enterprise Server (ES).

## Menginstal dependensi
<a name="m2sftp-dependencies"></a>

**Untuk menginstal klien Putty SFTP di Windows**
+ Unduh klien [Putty SFTP](https://www.putty.org/) dan instal.

**Untuk menginstal klien Putty SFTP di Linux:**
+ Jalankan perintah berikut untuk menginstal klien Putty SFTP:

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

## Konfigurasikan M2SFTP untuk Modernisasi Mainframe Dikelola AWS
<a name="m2sftp-configure-managed"></a>

Jika aplikasi yang dimigrasi berjalan di Modernisasi AWS Mainframe Dikelola, Anda perlu mengonfigurasi M2SFTP sebagai berikut.
+ Tetapkan variabel lingkungan Rocket Enterprise Server yang sesuai untuk MFFTP. Berikut adalah beberapa contoh:
  + `MFFTP_TEMP_DIR`
  + `MFFTP_SENDEOL`
  + `MFFTP_TIME`
  + `MFFTP_ABEND`

  Anda dapat mengatur sesedikit atau sebanyak variabel ini yang Anda inginkan. Anda dapat mengaturnya di JCL Anda menggunakan `ENVAR DD` pernyataan. Untuk informasi selengkapnya tentang variabel-variabel ini, lihat Variabel [Kontrol MFFTP dalam dokumentasi Fokus](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-3F94BBC8-CB97-4642-A4A7-4235C0C079E2.html) Mikro.

Untuk menguji konfigurasi Anda, lihat[Sampel JCLs](#m2sftp-jcl).

## Konfigurasikan M2SFTP untuk runtime Modernisasi AWS Mainframe di Amazon EC2 (termasuk Aplikasi) WorkSpaces
<a name="m2sftp-configure-customer-infra"></a>

Jika aplikasi yang dimigrasi berjalan pada runtime Modernisasi AWS Mainframe di Amazon EC2, konfigurasikan M2SFTP sebagai berikut.

1. Ubah [Jalur Program Micro Focus JES](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-BC8A1796-9EDE-48EB-8363-31C9BDE7F96B.html) untuk menyertakan lokasi biner untuk utilitas batch. Jika Anda perlu menentukan beberapa jalur, gunakan titik dua (`:`) untuk memisahkan jalur di Linux dan titik koma (`;`) di Windows.
   + Linux: `/opt/aws/m2/microfocus/utilities/64bit`
   + Windows (32bit): `C:\AWS\M2\MicroFocus\Utilities\32bit`
   + Windows (64bit): `C:\AWS\M2\MicroFocus\Utilities\64bit`

1. Tetapkan variabel lingkungan Rocket Enterprise Server yang sesuai untuk MFFTP. Berikut adalah beberapa contoh:
   + `MFFTP_TEMP_DIR`
   + `MFFTP_SENDEOL`
   + `MFFTP_TIME`
   + ``MFFTP\$1ABEND

   Anda dapat mengatur sesedikit atau sebanyak variabel ini yang Anda inginkan. Anda dapat mengaturnya di JCL Anda menggunakan `ENVAR DD` pernyataan. Untuk informasi selengkapnya tentang variabel-variabel ini, lihat Variabel [Kontrol MFFTP dalam dokumentasi Fokus](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-3F94BBC8-CB97-4642-A4A7-4235C0C079E2.html) Mikro.

Untuk menguji konfigurasi Anda, lihat[Sampel JCLs](#m2sftp-jcl).

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

Untuk menguji instalasi, Anda dapat menggunakan salah satu dari contoh file JCL berikut.

**M2 SFTP1 .jcl**

JCL ini menunjukkan cara memanggil M2SFTP untuk mengirim file ke server SFTP jarak jauh. Perhatikan variabel lingkungan yang diatur dalam `ENVVAR DD` pernyataan.

```
//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**

JCL ini menunjukkan cara memanggil M2SFTP untuk menerima file dari server SFTP jarak jauh. Perhatikan variabel lingkungan yang ditetapkan dalam `ENVVAR DD` pernyataan.

```
//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
/*
//*
//
```

**catatan**  
Kami sangat menyarankan untuk menyimpan kredensil FTP dalam file NETRC dan membatasi akses hanya ke pengguna yang berwenang.

## Referensi perintah klien Putty SFTP (PSFTP)
<a name="m2sftp-cmd-ref"></a>

Klien PSFTP tidak mendukung semua perintah FTP. Daftar berikut menunjukkan semua perintah yang didukung PSFTP.


| Perintah | Deskripsi | 
| --- | --- | 
|  \$1  |  Jalankan perintah lokal  | 
|  selamat tinggal  |  Selesaikan sesi SFTP Anda  | 
|  cd  |  Ubah direktori kerja jarak jauh Anda  | 
|  chmod  |  Ubah izin dan mode file  | 
|  tutup  |  Selesaikan sesi SFTP Anda tetapi jangan keluar dari PSFTP  | 
|  del  |  Hapus file di server jarak jauh  | 
|  dir  |  Daftar file jarak jauh  | 
|  keluar  |  Selesaikan sesi SFTP Anda  | 
|  memperoleh  |  Unduh file dari server ke mesin lokal Anda  | 
|  bantuan  |  Berikan bantuan  | 
|  lcd  |  Ubah direktori kerja lokal  | 
|  lpwd  |  Cetak direktori kerja lokal  | 
|  ls  |  Daftar file jarak jauh  | 
|  mget  |  Unduh beberapa file sekaligus  | 
|  mkdir  |  Buat direktori di server jarak jauh  | 
|  mput  |  Unggah beberapa file sekaligus  | 
|  mv  |  Memindahkan atau mengganti nama file di server jarak jauh  | 
|  terbuka  |  Connect ke host  | 
|  menempatkan  |  Unggah file dari mesin lokal Anda ke server  | 
|  pwd  |  Cetak direktori kerja jarak jauh Anda  | 
|  berhenti  |  Selesaikan sesi SFTP Anda  | 
|  reget  |  Lanjutkan mengunduh file  | 
|  ren  |  Memindahkan atau mengganti nama file di server jarak jauh  | 
|  reput  |  Lanjutkan mengunggah file  | 
|  rm  |  Hapus file di server jarak jauh  | 
|  rmdir  |  Hapus direktori di server jarak jauh  | 

## Langkah selanjutnya
<a name="m2sftp-next"></a>

Untuk mengunggah dan mengunduh file ke Amazon Simple Storage Service menggunakan SFTP, Anda dapat menggunakan M2SFTP bersama dengan AWS Transfer Family, seperti yang dijelaskan dalam posting blog berikut.
+ [Menggunakan direktori logis AWS SFTP untuk membangun layanan distribusi data sederhana](https://aws.amazon.com/blogs/storage/using-aws-sftp-logical-directories-to-build-a-simple-data-distribution-service/)
+ [Aktifkan otentikasi kata sandi untuk menggunakan AWS Transfer for SFTPAWS Secrets Manager](https://aws.amazon.com/blogs/storage/enable-password-authentication-for-aws-transfer-for-sftp-using-aws-secrets-manager/)