Utilitas batch M2SFTP

Mode fokus

Utilitas batch M2SFTP - AWS Modernisasi Mainframe

Platform yang didukung Menginstal dependensi Konfigurasikan M2SFTP untuk Modernisasi Mainframe Dikelola AWS Konfigurasikan M2SFTP untuk runtime AWS Modernisasi Mainframe di Amazon (termasuk 2.0) EC2 AppStream Sampel JCLs Referensi perintah klien Putty SFTP (PSFTP)Langkah selanjutnya

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

Topik

Platform yang didukung
Menginstal dependensi
Konfigurasikan M2SFTP untuk Modernisasi Mainframe Dikelola AWS
Konfigurasikan M2SFTP untuk runtime AWS Modernisasi Mainframe di Amazon (termasuk 2.0) EC2 AppStream
Sampel JCLs
Referensi perintah klien Putty SFTP (PSFTP)
Langkah selanjutnya

Platform yang didukung

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

Untuk menginstal klien Putty SFTP di Windows

Unduh klien Putty SFTP 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

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 Mikro.

Untuk menguji konfigurasi Anda, lihatSampel JCLs.

Konfigurasikan M2SFTP untuk runtime AWS Modernisasi Mainframe di Amazon (termasuk 2.0) EC2 AppStream

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

Ubah Jalur Program Micro Focus JES 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
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 Mikro.

Untuk menguji konfigurasi Anda, lihatSampel JCLs.

Sampel JCLs

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)

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

Perintah	Deskripsi
!	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
help	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

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.