

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.

# Membentuk ulang aplikasi dengan Rocket Software (sebelumnya Micro Focus)
<a name="replatforming-m2"></a>

Panduan ini mencakup end-to-end proses replatforming aplikasi mainframe menggunakan solusi Modernisasi AWS Mainframe pada. AWS Ini menjelaskan semua tugas dan mencakup informasi tentang mengonfigurasi dan mengoperasikan runtime Modernisasi AWS Mainframe di Amazon EC2 mulai dari penyiapan dan analisis awal hingga pembuatan, pengujian, dan penerapan aplikasi modern Anda. AWS Ini juga mencakup topik-topik lanjutan seperti bekerja dengan struktur data lama, menggunakan templat dan proyek yang telah ditentukan, dan menyiapkan otomatisasi untuk sesi streaming. 

**Topics**
+ [Mengatur Perangkat Lunak Roket (sebelumnya Micro Focus) (di Amazon EC2)](mf-runtime-setup.md)
+ [Mengatur Otomasi untuk Rocket Enterprise Analyzer (sebelumnya Micro Focus) dan Sesi Streaming Pengembang Rocket Enterprise](set-up-automation-m2.md)
+ [Lihat kumpulan data sebagai tabel dan kolom di Rocket Enterprise Developer (sebelumnya Micro Focus Enterprise Developer)](view-datasets-tables-m2.md)
+ [Edit kumpulan data menggunakan Perangkat Lunak Roket (sebelumnya Fokus Mikro) Alat File Data di Pengembang Perusahaan](edit-datasets-m2.md)
+ [Tutorial untuk Perangkat Lunak Roket (sebelumnya Micro Focus)](tutorials-mf.md)
+ [Utilitas batch yang tersedia di Modernisasi AWS Mainframe](utilities-m2.md)

# Mengatur Perangkat Lunak Roket (sebelumnya Micro Focus) (di Amazon EC2)
<a name="mf-runtime-setup"></a>

AWS Mainframe Modernization menyediakan beberapa Amazon Machine Images (AMI) yang mencakup produk berlisensi Rocket Software (sebelumnya Micro Focus). AMI ini memungkinkan Anda menyediakan instans Amazon Elastic Compute Cloud (Amazon EC2) dengan cepat untuk mendukung lingkungan Perangkat Lunak Rocket yang Anda kontrol dan kelola. Topik ini menyediakan langkah-langkah yang diperlukan untuk mengakses dan meluncurkan ini AMIs. Menggunakan AMIs ini sepenuhnya opsional dan mereka tidak diharuskan untuk menyelesaikan tutorial dalam panduan pengguna ini.

**Topics**
+ [Prasyarat untuk menyiapkan Perangkat Lunak Rocket (sebelumnya Micro Focus) (di Amazon EC2)](mf-runtime-setup-prereq.md)
+ [Buat titik akhir Amazon VPC untuk Amazon S3](mf-runtime-setup-vpc.md)
+ [Minta pembaruan daftar izin untuk akun](mf-runtime-setup-allowlist.md)
+ [Buat AWS Identity and Access Management peran](mf-runtime-setup-iam-role.md)
+ [Berikan License Manager izin yang diperlukan](mf-runtime-setup-lic.md)
+ [Berlangganan Gambar Mesin Amazon](mf-runtime-setup-ami.md)
+ [Luncurkan instance AWS Mainframe Modernization Rocket Software (sebelumnya Micro Focus)](mf-runtime-setup-mf-instance.md)
+ [Subnet atau VPC tanpa akses internet](mf-runtime-setup-no-access.md)

# Prasyarat untuk menyiapkan Perangkat Lunak Rocket (sebelumnya Micro Focus) (di Amazon EC2)
<a name="mf-runtime-setup-prereq"></a>

Saat Anda mengatur Perangkat Lunak Roket (di Amazon EC2), pastikan Anda memenuhi prasyarat berikut.
+ Akses administrator ke akun tempat instans Amazon EC2 akan dibuat.
+ Identifikasi Wilayah AWS di mana instans Amazon EC2 akan dibuat dan verifikasi AWS Mainframe Modernization layanan tersedia. Lihat [AWS Layanan berdasarkan Wilayah](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/). Pastikan untuk memilih Wilayah di mana layanan tersedia.
+ Identifikasi Amazon Virtual Private Cloud (Amazon VPC) tempat instans Amazon EC2 akan dibuat.

# Buat titik akhir Amazon VPC untuk Amazon S3
<a name="mf-runtime-setup-vpc"></a>

Di bagian ini, Anda membuat titik akhir Amazon VPC untuk Amazon S3 untuk digunakan. Menyiapkan endpoint ini akan membantu Anda nanti saat mengatur akses internet untuk VPC. 

1. Arahkan ke Amazon VPC di. Konsol Manajemen AWS

1. Di panel navigasi, pilih **Titik Akhir**.

1. Pilih **Buat Titik Akhir**.  
![\[Titik akhir VPC dengan Create Endpoint aktif.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-create-s3-endpoint_1.jpg)

1. Masukkan tag nama yang berarti, misalnya: “Micro-Focus-License-S3".

1. Pilih **AWS Services** sebagai Kategori Layanan.  
![\[Pengaturan Endpoint dengan tag nama sampel dimasukkan.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-create-s3-endpoint_2.png)

1. **Di bawah **Layanan, cari layanan** Amazon S3 Gateway: com.amazonaws. [wilayah] .s3**.

   Untuk `us-west-1` ini akan menjadi:`com.amazonaws.us-west-1.s3`.

1. Pilih layanan **Gateway**.  
![\[Layanan dengan layanan Amazon S3 Gateway dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-create-s3-endpoint_3.png)

1. Untuk VPC pilih VPC yang akan Anda gunakan.  
![\[VPC dengan VPC dimasukkan.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-create-s3-endpoint_4.png)

1. Pilih semua tabel rute untuk VPC.  
![\[Rute tabel dengan semua tabel rute dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-create-s3-endpoint_5.png)

1. Di bawah **Kebijakan** pilih **Akses Penuh**.  
![\[Kebijakan dengan Akses Penuh dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-create-s3-endpoint_6.png)
**catatan**  
Jika Anda memutuskan untuk membuat kebijakan khusus, pastikan kebijakan tersebut memiliki akses ke bucket Amazon S3. `s3://aws-supernova-marketplace-<region>-prod`

1. Pilih **Buat Titik Akhir**.

# Minta pembaruan daftar izin untuk akun
<a name="mf-runtime-setup-allowlist"></a>

Bekerja dengan AWS perwakilan Anda agar akun Anda diizinkan terdaftar untuk. AWS Mainframe Modernization AMIs Harap berikan informasi berikut:
+  Akun AWS ID.
+  Wilayah AWS Tempat titik akhir VPC Amazon dibuat.
+ ID titik akhir Amazon VPC Amazon S3 Amazon dibuat di. [Buat titik akhir Amazon VPC untuk Amazon S3](mf-runtime-setup-vpc.md) Ini adalah `vpce-xxxxxxxxxxxxxxxxx` id untuk **com.amazonaws. [wilayah] .s3 Titik akhir Gateway**.
+ Jumlah lisensi yang diperlukan di semua instans Rocket Software Enterprise Suite AMI Amazon EC2.

  Satu lisensi diperlukan per inti CPU (per 2 vCPU untuk sebagian besar instans Amazon EC2).

  Untuk informasi selengkapnya, lihat [Optimalkan opsi CPU](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-optimize-cpu.html#cpu-options-compute-optimized).

  Nomor yang diminta dapat disesuaikan di masa depan oleh AWS.

**catatan**  
Hubungi AWS perwakilan Anda atau AWS Dukungan yang akan membuka tiket dukungan untuk permintaan Allowlist atas nama Anda. Itu tidak dapat diminta langsung oleh Anda dan permintaan mungkin memakan waktu beberapa hari untuk diselesaikan.

# Buat AWS Identity and Access Management peran
<a name="mf-runtime-setup-iam-role"></a>

Buat AWS Identity and Access Management kebijakan dan peran yang akan digunakan oleh instans AWS Mainframe Modernization Amazon EC2. Membuat peran melalui konsol IAM akan membuat profil instance terkait dengan nama yang sama. Menetapkan profil instans ini ke instans Amazon EC2 memungkinkan Lisensi Perangkat Lunak Rocket ditetapkan. Untuk informasi selengkapnya tentang profil instans, lihat [Menggunakan peran IAM untuk memberikan izin ke aplikasi yang berjalan di instans Amazon EC2](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-ec2.html).

## Buat kebijakan IAM
<a name="mf-runtime-setup-iam-role-policy"></a>

Kebijakan IAM dibuat terlebih dahulu dan kemudian dilampirkan pada peran tersebut.

1. Arahkan ke AWS Identity and Access Management dalam Konsol Manajemen AWS.

1. Pilih **Kebijakan** dan kemudian **Buat Kebijakan**.  
![\[Halaman kebijakan tanpa filter yang diterapkan.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-create-iam-policy_1.png)

1. Pilih tab **JSON**.  
![\[Tab JSON tanpa konten\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-create-iam-policy_2.png)

1. Ganti `us-west-1` di JSON berikut dengan Wilayah AWS tempat titik akhir Amazon S3 ditentukan, lalu salin dan tempel JSON ke editor kebijakan.

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Sid": "S3WriteObject",
               "Effect": "Allow",
               "Action": [
                   "s3:PutObject"
               ],
               "Resource": [
                   "arn:aws:s3:::aws-supernova-marketplace-us-west-1-prod/*"
               ]
           },
           {
               "Sid": "OtherRequiredActions",
               "Effect": "Allow",
               "Action": [
                   "sts:GetCallerIdentity",
                   "ec2:DescribeInstances",
                   "license-manager:ListReceivedLicenses"
               ],
               "Resource": [
                   "*"
               ]
           }
       ]
   }
   ```

------
**catatan**  
Tindakan di bawah Sid `OtherRequiredActions` tidak mendukung izin tingkat sumber daya dan harus menentukan `*` dalam elemen sumber daya.  
![\[Tab JSON dengan kebijakan dimasukkan dan us-west-1 disorot.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-create-iam-policy_3.png)

1. Pilih **Berikutnya: Tanda**.  
![\[Tag tanpa data yang dimasukkan.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-create-iam-policy_4.png)

1. Secara opsional masukkan tag apa pun, lalu pilih **Berikutnya: Tinjau**.

1. Masukkan nama untuk kebijakan tersebut, misalnya “Micro-focus-Licensing-Policy”. Secara opsional masukkan deskripsi, misalnya “Peran yang menyertakan kebijakan ini harus dilampirkan ke setiap instans AWS Mainframe Modernization Amazon EC2.”  
![\[Tinjau kebijakan dengan nama dan deskripsi yang dimasukkan.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-create-iam-policy_5.png)

1. Pilih **Buat Kebijakan**.

## Buat peran IAM
<a name="mf-runtime-setup-iam-role-create"></a>

Setelah membuat kebijakan IAM, Anda membuat peran IAM dan melampirkannya ke kebijakan. 

1. Arahkan ke IAM di. Konsol Manajemen AWS

1. Pilih **Peran** dan kemudian **Buat Peran**.  
![\[Peran tanpa filter diterapkan.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-create-iam-role_1.png)

1. Tinggalkan **jenis entitas Tepercaya** sebagai **AWS layanan** dan pilih kasus penggunaan umum **EC2**.  
![\[Pilih entitas tepercaya dengan AWS layanan dan EC2 dipilih\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-create-iam-role_2.png)

1. Pilih **Berikutnya**.

1. Masukkan “Mikro” ke dalam filter dan tekan enter untuk menerapkan filter.

1. Pilih kebijakan yang baru saja dibuat, misalnya “Micro-focus-Licensing-Policy”. 

1. Pilih **Berikutnya**.  
![\[Tambahkan izin dengan kebijakan Fokus Mikro yang dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-create-iam-role_3.png)

1. Masukkan nama Peran, misalnya “Micro-focus-Licensing-Role”. 

1. Ganti deskripsi dengan salah satu deskripsi Anda sendiri, misalnya “Mengizinkan instans Amazon EC2 dengan peran ini untuk mendapatkan Lisensi Fokus Mikro”.   
![\[Detail peran dengan nama dan deskripsi dimasukkan.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-create-iam-role_4.png)

1. Di bawah **Langkah 1: Pilih entitas tepercaya**, tinjau JSON dan konfirmasikan bahwa JSON memiliki nilai berikut:

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
                   "sts:AssumeRole"
               ],
               "Principal": {
                   "Service": [
                       "ec2.amazonaws.com"
                   ]
               }
           }
       ]
   }
   ```

------
**catatan**  
Urutan Efek, Tindakan, dan Prinsipal tidak signifikan.

1. Konfirmasikan bahwa **Langkah 2: Tambahkan izin** menunjukkan kebijakan Lisensi Anda.  
![\[Langkah 2: Tambahkan izin dengan kebijakan lisensi yang dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-create-iam-role_6.png)

1. Pilih **Buat peran**.

Setelah permintaan allowlist selesai, lanjutkan dengan langkah-langkah berikut.

# Berikan License Manager izin yang diperlukan
<a name="mf-runtime-setup-lic"></a>

Anda harus memberikan izin untuk menyiapkan mesin runtime Perangkat Lunak Rocket (di Amazon EC2). AWS License Manager 

1. Arahkan ke AWS License Manager dalam Konsol Manajemen AWS.  
![\[AWS License Manager halaman rumah.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-license-manager_1.png)

1. Pilih **Mulai menggunakan AWS License Manager**.

1. Jika Anda melihat pop-up berikut, lihat detailnya, lalu pilih kotak centang dan tekan **Hibah** Izin.  
![\[Izin IAM pengaturan satu kali\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-license-manager_2.png)

# Berlangganan Gambar Mesin Amazon
<a name="mf-runtime-setup-ami"></a>

Setelah Anda berlangganan AWS Marketplace produk, Anda dapat meluncurkan instance dari AMI produk. Anda juga dapat mengelola AMI berlangganan saat menyiapkan mesin runtime Rocket Software (sebelumnya Micro Focus) (di Amazon EC2).

1. Arahkan ke AWS Marketplace Langganan di. Konsol Manajemen AWS

1. Pilih **Kelola langganan**.  
![\[AWS Marketplace halaman rumah.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-ami-subscription_1.png)

1. Salin dan tempel salah satu tautan berikut ke bilah alamat browser.
**catatan**  
Hanya pilih tautan untuk salah satu produk yang telah diizinkan untuk Anda gunakan.
Pastikan akun Anda diizinkan terdaftar dengan mengikuti [Minta pembaruan daftar izin untuk akun](mf-runtime-setup-allowlist.md) halaman untuk menggunakan tautan ini.
   + Server Perusahaan: [https://aws.amazon.com/marketplace/pp/prodview-g5emev63l7blc](https://aws.amazon.com/marketplace/pp/prodview-g5emev63l7blc)
   + Server Perusahaan untuk Windows: [https://aws.amazon.com/marketplace/pp/prodview-lwybsiyikbhc2](https://aws.amazon.com/marketplace/pp/prodview-lwybsiyikbhc2)
   + Pengembang Perusahaan: [https://aws.amazon.com/marketplace/pp/prodview-77qmpr42yzxwk](https://aws.amazon.com/marketplace/pp/prodview-77qmpr42yzxwk)
   + Pengembang Perusahaan dengan Visual Studio 2022: [https://aws.amazon.com/marketplace/pp/prodview-m4l3lqiszo6cm](https://aws.amazon.com/marketplace/pp/prodview-m4l3lqiszo6cm)
   + [Enterprise Analyzer: https://aws.amazon.com/marketplace/ pp/prodview-tttheylcmcihm](https://aws.amazon.com/marketplace/pp/prodview-tttheylcmcihm)
   + Alat Bangun Perusahaan untuk Windows: [https://aws.amazon.com/marketplace/pp/prodview-2rw35bbt6uozi](https://aws.amazon.com/marketplace/pp/prodview-2rw35bbt6uozi)
   + Prosedur Tersimpan Perusahaan: [https://aws.amazon.com/marketplace/pp/prodview-zoeyqnsdsj6ha](https://aws.amazon.com/marketplace/pp/prodview-zoeyqnsdsj6ha)
   + [Prosedur Tersimpan Perusahaan dengan SQL Server 2019: https://aws.amazon.com/marketplace/ pp/prodview-ynfklquwubnz4](https://aws.amazon.com/marketplace/pp/prodview-ynfklquwubnz4)

1. Pilih **Lanjutkan Berlangganan**.  
![\[Server Perusahaan menawarkan di AWS Marketplace.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-ami-subscription_2.png)

1. Jika Syarat dan Ketentuan dapat diterima, pilih **Terima Syarat**.  
![\[Syarat dan ketentuan berlangganan.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-ami-subscription_3.png)

1. Langganan mungkin memakan waktu beberapa menit untuk diproses.  
![\[Pesan tertunda berlangganan.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-ami-subscription_4.png)

1. Setelah pesan Terima kasih muncul, salin dan tempel tautan berikutnya dari langkah 3 untuk terus menambahkan langganan.  
![\[Berlangganan pesan terima kasih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-ami-subscription_5.png)

1. Berhenti saat **Kelola langganan** menampilkan semua langganan AMIs Anda.
**catatan**  
Preferensi panel (ikon roda gigi) diatur untuk menampilkan Tampilan sebagai Tabel.  

![\[Kelola langganan dengan daftar berlangganan AMIs.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-ami-subscription_6.png)


# Luncurkan instance AWS Mainframe Modernization Rocket Software (sebelumnya Micro Focus)
<a name="mf-runtime-setup-mf-instance"></a>

Setelah membuat endpoint, kebijakan IAM, peran IAM, dan berlangganan AMIs, Anda siap meluncurkan instance AWS Mainframe Modernization Rocket Software (Micro Focus) di. Konsol Manajemen AWS

1. Arahkan ke AWS Marketplace Langganan di. Konsol Manajemen AWS

1. Temukan AMI yang akan diluncurkan dan pilih **Launch New Instance**.  
![\[Kelola langganan dengan Enterprise Server dan Enterprise Analyzer siap diluncurkan.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-launch-instance_1.png)

1. Dalam dialog peluncuran instance baru, pastikan wilayah yang diizinkan dipilih.

1. Tekan **Lanjutkan untuk meluncurkan melalui EC2**.
**catatan**  
Contoh berikut menunjukkan peluncuran AMI Pengembang Perusahaan, tetapi prosesnya sama untuk semua AWS Mainframe Modernization AMIs.  

![\[Luncurkan instance baru.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-launch-instance_2.png)


1. Masukkan nama untuk server.

1. Pilih jenis instance.

   Jenis Instance yang dipilih harus ditentukan oleh kinerja proyek dan persyaratan biaya. Berikut ini adalah titik awal yang disarankan:
   + Untuk Enterprise Analyzer, sebuah r6i.xlarge
   + Untuk Pengembang Perusahaan, sebuah r6i.large
   + Untuk instance mandiri Enterprise Server, sebuah r6i.xlarge
   + Untuk Rocket Software Performance Availability Cluster (PAC) dengan scale-out, sebuah r6i.large
**catatan**  
Bagian Application and OS Images telah diciutkan untuk screen shot.  
![\[Luncurkan instance dengan nama dan jenis instance yang dimasukkan.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-launch-instance_3.png)

1. Pilih atau buat (dan simpan) pasangan kunci (tidak ditampilkan).

   Untuk informasi selengkapnya tentang pasangan kunci untuk instans Linux, lihat [pasangan kunci Amazon EC2 dan](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html) instans Linux.

   Untuk informasi selengkapnya tentang pasangan kunci untuk instans Windows, lihat [pasangan kunci Amazon EC2 dan](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ec2-key-pairs.html) instans Windows.

1. Edit pengaturan Jaringan dan **pilih VPC yang diizinkan dan Subnet** yang sesuai.

1. **Pilih atau buat Grup Keamanan**. Jika ini adalah contoh Enterprise Server EC2, biasanya memungkinkan lalu lintas TCP ke port 86 dan 10086 untuk mengelola konfigurasi Perangkat Lunak Rocket.

1. Konfigurasikan penyimpanan untuk instans Amazon EC2 secara opsional.

1. Penting - Perluas Detail lanjutan dan di bawah profil instans IAM pilih peran Lisensi yang dibuat sebelumnya, misalnya “Micro-focus-Licensing-role”.
**catatan**  
Jika langkah ini terlewatkan, setelah instance dibuat, Anda dapat memodifikasi peran IAM dari opsi Keamanan menu Tindakan untuk instans EC2.  
![\[Detail Lanjutan dengan profil instans IAM dimasukkan.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-launch-instance_4.png)

1. Tinjau Ringkasan dan dorong **Instans Peluncuran**.  
![\[Ringkasan dengan opsi yang dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-launch-instance_5.png)

1. Peluncuran instance akan gagal jika jenis server virtual yang tidak valid dipilih.

   Jika ini terjadi, pilih **Edit konfigurasi instance** dan ubah jenis instance.  
![\[Meluncurkan pesan kemajuan instance.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-launch-instance_6.png)

1. Setelah pesan “Sukses” ditampilkan, pilih **Connect to instance** untuk mendapatkan detail koneksi.  
![\[Instance meluncurkan pesan sukses.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-launch-instance_7.png)

1. Atau, navigasikan ke **EC2** di. Konsol Manajemen AWS

1. Pilih **Instans** untuk melihat status instans baru.  
![\[Daftar contoh dengan status.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-launch-instance_8.png)

# Subnet atau VPC tanpa akses internet
<a name="mf-runtime-setup-no-access"></a>

Lakukan perubahan tambahan ini jika subnet atau VPC tidak memiliki akses Internet keluar.

Manajer lisensi memerlukan akses ke layanan AWS berikut:
+ com.amazonaws. *region*.s3
+ com.amazonaws. *region*.ec2
+ com.amazonaws. *region*.license-manajer
+ com.amazonaws. *region*.sts

Langkah-langkah sebelumnya mendefinisikan com.amazonaws. *region*.s3 layanan sebagai titik akhir gateway. Endpoint ini membutuhkan entri tabel rute untuk setiap subnet tanpa akses Internet.

Tiga layanan tambahan akan didefinisikan sebagai titik akhir antarmuka.

**Topics**
+ [Tambahkan entri tabel Route untuk titik akhir Amazon S3](#mf-runtime-setup-no-access-route-table)
+ [Tentukan grup keamanan yang diperlukan](#mf-runtime-setup-no-access-security-group)
+ [Buat titik akhir layanan](#mf-runtime-setup-no-access-endpoints)

## Tambahkan entri tabel Route untuk titik akhir Amazon S3
<a name="mf-runtime-setup-no-access-route-table"></a>

1. **Arahkan ke **VPC** di Konsol Manajemen AWS dan pilih Subnet.**

1. Pilih subnet tempat instans Amazon EC2 akan dibuat dan pilih tab Route Table.

1. Perhatikan beberapa digit tambahan dari id tabel Route. Misalnya, 6b39 pada gambar di bawah ini.  
![\[Rincian tabel rute.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-no-internet_1.png)

1. Pilih **Endpoints** dari panel navigasi.

1. Pilih titik akhir yang dibuat sebelumnya dan kemudian **Kelola tabel Rute**, baik dari tab Tabel Rute untuk titik akhir, atau dari drop-down Tindakan.

1. Pilih tabel Route menggunakan digit yang diidentifikasi sebelumnya dan tekan Ubah tabel rute.  
![\[Tabel rute dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-no-internet_2.png)

## Tentukan grup keamanan yang diperlukan
<a name="mf-runtime-setup-no-access-security-group"></a>

Layanan Amazon EC2, AWS STS, dan License Manager berkomunikasi melalui HTTPS melalui port 443. Komunikasi ini bersifat bi-directional dan membutuhkan aturan masuk dan keluar untuk memungkinkan instance berkomunikasi dengan layanan.

1. Arahkan ke Amazon VPC di. Konsol Manajemen AWS

1. Temukan **Grup Keamanan** di bilah navigasi dan pilih **Buat grup keamanan**.

1. Masukkan nama dan deskripsi grup Keamanan, misalnya “HTTPS Inbound-Outbound”.

1. Tekan X di area pemilihan VPC untuk **menghapus VPC default, dan pilih VPC** yang berisi titik akhir S3.

1. Tambahkan Aturan Masuk yang **memungkinkan lalu lintas TCP di Port 443** dari mana saja.
**catatan**  
Aturan masuk (dan keluar) dapat dibatasi lebih lanjut dengan membatasi Sumber. Untuk informasi selengkapnya, lihat [Mengontrol lalu lintas ke AWS sumber daya Anda menggunakan grup keamanan](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-security-groups.html) di *Panduan Pengguna Amazon VPC*.  

![\[Detail dasar dengan aturan masuk dimasukkan.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-no-internet_3.png)


1. Tekan **Buat grup keamanan**.

## Buat titik akhir layanan
<a name="mf-runtime-setup-no-access-endpoints"></a>

Ulangi proses ini tiga kali — sekali untuk setiap layanan.

1. **Arahkan ke Amazon VPC di Konsol Manajemen AWS dan pilih Endpoints.**

1. Tekan **Buat titik akhir**.

1. Masukkan nama, misalnya “Micro-focus-License-EC2", “Micro-focus-License-sts”, atau “Micro-Focus-License-Manager”.

1. Pilih Kategori **Layanan AWS Services**.  
![\[Pengaturan titik akhir dengan AWS layanan yang dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-no-internet_4.png)

1. Di bawah Layanan, cari layanan Antarmuka yang cocok yang merupakan salah satu dari:
   + “com.amazonaws. *region*.ec2”
   + “com.amazonaws. *region*.sts”
   + “com.amazonaws. *region*.license-manager”

   Contoh:
   + “com.amazonaws.us-west-1.ec2"
   + “com.amazonaws.us-west-1.sts”
   + “com.amazonaws.us-west-1.license-manager”

1. Pilih layanan Antarmuka yang cocok.

   **com.amazonaws. *region*.ec2**:  
![\[Layanan dengan layanan antarmuka Amazon EC2 dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-no-internet_5.png)

   **com.amazonaws. *region*.sts**:  
![\[Layanan dengan layanan AWS STS antarmuka dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-no-internet_6.png)

   **com.amazonaws. *region*.license-manager**:  
![\[Layanan dengan layanan antarmuka License Manager dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-no-internet_7.png)

1. Untuk VPC pilih VPC untuk instance.  
![\[VPC dengan VPC untuk instance yang dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-no-internet_8.png)

1. Pilih **Availability Zone** dan **Subnet** untuk VPC.  
![\[Subnet dengan zona ketersediaan dan subnet untuk VPC yang dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-no-internet_9.png)

1. Pilih Grup Keamanan yang dibuat sebelumnya.  
![\[Grup keamanan dengan grup keamanan dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-no-internet_10.png)

1. Di bawah Kebijakan pilih **Akses Penuh**.  
![\[Kebijakan dengan Akses Penuh dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/mf-no-internet_11.png)

1. Pilih **Buat Titik Akhir**.

1. Ulangi proses ini untuk antarmuka yang tersisa.

# Mengatur Otomasi untuk Rocket Enterprise Analyzer (sebelumnya Micro Focus) dan Sesi Streaming Pengembang Rocket Enterprise
<a name="set-up-automation-m2"></a>

Anda dapat secara otomatis menjalankan skrip pada awal dan akhir sesi untuk memungkinkan otomatisasi yang spesifik untuk konteks pelanggan Anda. Untuk informasi selengkapnya tentang fitur WorkSpaces Aplikasi ini, lihat [Menggunakan Skrip Sesi untuk Mengelola Pengalaman Streaming Pengguna AppStream 2.0 Anda](https://docs.aws.amazon.com/appstream2/latest/developerguide/use-session-scripts.html) di Panduan *Administrasi WorkSpaces Aplikasi Amazon*.

Fitur ini mengharuskan Anda memiliki setidaknya versi gambar Enterprise Analyzer dan Enterprise Developer berikut:
+ `m2-enterprise-analyzer-v8.0.4.R1`
+ `m2-enterprise-developer-v8.0.4.R1`

**Topics**
+ [Siapkan otomatisasi saat sesi dimulai](#set-up-automation-m2.start)
+ [Siapkan otomatisasi di akhir sesi](#set-up-automation-m2.end)

## Siapkan otomatisasi saat sesi dimulai
<a name="set-up-automation-m2.start"></a>

Jika Anda ingin menjalankan skrip otomatisasi saat pengguna terhubung ke WorkSpaces Aplikasi, buat skrip Anda dan beri nama`m2-user-setup.cmd`. Simpan skrip di folder WorkSpaces Applications Home untuk pengguna. Gambar WorkSpaces Aplikasi yang disediakan oleh Modernisasi AWS Mainframe mencari skrip dengan nama itu di lokasi itu, dan menjalankannya jika ada.

**catatan**  
Durasi skrip tidak dapat melebihi batas yang ditetapkan oleh WorkSpaces Aplikasi, yang saat ini 60 detik. Untuk informasi selengkapnya, lihat [Menjalankan Skrip Sebelum Sesi Streaming Dimulai](https://docs.aws.amazon.com/appstream2/latest/developerguide/use-session-scripts.html#run-scripts-before-streaming-sessions-begin) di *Panduan Administrasi WorkSpaces Aplikasi Amazon*.

## Siapkan otomatisasi di akhir sesi
<a name="set-up-automation-m2.end"></a>

Jika Anda ingin menjalankan skrip otomatisasi saat pengguna memutuskan sambungan dari WorkSpaces Aplikasi, buat skrip Anda dan beri nama. `m2-user-teardown.cmd` Simpan skrip di folder WorkSpaces Applications Home untuk pengguna. Gambar WorkSpaces Aplikasi yang disediakan oleh Modernisasi AWS Mainframe mencari skrip dengan nama itu di lokasi itu, dan menjalankannya jika ada.

**catatan**  
Durasi skrip tidak dapat melebihi batas yang ditetapkan oleh WorkSpaces Aplikasi, yang saat ini 60 detik. Untuk informasi selengkapnya, lihat [Menjalankan Skrip Setelah Sesi Streaming Berakhir](https://docs.aws.amazon.com/appstream2/latest/developerguide/use-session-scripts.html#run-scripts-after-streaming-sessions-end) di *Panduan Administrasi WorkSpaces Aplikasi Amazon*.

# Lihat kumpulan data sebagai tabel dan kolom di Rocket Enterprise Developer (sebelumnya Micro Focus Enterprise Developer)
<a name="view-datasets-tables-m2"></a>

Anda dapat mengakses kumpulan data mainframe yang digunakan dalam Modernisasi AWS Mainframe menggunakan runtime Perangkat Lunak Rocket (sebelumnya Micro Focus). Anda dapat melihat kumpulan data yang dimigrasi sebagai tabel dan kolom dari instance Pengembang Rocket Enterprise. Melihat kumpulan data dengan cara ini memungkinkan Anda untuk: 
+ Lakukan `SQL SELECT` operasi pada file data yang dimigrasi.
+ Paparkan data di luar aplikasi mainframe yang dimigrasi tanpa mengubah aplikasi.
+ Mudah memfilter data dan menyimpan sebagai CSV atau format file lainnya.

**catatan**  
Langkah 1 dan 2 adalah kegiatan satu kali. Ulangi langkah 3 dan 4 untuk setiap kumpulan data untuk membuat tampilan database.

**Topics**
+ [Prasyarat](#view-datasets-tables-m2.prereq)
+ [Langkah 1: Siapkan Koneksi ODBC ke Datastore Perangkat Lunak Roket (database Amazon RDS)](#view-datasets-tables-m2.odbc)
+ [Langkah 2: Buat file MFDBFH.cfg](#view-datasets-tables-m2.config)
+ [Langkah 3: Buat file struktur (STR) untuk tata letak copybook Anda](#view-datasets-tables-m2.str)
+ [Langkah 4: Buat tampilan database menggunakan file struktur (STR)](#view-datasets-tables-m2.dbview)
+ [Langkah 5: Lihat kumpulan data Rocket Software (sebelumnya Micro Focus) sebagai tabel dan kolom](#view-datasets-tables-m2.cols)

## Prasyarat
<a name="view-datasets-tables-m2.prereq"></a>
+ Anda harus memiliki akses ke Rocket Enterprise Developer Desktop melalui WorkSpaces Aplikasi.
+ Anda harus memiliki aplikasi yang digunakan dan berjalan di bawah Modernisasi AWS Mainframe menggunakan mesin runtime Rocket Software.
+ Anda menyimpan data aplikasi Anda di Aurora PostgreSQL Edisi yang kompatibel.

## Langkah 1: Siapkan Koneksi ODBC ke Datastore Perangkat Lunak Roket (database Amazon RDS)
<a name="view-datasets-tables-m2.odbc"></a>

Pada langkah ini, Anda mengatur koneksi ODBC ke database yang berisi data yang ingin Anda lihat sebagai tabel dan kolom. Ini adalah langkah satu kali saja.

1. Masuk ke Desktop Pengembang Rocket Enterprise menggunakan URL streaming WorkSpaces Aplikasi.

1. **Buka **Administrator Sumber Data ODBC**, pilih **DSN Pengguna** dan kemudian pilih Tambah.**

1. **Di **Create New Data Source**, pilih **PostgreSQL ANSI dan kemudian** pilih Finish.**

1. Buat sumber data `PG.POSTGRES` dengan menyediakan informasi database yang diperlukan, sebagai berikut:

   ```
   Data Source : PG.POSTGRES
   Database    : postgres
   Server      : rds_endpoint.rds.amazonaws.com
   Port        : 5432
   User Name   : user_name
   Password    : user_password
   ```  
![\[Menyiapkan koneksi Postgres ODBC di Enterprise Developer.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/view-data-tables-odbc.png)

1. Pilih **Uji** untuk memastikan koneksi berfungsi. Anda akan melihat pesan `Connection successful` jika tes berhasil.

   Jika tes tidak berhasil, tinjau informasi berikut.
   + [Pemecahan masalah untuk Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Troubleshooting.html)
   + [Bagaimana cara mengatasi masalah saat menghubungkan ke instans Amazon RDS DB saya?](https://repost.aws/knowledge-center/rds-cannot-connect)

1. Simpan sumber data.

1. Buat sumber data untuk`PG.VSAM`, uji koneksi, dan simpan sumber data. Berikan informasi database berikut:

   ```
   Data Source : PG.VSAM
   Database    : MicroFocus$SEE$Files$VSAM
   Server      : rds_endpoint.rds.amazonaws.com
   Port        : 5432
   User Name   : user_name
   Password    : user_password
   ```  
![\[Menyiapkan sumber data PG.VSAM ODBC di Enterprise Developer.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/view-data-tables-pg-vsam.png)

## Langkah 2: Buat file MFDBFH.cfg
<a name="view-datasets-tables-m2.config"></a>

Pada langkah ini, Anda membuat file konfigurasi yang menjelaskan penyimpanan data Micro Focus. Ini adalah langkah konfigurasi satu kali saja.

1. Di Folder Beranda Anda, misalnya`D:\PhotonUser\My Files\Home Folder\MFED\cfg\MFDBFH.cfg`, di, buat file MFDBFH.cfg dengan konten berikut.

   ```
   <datastores>
          <server name="ESPACDatabase" type="postgresql" access="odbc">
           <dsn name="PG.POSTGRES" type="database" dbname="postgres"/>
           <dsn name="PG.VSAM" type="datastore" dsname="VSAM"/>
          </server>
         </datastores>
   ```

1. Verifikasi konfigurasi MFDBFH dengan menjalankan perintah berikut untuk menanyakan datastore Micro Focus:

   ```
   *##*
   *## Test the connection by running the following commands*
   *##*
         
   set MFDBFH_CONFIG="D:\PhotonUser\My Files\Home Folder\MFED\cfg\MFDBFH.cfg"
         
   dbfhdeploy list sql://ESPACDatabase/VSAM?folder=/DATA
   ```

## Langkah 3: Buat file struktur (STR) untuk tata letak copybook Anda
<a name="view-datasets-tables-m2.str"></a>

Pada langkah ini, Anda membuat file struktur untuk tata letak copybook Anda sehingga Anda dapat menggunakannya nanti untuk membuat tampilan database dari kumpulan data.

1. Kompilasi program yang terkait dengan copybook Anda. Jika tidak ada program yang menggunakan copybook, buat dan kompilasi program sederhana seperti berikut ini dengan pernyataan COPY untuk copybook Anda.

   ```
   IDENTIFICATION DIVISION.
         PROGRAM-ID. TESTPGM1.
         
         ENVIRONMENT DIVISION.
         CONFIGURATION SECTION.
         
         DATA DIVISION.
         WORKING-STORAGE SECTION.
         
         COPY CVTRA05Y.
         
         PROCEDURE DIVISION.
         
         GOBACK.
   ```

1. Setelah kompilasi berhasil, klik kanan pada program dan pilih **Create Record Layout File**. Ini akan membuka Alat File Data Fokus Mikro menggunakan file.idy yang dihasilkan selama kompilasi.  
![\[Lokasi perintah Create Record Layout File di Enterprise Developer.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/view-data-tables-idy-file.png)

1. Klik kanan pada struktur Rekam dan pilih **Buat Tata Letak Default** (struktur tunggal) atau **Buat Tata Letak Bersyarat** (multi struktur) tergantung pada tata letaknya.

   Untuk informasi selengkapnya, lihat [Membuat File Struktur dan Tata Letak](https://www.microfocus.com/documentation/enterprise-developer/ed60/ES-WIN/GUID-6EDDA4C3-F09E-4CEC-9CF8-281D9D7453C3.html) dalam dokumentasi Fokus Mikro.  
![\[Lokasi perintah tata letak di alat file data Micro Focus.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/view-data-tables-mf-data-file-tools.png)

1. Setelah membuat tata letak, pilih **File** dari menu dan kemudian pilih **Save As**. Jelajahi dan simpan file di bawah Folder Beranda Anda dengan nama file yang sama dengan buku salinan Anda. Anda dapat memilih untuk membuat folder bernama `str` dan menyimpan semua file struktur Anda di sana.  
![\[Menyimpan file str di Enterprise Developer.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/view-data-tables-save-str.png)

## Langkah 4: Buat tampilan database menggunakan file struktur (STR)
<a name="view-datasets-tables-m2.dbview"></a>

Pada langkah ini, Anda menggunakan file struktur yang dibuat sebelumnya untuk membuat tampilan database untuk kumpulan data.
+ Gunakan `dbfhview` perintah untuk membuat tampilan database untuk kumpulan data yang sudah ada di Datastore Micro Focus seperti yang ditunjukkan pada contoh berikut.

  ```
  ##
        ## The below command creates database view for VSAM file AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS 
        ## using the STR file CVTRA05Y.str
        ##
        
        dbfhview -create -struct:"D:\PhotonUser\My Files\Home Folder\MFED\str\CVTRA05Y.str" -name:V_AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS.DAT -file:sql://ESPACDatabase/VSAM/AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS.DAT?folder=/DATA
        
        ##
        ## Output:
        ##
        
        Micro Focus Database File Handler - View Generation Tool Version 8.0.00
        Copyright (C) 1984-2022 Micro Focus. All rights reserved.
        
        VGN0017I Using structure definition 'TRAN-RECORD-DEFAULT'
        VGN0022I View 'V_AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS.DAT' installed in datastore 'sql://espacdatabase/VSAM'
        VGN0002I The operation completed successfully
  ```

## Langkah 5: Lihat kumpulan data Rocket Software (sebelumnya Micro Focus) sebagai tabel dan kolom
<a name="view-datasets-tables-m2.cols"></a>

Pada langkah ini, sambungkan ke database menggunakan `pgAdmin` sehingga Anda dapat menjalankan kueri untuk melihat kumpulan data seperti tabel dan kolom.
+ Connect ke database `MicroFocus$SEE$Files$VSAM` menggunakan pgAdmin dan kueri tampilan database yang Anda buat di langkah 4.

  ```
  SELECT * FROM public."V_AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS.DAT";
  ```  
![\[Kumpulan data yang dimigrasi menampilkan tabel dan kolom di pgAdmin.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/view-data-tables-new-view-pgadmin.png)

# Edit kumpulan data menggunakan Perangkat Lunak Roket (sebelumnya Fokus Mikro) Alat File Data di Pengembang Perusahaan
<a name="edit-datasets-m2"></a>

Anda dapat melihat dan mengedit kumpulan data dalam Modernisasi AWS Mainframe menggunakan runtime Perangkat Lunak Roket untuk kumpulan data yang dimigrasi.  Langkah-langkah dalam dokumen ini akan memandu Anda melalui proses mengakses kumpulan data menggunakan Alat File Data.  Ini memungkinkan Anda untuk melihat dan mengedit kumpulan data yang dimigrasi sesuai kebutuhan. 

**Topics**
+ [Prasyarat](#edit-datasets-m2.prereq)
+ [Luncurkan Perangkat Lunak Roket (sebelumnya Fokus Mikro) Alat File Data](#edit-datasets-m2-launch)
+ [Edit kumpulan data VSAM yang disimpan dalam database MFDBFH](#edit-datasets-m2-vsam)
+ [Edit kumpulan data non-VSAM yang disimpan dalam database MFDBFH](#edit-datasets-m2-nonvsam)
+ [Edit kumpulan data VSAM dan non-VSAM yang disimpan dalam Sistem File (EFS/FSx)](#edit-datasets-m2-open)

## Prasyarat
<a name="edit-datasets-m2.prereq"></a>

Sebelum memulai, Anda harus memiliki aplikasi yang disebarkan dengan kumpulan data diimpor di bawah layanan Modernisasi AWS Mainframe menggunakan mesin Perangkat Lunak Roket.

Untuk melanjutkan pengeditan kumpulan data, Anda harus menyelesaikan Langkah 1, Langkah 2, dan (opsional) Langkah 3 dari halaman [Lihat kumpulan data sebagai tabel dan kolom di Rocket Enterprise Developer (sebelumnya Micro Focus Enterprise Developer)](view-datasets-tables-m2.md) untuk mengkonfigurasi koneksi ODBC, dan Micro Focus datastore (yaitu,). `MFDBFH`

**penting**  
Panduan ini mengasumsikan bahwa Anda menggunakan Amazon Aurora Postgres sebagai Datastore Micro Focus () `MFDBFH` untuk menyimpan data aplikasi Anda.

## Luncurkan Perangkat Lunak Roket (sebelumnya Fokus Mikro) Alat File Data
<a name="edit-datasets-m2-launch"></a>

Setelah menyelesaikan prasyarat, Anda meluncurkan Alat File Data Fokus Mikro dengan mengatur variabel `MFDBFH_CONFIG` lingkungan untuk mengakses kumpulan data yang disimpan dalam database (). `MFDBFH` 

Untuk melakukan ini,

1. Masuk ke desktop Micro Focus Enterprise Developer, dan luncurkan **command prompt Enterprise Developer (64-bit)** dari **Start Menu**.

1. Atur variabel `MFDBFH_CONFIG` lingkungan dengan path lengkap ke `MFDBCH.cfg` file Anda.

   ```
   set MFDBFH_CONFIG="C:\MicroFocus\config\MFDBFH.cfg"
   ```

1. Luncurkan Alat File Data Fokus Mikro dari baris perintah Pengembang Perusahaan menggunakan perintah berikut.

   ```
   mfdatatools2
   ```  
![\[Prompt Perintah Pengembang Perusahaan.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/edit-mfdbfh-launch.png)

Ini membuka Alat File Data Fokus Mikro di jendela terpisah.

## Edit kumpulan data VSAM yang disimpan dalam database MFDBFH
<a name="edit-datasets-m2-vsam"></a>

Setelah Anda meluncurkan Alat File Data Fokus Mikro, Anda membuka kumpulan data VSAM yang disimpan di datastore Micro Focus.

Untuk melakukan ini,

1. Dari **menu File** di jendela Alat File Data Fokus Mikro, pilih **Data Explorer**.

1. Di bagian Data Explorer, pilih **Pengaturan** (ikon roda gigi) untuk mengonfigurasi koneksi baru. Ini membuka jendela **Pengaturan Sumber Data**.  
![\[Jendela Alat File Data Fokus Mikro dengan bagian Data Explorer.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/edit-mfdbfh-data-source.png)

1. Di jendela Pengaturan Sumber Data, pilih tab **MFDBFH**, dan masukkan nilai berikut:
   + Server: `ESPACDatabase`
   + Datastore: `VSAM`

   Pilih **Terapkan** untuk menyimpan konfigurasi.  
![\[Jendela Alat File Data Fokus Mikro Pengaturan Sumber Data dengan tab MFDBFH.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/edit-mfdbfh-data-source-settings.png)

    Data Explorer sekarang menampilkan semua kumpulan data yang disimpan di dalamnya`MFDBFH`.  
![\[Jendela Alat File Data Fokus Mikro dengan bagian Data Explorer yang menampilkan semua kumpulan data.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/edit-mfdbfh-datasets.png)

1. Perluas jalur relatif `DATA` dan klik dua kali pada kumpulan data VSAM yang ingin Anda buka. 

1. Di jendela **Buka File Data**, pilih **Buka Bersama** atau **Buka Eksklusif** untuk membuka kumpulan data.  
![\[Jendela Alat File Data Fokus Mikro dengan bagian Data Explorer Buka bagian File Data untuk membuka set data..\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/edit-mfdbfh-data-set.png)

Anda sekarang dapat melihat atau mengedit kumpulan data terbuka.

## Edit kumpulan data non-VSAM yang disimpan dalam database MFDBFH
<a name="edit-datasets-m2-nonvsam"></a>

Jika Anda ingin mengedit kumpulan data non-VSAM, Anda membuka kumpulan data non-VSAM yang disimpan di datastore Micro Focus.

Untuk melakukan ini,

1. Dari prompt perintah Pengembang Perusahaan (64-bit) jalankan `dbfhdeploy data extract` perintah untuk mengunduh kumpulan data non-VSAM ke sistem file lokal Anda. 
**catatan**  
Sebelum menjalankan perintah ini, pastikan Anda telah mengatur variabel `MFDBFH_CONFIG` lingkungan dengan path lengkap ke `MFDBFH.cfg` file Anda.  

   ```
   dbfhdeploy data extract sql://ESPACDatabase/VSAM/AWS.M2.CARDDEMO.TRANSACT.BKUP.G0001V00.DAT?folder=/DATA C:\MicroFocus\data\AWS.M2.CARDDEMO.TRANSACT.BKUP.G0001V00.DAT
   ```

1. Luncurkan Alat File Data Fokus Mikro dari **Menu Mulai**.

1. Dari Menu File Alat File Data Fokus Mikro, pilih **Buka**, lalu pilih **File Data**.

1. Di jendela Open Data File, telusuri kumpulan data yang diunduh di sistem file lokal Anda. Edit **Detail File** sesuai kebutuhan. Kemudian pilih **Buka Bersama** atau **Buka Eksklusif** untuk membuka kumpulan data.  
![\[Buka jendela File Data dengan tab lokal yang dipilih untuk menjelajahi kumpulan data.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/edit-mfdbfh-browse.png)

Anda sekarang dapat melihat atau mengedit kumpulan data terbuka.

Kumpulan data yang diedit atau diperbarui dapat diimpor kembali ke datastore Micro Focus menggunakan langkah-langkah dalam [Impor set data untuk AWS Mainframe Modernization aplikasi](applications-m2-dataset.md) atau dengan menggunakan Utilitas Baris Perintah [dbfhdeploy](https://www.microfocus.com/documentation/enterprise-developer/ed90/ED-Eclipse/GUID-2A16851F-E475-42C9-B024-37567006B86D.html).

## Edit kumpulan data VSAM dan non-VSAM yang disimpan dalam Sistem File (EFS/FSx)
<a name="edit-datasets-m2-open"></a>

Anda juga dapat membuka kumpulan data yang disimpan dalam sistem file.

Untuk melakukan ini,

1. Pasang sistem EFS/FSx file di instans Enterprise Developer EC2.

1. Gunakan Alat File Data Fokus Mikro untuk menelusuri, dan buka kumpulan data dari sistem file.

# Tutorial untuk Perangkat Lunak Roket (sebelumnya Micro Focus)
<a name="tutorials-mf"></a>

Tutorial di bagian ini membantu Anda memulai dengan menyiapkan berbagai tugas di mesin runtime Rocket Software untuk layanan Modernisasi AWS Mainframe. Tutorial ini adalah untuk menyiapkan aplikasi sampel, menggunakan template dengan Rocket Enterprise Developer, dan menyiapkan Enterprise Analyzer.

**Topics**
+ [Tutorial: Menyiapkan perangkat lunak roket (sebelumnya Micro Focus) build untuk aplikasi sampel BankDemo](tutorial-build-mf.md)
+ [Tutorial: Mengatur WorkSpaces Aplikasi untuk digunakan dengan Rocket Enterprise Analyzer dan Rocket Enterprise Developer](set-up-appstream-mf.md)
+ [Tutorial: Gunakan template dengan Rocket Enterprise Developer (sebelumnya Micro Focus Enterprise Developer)](tutorial-templates-ed.md)
+ [Tutorial: Mengatur Enterprise Analyzer pada Aplikasi WorkSpaces](set-up-ea.md)
+ [Tutorial: Mengatur Pengembang Perusahaan Roket pada WorkSpaces Aplikasi](set-up-ed.md)

# Tutorial: Menyiapkan perangkat lunak roket (sebelumnya Micro Focus) build untuk aplikasi sampel BankDemo
<a name="tutorial-build-mf"></a>

AWS Modernisasi Mainframe memberi Anda kemampuan untuk menyiapkan saluran pipa build dan continuous integration/continuous delivery (CI/CD) untuk aplikasi yang dimigrasi. Build dan pipeline ini menggunakan AWS CodeBuild, AWS CodeCommit, dan AWS CodePipeline untuk menyediakan kemampuan ini. CodeBuild adalah layanan build terkelola penuh yang mengkompilasi kode sumber Anda, menjalankan pengujian unit, dan menghasilkan artefak yang siap digunakan. CodeCommit adalah layanan kontrol versi yang memungkinkan Anda menyimpan dan mengelola reponsitori Git secara pribadi di Cloud. AWS CodePipeline adalah layanan pengiriman berkelanjutan yang memungkinkan Anda untuk memodelkan, memvisualisasikan, dan mengotomatiskan langkah-langkah yang diperlukan untuk merilis perangkat lunak Anda.

Tutorial ini menunjukkan cara menggunakan AWS CodeBuild untuk mengkompilasi BankDemo contoh kode sumber aplikasi dari Amazon S3 dan kemudian mengekspor kode yang dikompilasi kembali ke Amazon S3.

AWS CodeBuild adalah layanan integrasi berkelanjutan yang dikelola sepenuhnya yang mengkompilasi kode sumber, menjalankan pengujian, dan menghasilkan paket perangkat lunak yang siap digunakan. Dengan CodeBuild, Anda dapat menggunakan lingkungan build yang dikemas sebelumnya, atau Anda dapat membuat lingkungan build khusus yang menggunakan alat build Anda sendiri. Skenario demo ini menggunakan opsi kedua. Ini terdiri dari lingkungan CodeBuild build yang menggunakan image Docker pra-paket.

**penting**  
Sebelum Anda memulai proyek modernisasi mainframe Anda, kami sarankan Anda mempelajari tentang [AWS Migration Acceleration Program (MAP) untuk Mainframe atau hubungi spesialis mainframe untuk](https://aws.amazon.com/migration-acceleration-program/mainframe/) [mempelajari tentang langkah-langkah yang diperlukan untuk memodernisasi aplikasi AWS mainframe](mailto: mainframe@amazon.com).

**Topics**
+ [Prasyarat](#tutorial-build-mf-prerequisites)
+ [Langkah 1: Bagikan aset build dengan AWS akun](#tutorial-build-mf-assets)
+ [Langkah 2: Buat ember Amazon S3](#tutorial-build-mf-s3)
+ [Langkah 3: Buat file spesifikasi build](#tutorial-build-mf-spec)
+ [Langkah 4: Unggah file sumber](#tutorial-build-mf-upload)
+ [Langkah 5: Buat kebijakan IAM](#tutorial-build-mf-IAM-policy)
+ [Langkah 6: Buat peran IAM](#tutorial-build-mf-IAM-role)
+ [Langkah 7: Lampirkan kebijakan IAM ke peran IAM](#tutorial-build-mf-attach)
+ [Langkah 8: Buat CodeBuild proyek](#tutorial-build-mf-create-project)
+ [Langkah 9: Mulai membangun](#tutorial-build-mf-start)
+ [Langkah 10: Unduh artefak keluaran](#tutorial-build-mf-download-output)
+ [Pembersihan sumber daya](#tutorial-build-mf-clean)

## Prasyarat
<a name="tutorial-build-mf-prerequisites"></a>

Sebelum Anda memulai tutorial ini, selesaikan prasyarat berikut.
+ Unduh [aplikasi BankDemo sampel](https://d3lkpej5ajcpac.cloudfront.net/demo/mf/BANKDEMO-build.zip) dan unzip ke folder. Folder sumber berisi program COBOL dan Copybook, dan definisi. Ini juga berisi folder JCL untuk referensi, meskipun Anda tidak perlu membangun JCL. Folder ini juga berisi file meta yang diperlukan untuk build.
+ **Di konsol Modernisasi AWS Mainframe, pilih Tools.** Dalam **Analisis, pengembangan, dan pembuatan aset**, pilih **Bagikan aset dengan akun AWS saya**.

## Langkah 1: Bagikan aset build dengan AWS akun
<a name="tutorial-build-mf-assets"></a>

Pada langkah ini, Anda memastikan bahwa Anda berbagi aset build dengan AWS akun Anda, terutama di Wilayah tempat aset digunakan.

1. Buka konsol Modernisasi AWS Mainframe di. [https://console.aws.amazon.com/m2/](https://us-west-2.console.aws.amazon.com/m2/home?region=us-west-2#/)

1. Di navigasi kiri, pilih **Tools**.

1. Dalam **Analisis, pengembangan, dan bangun aset**, pilih **Bagikan aset dengan AWS akun saya**.

**penting**  
Anda perlu melakukan langkah ini sekali di setiap AWS Wilayah di mana Anda ingin melakukan pembangunan.

## Langkah 2: Buat ember Amazon S3
<a name="tutorial-build-mf-s3"></a>

Pada langkah ini, Anda membuat dua ember Amazon S3. Yang pertama adalah bucket input untuk menahan kode sumber, dan yang lainnya adalah bucket keluaran untuk menampung output build. Untuk informasi selengkapnya, lihat [Membuat, mengonfigurasi, dan bekerja dengan bucket Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html) di Panduan Pengguna Amazon *S3*.

1. Untuk membuat bucket input, masuk ke konsol Amazon S3 dan pilih **Buat** bucket.

1. Dalam **konfigurasi Umum**, berikan nama untuk bucket dan tentukan Wilayah AWS tempat Anda ingin membuat bucket. Contoh nama adalah`codebuild-regionId-accountId-input-bucket`, di mana `regionId` ember, dan `accountId` Akun AWS ID Anda. Wilayah AWS 
**catatan**  
Jika Anda membuat bucket berbeda Wilayah AWS dari US East (Virginia N.), tentukan `LocationConstraint` parameternya. Untuk informasi selengkapnya, lihat [Membuat Bucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html) di *Referensi API Amazon Simple Storage Service*.

1. Pertahankan semua pengaturan lainnya dan pilih **Buat ember**.

1. Ulangi langkah 1-3 untuk membuat bucket keluaran. Contoh nama adalah`codebuild-regionId-accountId-output-bucket`, di mana `regionId` ember dan `accountId` Akun AWS ID Anda. Wilayah AWS 

   Apa pun nama yang Anda pilih untuk ember ini, pastikan untuk menggunakannya di seluruh tutorial ini.

## Langkah 3: Buat file spesifikasi build
<a name="tutorial-build-mf-spec"></a>

Pada langkah ini, Anda membuat file spesifikasi build,. File ini menyediakan perintah build dan pengaturan terkait, dalam format YAMAL, CodeBuild untuk menjalankan build. Untuk informasi selengkapnya, lihat [Membangun referensi spesifikasi untuk CodeBuild](https://docs.aws.amazon.com/codebuild/latest/userguide/build-spec-ref.html) di *Panduan AWS CodeBuild Pengguna*.

1. Buat file bernama `buildspec.yml` di direktori yang Anda buka ritsletingnya sebagai prasyarat.

1. Tambahkan konten berikut ke file dan simpan. Tidak ada perubahan yang diperlukan untuk file ini.

   ```
   version: 0.2
   env:
     exported-variables:
       - CODEBUILD_BUILD_ID
       - CODEBUILD_BUILD_ARN
   phases:
     install:
       runtime-versions:
         python: 3.7
     pre_build:
       commands:
         - echo Installing source dependencies...
         - ls -lR $CODEBUILD_SRC_DIR/source
     build:
       commands:
         - echo Build started on `date`
         - /start-build.sh -Dbasedir=$CODEBUILD_SRC_DIR/source -Dloaddir=$CODEBUILD_SRC_DIR/target 
     post_build:
       commands:
         - ls -lR $CODEBUILD_SRC_DIR/target
         - echo Build completed on `date`
   artifacts:
     files:
       - $CODEBUILD_SRC_DIR/target/**
   ```

   Di sini`CODEBUILD_BUILD_ID`,`CODEBUILD_BUILD_ARN`,`$CODEBUILD_SRC_DIR/source`, dan `$CODEBUILD_SRC_DIR/target` merupakan variabel lingkungan yang tersedia di dalamnya CodeBuild. Untuk informasi selengkapnya, lihat [Variabel lingkungan di lingkungan build](https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-env-vars.html).

   Pada titik ini, direktori Anda akan terlihat seperti ini.

   ```
   (root directory name)
       |-- build.xml
       |-- buildspec.yml
       |-- LICENSE.txt
       |-- source
            |... etc.
   ```

1. Zip isi folder ke file bernama`BankDemo.zip`.. Untuk tutorial ini, Anda tidak dapat zip folder. Sebagai gantinya, zip isi folder ke file`BankDemo.zip`.

## Langkah 4: Unggah file sumber
<a name="tutorial-build-mf-upload"></a>

Pada langkah ini, Anda mengunggah kode sumber untuk aplikasi BankDemo sampel ke bucket input Amazon S3 Anda.

1. Masuk ke konsol Amazon S3 dan pilih **Bucket di panel** navigasi kiri. Kemudian pilih bucket input yang Anda buat sebelumnya.

1. Di bawah **Objek**, pilih **Unggah**.

1. Di bagian **File dan folder**, pilih **Tambahkan File**.

1. Arahkan ke dan pilih `BankDemo.zip` file Anda.

1. Pilih **Unggah**.

## Langkah 5: Buat kebijakan IAM
<a name="tutorial-build-mf-IAM-policy"></a>

Pada langkah ini, Anda membuat dua [kebijakan IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html). Satu kebijakan memberikan izin untuk Modernisasi AWS Mainframe untuk mengakses dan menggunakan gambar Docker yang berisi alat pembuatan Perangkat Lunak Rocket. Kebijakan ini tidak disesuaikan untuk pelanggan. [Kebijakan lainnya memberikan izin untuk Modernisasi AWS Mainframe untuk berinteraksi dengan bucket input dan output, dan dengan log Amazon yang menghasilkan. CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/WhatIsCloudWatchLogs.html) CodeBuild 

Untuk mempelajari cara membuat kebijakan IAM, lihat [Mengedit kebijakan IAM di Panduan](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) Pengguna *IAM*.

**Untuk membuat kebijakan untuk mengakses gambar Docker**

1. Di konsol IAM, salin dokumen kebijakan berikut dan tempelkan ke editor kebijakan.

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
                   "ecr:GetAuthorizationToken"
               ],
               "Resource": "*"
           },
           {
               "Effect": "Allow",
               "Action": [
                   "ecr:BatchCheckLayerAvailability",
                   "ecr:GetDownloadUrlForLayer",
                   "ecr:BatchGetImage"
               ],
               "Resource": "arn:aws:ecr:*:673918848628:repository/m2-enterprise-build-tools"
           },
           {
               "Effect": "Allow",
               "Action": [
                   "s3:PutObject"
               ],
               "Resource": "arn:aws:s3:::aws-m2-repo-*-<region>-prod"
           }
       ]
   }
   ```

------

1. Berikan nama untuk kebijakan tersebut, misalnya,`m2CodeBuildPolicy`.

**Untuk membuat kebijakan yang memungkinkan Modernisasi AWS Mainframe berinteraksi dengan bucket dan log**

1. Di konsol IAM, salin dokumen kebijakan berikut dan tempelkan ke editor kebijakan. Pastikan untuk memperbarui `regionId` ke Wilayah AWS, dan `accountId` ke Anda Akun AWS.

1. Berikan nama untuk kebijakan tersebut, misalnya,`BankdemoCodeBuildRolePolicy`.

## Langkah 6: Buat peran IAM
<a name="tutorial-build-mf-IAM-role"></a>

Pada langkah ini, Anda membuat [peran IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) baru yang memungkinkan CodeBuild untuk berinteraksi dengan AWS sumber daya untuk Anda, setelah Anda mengaitkan kebijakan IAM yang sebelumnya Anda buat dengan peran IAM baru ini.

Untuk informasi tentang membuat peran layanan, lihat [Membuat Peran untuk Mendelegasikan Izin ke AWS Layanan](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html) di *Panduan Pengguna IAM*,.

1. Masuk ke konsol IAM dan pilih **Peran** di panel navigasi kiri.

1. Pilih **Buat peran**.

1. Di bawah **Jenis entitas Tepercaya**, pilih **layanan AWS**.

1. Di bawah **Kasus penggunaan untuk layanan AWS lainnya **CodeBuild****, pilih, lalu pilih **CodeBuild**lagi.

1. Pilih **Berikutnya**.

1. Pada halaman **Tambahkan izin**, pilih **Berikutnya**. Anda menetapkan kebijakan untuk peran nanti.

1. Di bawah **Rincian peran**, berikan nama untuk peran tersebut, misalnya,`BankdemoCodeBuildServiceRole`.

1. Di bawah **Pilih entitas tepercaya**, verifikasi bahwa dokumen kebijakan terlihat seperti berikut:

------
#### [ JSON ]

****  

   ```
   {
             "Version":"2012-10-17",		 	 	 
             "Statement": [
               {
                 "Effect": "Allow",
                 "Principal": {
                   "Service": "codebuild.amazonaws.com"
                 },
                 "Action": "sts:AssumeRole"
               }
             ]
           }
   ```

------

1. Pilih **Buat peran**.

## Langkah 7: Lampirkan kebijakan IAM ke peran IAM
<a name="tutorial-build-mf-attach"></a>

Pada langkah ini, Anda melampirkan dua kebijakan IAM yang sebelumnya Anda buat ke peran `BankdemoCodeBuildServiceRole` IAM.

1. Masuk ke konsol IAM dan pilih **Peran** di panel navigasi kiri.

1. Di **Peran**, pilih peran yang Anda buat sebelumnya, misalnya,`BankdemoCodeBuildServiceRole`.

1. Di **kebijakan Izin**, pilih **Tambahkan izin**, lalu **Lampirkan** kebijakan.

1. Dalam **kebijakan izin lainnya**, pilih kebijakan yang Anda buat sebelumnya, misalnya, `m2CodeBuildPolicy` dan`BankdemoCodeBuildRolePolicy`.

1. Pilih **Lampirkan kebijakan**.

## Langkah 8: Buat CodeBuild proyek
<a name="tutorial-build-mf-create-project"></a>

Pada langkah ini, Anda membuat CodeBuild proyek.

1. Masuk ke CodeBuild konsol dan pilih **Buat proyek build**.

1. Di bagian **konfigurasi Proyek**, berikan nama untuk proyek, misalnya,`codebuild-bankdemo-project`.

1. Di bagian **Sumber**, untuk **penyedia Sumber**, pilih **Amazon S3**, lalu pilih bucket input yang Anda buat sebelumnya, misalnya,. `codebuild-regionId-accountId-input-bucket`

1. Di bidang **kunci objek S3 atau folder S3**, masukkan nama file zip yang Anda unggah ke bucket S3. Dalam hal ini, nama file adalah`bankdemo.zip`.

1. Di bagian **Lingkungan**, pilih **Gambar kustom**.

1. Di bidang **Environment type**, pilih **Linux**.

1. Di bawah **Registri gambar**, pilih **Registri lain**.

1. Di bidang **URL registri eksternal**, 
   + Untuk Perangkat Lunak Roket v9: Enter`673918848628.dkr.ecr.us-west-1.amazonaws.com/m2-enterprise-build-tools:9.0.7.R1`. Jika Anda menggunakan AWS Wilayah yang berbeda dengan Rocket Software v9, Anda juga dapat menentukan` 673918848628.dkr.ecr.<m2-region>.amazonaws.com/m2-enterprise-build-tools:9.0.7.R1`, di mana <m2-region>adalah AWS Wilayah di mana layanan Modernisasi AWS Mainframe tersedia (misalnya,). `eu-west-3`
   + Untuk Perangkat Lunak Roket v8: Enter `673918848628.dkr.ecr.us-west-2.amazonaws.com/m2-enterprise-build-tools:8.0.9.R1`
   + Untuk Perangkat Lunak Roket v7: Enter `673918848628.dkr.ecr.us-west-2.amazonaws.com/m2-enterprise-build-tools:7.0.R10`

1. Di bawah **Peran layanan**, pilih **Peran layanan yang ada**, dan di bidang **ARN Peran**, pilih peran layanan yang Anda buat sebelumnya; misalnya,. `BankdemoCodeBuildServiceRole`

1. Di bagian **Buildspec**, pilih **Gunakan** file buildspec.

1. Di bagian **Artefak**, di bawah **Jenis**, pilih **Amazon** S3, lalu pilih bucket keluaran Anda, misalnya,. `codebuild-regionId-accountId-output-bucket`

1. Di bidang **Nama**, masukkan nama folder di bucket yang ingin berisi artefak keluaran build, misalnya,`bankdemo-output.zip`.

1. Di bawah **kemasan Artefak**, pilih **Zip**.

1. Pilih **Buat proyek build**.

## Langkah 9: Mulai membangun
<a name="tutorial-build-mf-start"></a>

Pada langkah ini, Anda memulai build.

1. Masuk ke CodeBuild konsol.

1. Di panel navigasi kiri, pilih **Membangun proyek**.

1. Pilih proyek build yang Anda buat sebelumnya, misalnya,`codebuild-bankdemo-project`.

1. Pilih **Mulai membangun**.

Perintah ini memulai build. Build berjalan secara asinkron. Output dari perintah adalah JSON yang menyertakan id atribut. Atribut ini adalah referensi ke id CodeBuild build build yang baru saja Anda mulai. Anda dapat melihat status build di CodeBuild konsol. Anda juga dapat melihat log terperinci tentang eksekusi build di konsol. Untuk informasi selengkapnya, [lihat Melihat informasi build terperinci](https://docs.aws.amazon.com/codebuild/latest/userguide/getting-started-build-log-console.html) di *Panduan AWS CodeBuild Pengguna*.

Ketika fase saat ini SELESAI, itu berarti build Anda berhasil diselesaikan, dan artefak yang dikompilasi sudah siap di Amazon S3.

## Langkah 10: Unduh artefak keluaran
<a name="tutorial-build-mf-download-output"></a>

Pada langkah ini, Anda mengunduh artefak keluaran dari Amazon S3. Alat pembuatan Perangkat Lunak Rocket dapat membuat beberapa jenis yang dapat dieksekusi yang berbeda. Dalam tutorial ini, ini menghasilkan objek bersama.

1. Masuk ke konsol Amazon S3.

1. Di bagian **Bucket** role="bold">, pilih nama bucket keluaran Anda, misalnya,. `codebuild-regionId-accountId-output-bucket`

1. Pilih **Download** role="bold">.

1. Unzip file yang diunduh. Arahkan ke folder target untuk melihat artefak build. Ini termasuk objek bersama `.so` Linux.

## Pembersihan sumber daya
<a name="tutorial-build-mf-clean"></a>

Jika Anda tidak lagi membutuhkan sumber daya yang Anda buat untuk tutorial ini, hapus untuk menghindari biaya tambahan. Untuk melakukannya, selesaikan langkah-langkah berikut:
+ Hapus bucket S3 yang Anda buat untuk tutorial ini. Untuk informasi selengkapnya, lihat [Menghapus bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/delete-bucket.html) di *Panduan Pengguna Layanan Penyimpanan Sederhana Amazon*.
+ Hapus kebijakan IAM yang Anda buat untuk tutorial ini. Untuk informasi selengkapnya, lihat [Menghapus kebijakan IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-delete.html) di Panduan Pengguna *IAM*.
+ Hapus peran IAM yang Anda buat untuk tutorial ini. Untuk informasi lebih lanjut, lihat [Menghapus peran atau profil instans](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_delete.html) dalam *Panduan Pengguna IAM*.
+ Hapus CodeBuild proyek yang Anda buat untuk tutorial ini. Untuk informasi selengkapnya, lihat [Menghapus proyek build CodeBuild di](https://docs.aws.amazon.com/codebuild/latest/userguide/delete-project.html) *Panduan AWS CodeBuild Pengguna*.

# Tutorial: Mengatur WorkSpaces Aplikasi untuk digunakan dengan Rocket Enterprise Analyzer dan Rocket Enterprise Developer
<a name="set-up-appstream-mf"></a>

AWS Modernisasi Mainframe menyediakan beberapa alat melalui Aplikasi Amazon. WorkSpaces WorkSpaces Aplikasi adalah layanan streaming aplikasi yang dikelola sepenuhnya dan aman yang memungkinkan Anda melakukan streaming aplikasi desktop ke pengguna tanpa menulis ulang aplikasi. WorkSpaces Aplikasi memberi pengguna akses instan ke aplikasi yang mereka butuhkan dengan pengalaman pengguna yang responsif dan lancar pada perangkat pilihan mereka. Menggunakan WorkSpaces Aplikasi untuk meng-host alat khusus mesin runtime memberi tim aplikasi pelanggan kemampuan untuk menggunakan alat langsung dari browser web mereka, berinteraksi dengan file aplikasi yang disimpan di bucket Amazon S3 atau repositori. CodeCommit 

Untuk informasi tentang dukungan browser di WorkSpaces Aplikasi, lihat [Persyaratan Sistem dan Dukungan Fitur (Browser Web)](https://docs.aws.amazon.com/appstream2/latest/developerguide/requirements-and-features-web-browser-admin.html) di *Panduan Administrasi WorkSpaces Aplikasi Amazon*. Jika Anda mengalami masalah saat menggunakan WorkSpaces Aplikasi, lihat [Pemecahan Masalah Pengguna AppStream 2.0](https://docs.aws.amazon.com/appstream2/latest/developerguide/troubleshooting-user-issues.html) di Panduan *Administrasi WorkSpaces Aplikasi Amazon*.

Dokumen ini ditujukan untuk anggota tim operasi pelanggan. Ini menjelaskan cara mengatur armada dan tumpukan WorkSpaces Aplikasi Amazon untuk meng-host alat Rocket Enterprise Analyzer dan Rocket Enterprise Developer yang digunakan dengan AWS Modernisasi Mainframe. Rocket Enterprise Analyzer biasanya digunakan selama fase Penilaian dan Pengembang Perusahaan Roket biasanya digunakan selama fase Migrasi dan Modernisasi pendekatan Modernisasi Mainframe. AWS Jika Anda berencana untuk menggunakan Enterprise Analyzer dan Enterprise Developer, Anda harus membuat armada dan tumpukan terpisah untuk setiap alat. Setiap alat membutuhkan armada dan tumpukan sendiri karena persyaratan lisensi mereka berbeda.

**penting**  
Langkah-langkah dalam tutorial ini didasarkan pada CloudFormation template yang dapat diunduh [cfn-m2-](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) .yml. appstream-fleet-ea-ed 

**Topics**
+ [Prasyarat](#tutorial-aas-prerequisites)
+ [Langkah 1: Dapatkan gambar WorkSpaces Aplikasi](#tutorial-aas-step1)
+ [Langkah 2: Buat tumpukan menggunakan CloudFormation template](#tutorial-aas-step2)
+ [Langkah 3: Buat pengguna di WorkSpaces Aplikasi](#tutorial-aas-step3)
+ [Langkah 4: Masuk ke WorkSpaces Aplikasi](#tutorial-aas-step4)
+ [Langkah 5: Verifikasi ember di Amazon S3 (opsional)](#tutorial-aas-step5)
+ [Langkah selanjutnya](#tutorial-aas-next-steps)
+ [Pembersihan sumber daya](#tutorial-aas-cleanup)

## Prasyarat
<a name="tutorial-aas-prerequisites"></a>
+ Unduh template: [cfn-m2- appstream-fleet-ea-ed](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) .yl.
+ Dapatkan ID VPC default dan grup keamanan Anda. Untuk informasi selengkapnya tentang VPC default, lihat [Default VPCs](https://docs.aws.amazon.com/vpc/latest/userguide/default-vpc.html) di Panduan Pengguna Amazon *VPC*. Untuk informasi selengkapnya tentang grup keamanan default, lihat [Grup keamanan default dan kustom](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/default-custom-security-groups.html) di *Panduan Pengguna Amazon EC2*. 
+ Pastikan Anda memiliki izin berikut:
  + membuat tumpukan, armada, dan pengguna di WorkSpaces Aplikasi.
  + membuat tumpukan dalam CloudFormation menggunakan template.
  + buat bucket dan unggah file ke bucket di Amazon S3.
  + unduh kredensil (`access_key_id`dan`secret_access_key`) dari IAM.

## Langkah 1: Dapatkan gambar WorkSpaces Aplikasi
<a name="tutorial-aas-step1"></a>

Pada langkah ini, Anda membagikan gambar WorkSpaces Aplikasi untuk Enterprise Analyzer dan Enterprise Developer dengan AWS akun Anda.

1. Buka konsol Modernisasi AWS Mainframe di. [https://console.aws.amazon.com/m2/](https://us-west-2.console.aws.amazon.com/m2/home?region=us-west-2#/)

1. Di navigasi kiri, pilih **Tools**.

1. Dalam **Analisis, pengembangan, dan bangun aset**, pilih **Bagikan aset dengan AWS akun saya**.

## Langkah 2: Buat tumpukan menggunakan CloudFormation template
<a name="tutorial-aas-step2"></a>

Pada langkah ini, Anda menggunakan CloudFormation template yang diunduh untuk membuat tumpukan dan armada WorkSpaces Aplikasi untuk menjalankan Rocket Enterprise Analyzer. Anda dapat mengulangi langkah ini nanti untuk membuat tumpukan dan armada WorkSpaces Aplikasi lain untuk menjalankan Pengembang Perusahaan Rocket, karena setiap alat memerlukan armada dan tumpukannya sendiri di WorkSpaces Aplikasi. Untuk informasi selengkapnya tentang CloudFormation tumpukan, lihat [Bekerja dengan tumpukan](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacks.html) di *AWS CloudFormation Panduan Pengguna*.

**catatan**  
AWS Modernisasi Mainframe menambahkan biaya tambahan ke harga WorkSpaces Aplikasi standar untuk penggunaan Enterprise Analyzer dan Enterprise Developer. Untuk informasi selengkapnya, lihat Harga [Modernisasi AWS Mainframe](https://aws.amazon.com/mainframe-modernization/pricing/).

1. Unduh template [cfn-m2- appstream-fleet-ea-ed .yl](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml), jika perlu.

1. Buka CloudFormation konsol dan pilih **Create Stack** dan **dengan sumber daya baru (standar)**.

1. **Dalam **Prasyarat - Siapkan template, pilih Template** sudah siap.**

1. Di **Tentukan Templat**, pilih **Unggah file templat**.

1. Di **Unggah file templat**, pilih **Pilih file** dan unggah templat [cfn-m2- appstream-fleet-ea-ed .yml.](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml)

1. Pilih **Berikutnya**.  
![\[Halaman CloudFormation Buat tumpukan dengan template cfn-m2- appstream-fleet-ea-ed .yml. yang dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/cfn-create-stack.png)

1. Pada **Tentukan detail tumpukan**, masukkan informasi berikut:
   + Dalam **nama Stack**, masukkan nama pilihan Anda. Misalnya, **m2-ea**.
   + Di **AppStreamApplication**, pilih **ea**.
   + Di **AppStreamFleetSecurityGroup**, pilih grup keamanan default VPC default Anda.
   + Di **AppStreamFleetVpcSubnet**, pilih subnet dalam VPC default Anda.
   + Di **AppStreamImageName**, pilih gambar yang dimulai dengan`m2-enterprise-analyzer`. Gambar ini berisi versi alat Rocket Enterprise Analyzer yang saat ini didukung.
   + **Terima default untuk bidang lainnya, lalu pilih Berikutnya.**  
![\[Halaman detail tumpukan yang CloudFormation ditentukan dengan opsi Enterprise Analyzer diisi.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/cfn-specify-stack-details.png)

1. **Terima semua default, lalu pilih Berikutnya lagi.**

1. Pada **Review**, pastikan semua parameter sesuai dengan yang Anda inginkan.

1. Gulir ke bawah, pilih **Saya mengakui bahwa AWS CloudFormation mungkin membuat sumber daya IAM dengan nama khusus**, dan pilih **Buat** Tumpukan.

Dibutuhkan antara 20 dan 30 menit untuk tumpukan dan armada yang akan dibuat. Anda dapat memilih **Refresh** untuk melihat CloudFormation peristiwa yang terjadi. 

## Langkah 3: Buat pengguna di WorkSpaces Aplikasi
<a name="tutorial-aas-step3"></a>

Sementara Anda menunggu CloudFormation untuk menyelesaikan pembuatan tumpukan, Anda dapat membuat satu atau lebih pengguna di WorkSpaces Aplikasi. Pengguna ini adalah mereka yang akan menggunakan Enterprise Analyzer dalam WorkSpaces Aplikasi. Anda harus menentukan alamat email untuk setiap pengguna, dan memastikan bahwa setiap pengguna memiliki izin yang cukup untuk membuat bucket di Amazon S3, mengunggah file ke bucket, dan menautkan ke bucket untuk memetakan isinya.

1. Buka konsol WorkSpaces Aplikasi.

1. Di navigasi kiri, pilih **User pool**.

1. Pilih **Create user** (Buat pengguna).

1. Berikan alamat email tempat pengguna dapat menerima undangan email untuk menggunakan WorkSpaces Aplikasi, nama depan dan nama belakang, dan pilih **Buat pengguna**.

1. Ulangi jika perlu untuk membuat lebih banyak pengguna. Alamat email untuk setiap pengguna harus unik.

Untuk informasi selengkapnya tentang WorkSpaces cara membuat pengguna [WorkSpaces Aplikasi, lihat Kumpulan Pengguna Aplikasi](https://docs.aws.amazon.com/appstream2/latest/developerguide/user-pool.html) di *Panduan Administrasi WorkSpaces Aplikasi Amazon*.

Saat CloudFormation selesai membuat tumpukan, Anda dapat menetapkan pengguna yang Anda buat ke tumpukan, sebagai berikut:

1. Buka konsol WorkSpaces Aplikasi.

1. Pilih nama pengguna.

1. Pilih **Tindakan**, lalu **Tetapkan tumpukan**.

1. Di **Assign stack**, pilih tumpukan yang dimulai dengan`m2-appstream-stack-ea`.

1. Pilih **Tetapkan tumpukan**.  
![\[Halaman tumpukan WorkSpaces Applications Assign yang menampilkan pengguna dan tumpukan Enterprise Analyzer yang akan ditetapkan.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/aas-assign-stack.png)

Menetapkan pengguna ke tumpukan menyebabkan WorkSpaces Aplikasi mengirim email ke pengguna di alamat yang Anda berikan. Email ini berisi tautan ke halaman login WorkSpaces Aplikasi.

## Langkah 4: Masuk ke WorkSpaces Aplikasi
<a name="tutorial-aas-step4"></a>

Pada langkah ini, Anda masuk ke WorkSpaces Aplikasi menggunakan tautan di email yang dikirim oleh WorkSpaces Aplikasi ke pengguna yang Anda buat[Langkah 3: Buat pengguna di WorkSpaces Aplikasi](#tutorial-aas-step3).

1. Masuk ke WorkSpaces Aplikasi menggunakan tautan yang disediakan dalam email yang dikirim oleh WorkSpaces Aplikasi.

1. Ubah kata sandi Anda, jika diminta. Layar WorkSpaces Aplikasi yang Anda lihat mirip dengan yang berikut ini:  
![\[Contoh layar login WorkSpaces Aplikasi yang menampilkan ikon desktop.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/aas-login-screen.png)

1. Pilih **Desktop**.

1. Pada bilah tugas, pilih **Cari** dan masukkan **D:** untuk menavigasi ke Folder Beranda.
**catatan**  
Jika Anda melewati langkah ini, Anda mungkin mendapatkan `Device not ready` kesalahan saat mencoba mengakses Folder Beranda.

Kapan pun, jika Anda mengalami masalah saat masuk ke WorkSpaces Aplikasi, Anda dapat memulai ulang armada WorkSpaces Aplikasi Anda dan mencoba masuk lagi, menggunakan langkah-langkah berikut.

1. Buka konsol WorkSpaces Aplikasi.

1. Di navigasi kiri, pilih **Armada.**

1. Pilih armada yang Anda coba gunakan.

1. Pilih **Action**, lalu pilih **Stop**.

1. Tunggu armada berhenti.

1. Pilih **Tindakan**, lalu pilih **Mulai**.

Proses ini bisa memakan waktu sekitar 10 menit.

## Langkah 5: Verifikasi ember di Amazon S3 (opsional)
<a name="tutorial-aas-step5"></a>

Salah satu tugas yang diselesaikan oleh CloudFormation template yang Anda gunakan untuk membuat tumpukan adalah membuat dua bucket di Amazon S3, yang diperlukan untuk menyimpan dan memulihkan data pengguna dan pengaturan aplikasi di seluruh sesi kerja. Ember ini adalah sebagai berikut:
+ Nama dimulai dengan `appstream2-` Bucket ini memetakan data ke Folder Beranda Anda di WorkSpaces Applications (`D:\PhotonUser\My Files\Home Folder`).
**catatan**  
Folder Home unik untuk alamat email tertentu dan dibagikan di semua armada dan tumpukan di akun tertentu AWS . Nama Folder Rumah adalah SHA256 hash dari alamat email pengguna, dan disimpan di jalur berdasarkan hash itu.
+ Nama dimulai dengan `appstream-app-settings-` Bucket ini berisi informasi sesi pengguna untuk WorkSpaces Aplikasi, dan mencakup pengaturan seperti favorit browser, profil koneksi IDE dan aplikasi, serta penyesuaian UI. Untuk informasi selengkapnya, lihat [Cara Kerja Persistensi Pengaturan Aplikasi](https://docs.aws.amazon.com/appstream2/latest/developerguide/how-it-works-app-settings-persistence.html) di *Panduan Administrasi WorkSpaces Aplikasi Amazon*.

Untuk memverifikasi bahwa ember telah dibuat, ikuti langkah-langkah berikut:

1. Buka konsol Amazon S3.

1. Di navigasi kiri, pilih **Bucket**.

1. Di **Temukan ember berdasarkan nama**, masukkan **appstream** untuk memfilter daftar.

Jika Anda melihat ember, tidak ada tindakan lebih lanjut yang diperlukan. Ketahuilah bahwa ember itu ada. Jika Anda tidak melihat ember, maka CloudFormation templat belum selesai berjalan, atau terjadi kesalahan. Buka CloudFormation konsol dan tinjau pesan pembuatan tumpukan.

## Langkah selanjutnya
<a name="tutorial-aas-next-steps"></a>

Sekarang infrastruktur WorkSpaces Applications sudah diatur, Anda dapat mengatur dan mulai menggunakan Enterprise Analyzer. Untuk informasi selengkapnya, lihat [Tutorial: Mengatur Enterprise Analyzer pada Aplikasi WorkSpaces](set-up-ea.md). Anda juga dapat mengatur Enterprise Developer. Untuk informasi selengkapnya, lihat [Tutorial: Mengatur Pengembang Perusahaan Roket pada WorkSpaces Aplikasi](set-up-ed.md).

## Pembersihan sumber daya
<a name="tutorial-aas-cleanup"></a>

Prosedur untuk membersihkan tumpukan dan armada yang dibuat dijelaskan dalam [Buat Armada dan Tumpukan WorkSpaces Aplikasi](https://docs.aws.amazon.com/appstream2/latest/developerguide/set-up-stacks-fleets.html).

Ketika objek WorkSpaces Aplikasi telah dihapus, administrator akun juga dapat, jika sesuai, membersihkan bucket Amazon S3 untuk Pengaturan Aplikasi dan Folder Rumah.

**catatan**  
Folder home untuk pengguna tertentu unik di semua armada, jadi Anda mungkin perlu menyimpannya jika tumpukan WorkSpaces Aplikasi lain aktif di akun yang sama.

Terakhir, WorkSpaces Aplikasi saat ini tidak memungkinkan Anda untuk menghapus pengguna menggunakan konsol. Sebagai gantinya, Anda harus menggunakan API layanan dengan CLI. Untuk informasi selengkapnya, lihat [Administrasi Kumpulan Pengguna](https://docs.aws.amazon.com/appstream2/latest/developerguide/user-pool-admin.html) di *Panduan Administrasi WorkSpaces Aplikasi Amazon*.

# Tutorial: Gunakan template dengan Rocket Enterprise Developer (sebelumnya Micro Focus Enterprise Developer)
<a name="tutorial-templates-ed"></a>

Tutorial ini menjelaskan cara menggunakan template dan proyek yang telah ditentukan dengan Rocket Enterprise Developer. Ini mencakup tiga kasus penggunaan. Semua kasus penggunaan menggunakan kode sampel yang disediakan dalam BankDemo sampel. Untuk mengunduh sampel, pilih [https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip](https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip).

**penting**  
Jika Anda menggunakan versi Enterprise Developer untuk Windows, binari yang dihasilkan oleh compiler hanya dapat berjalan di Enterprise Server yang disediakan dengan Enterprise Developer. Anda tidak dapat menjalankannya di bawah runtime Modernisasi AWS Mainframe, yang didasarkan pada Linux.

**Topics**
+ [Use Case 1 - Menggunakan Template Proyek COBOL yang berisi komponen sumber](#tutorial-templates-ed-step1)
+ [Use Case 2 - Menggunakan Template Proyek COBOL tanpa komponen sumber](#tutorial-templates-ed-step2)
+ [Gunakan Kasus 3 - Menggunakan proyek COBOL yang telah ditentukan sebelumnya yang menautkan ke folder sumber](#tutorial-templates-ed-step3)
+ [Menggunakan Template JSON Definisi Wilayah](#tutorial-templates-ed-step4)

## Use Case 1 - Menggunakan Template Proyek COBOL yang berisi komponen sumber
<a name="tutorial-templates-ed-step1"></a>

Kasus penggunaan ini mengharuskan Anda untuk menyalin komponen sumber ke dalam struktur direktori Template sebagai bagian dari langkah pra-pengaturan demo. Dalam [https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip](https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip)hal ini telah diubah dari `AWSTemplates.zip` pengiriman asli untuk menghindari memiliki dua salinan sumber.

1. Mulai Enterprise Developer dan tentukan ruang kerja yang dipilih.  
![\[Peluncur Eclipse dengan ruang kerja yang dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ed-uc1-step1.png)

1. Dalam tampilan **Application Explorer**, dari item tampilan pohon **Proyek Pengembangan Perusahaan**, pilih **Proyek Baru dari Template** dari menu konteks.  
![\[Menu konteks tampilan pohon proyek pengembangan perusahaan.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ed-uc1-step2.png)

1. Masukkan parameter template seperti yang ditunjukkan.
**catatan**  
Template Path akan merujuk ke tempat ZIP diekstraksi.  
![\[Kotak Enter parameter template dengan jalur dan nama proyek diisi.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ed-uc1-step3.png)

1. Memilih OK akan membuat Proyek Eclipse pengembangan lokal berdasarkan template yang disediakan, dengan struktur lingkungan sumber dan eksekusi yang lengkap.  
![\[Proyek Eclipse pengembangan lokal menunjukkan strukturnya.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ed-uc1-step4.png)

   `System`Struktur berisi file definisi sumber daya lengkap dengan entri yang diperlukan untuk BANKDEMO, katalog yang diperlukan dengan entri ditambahkan dan file data ASCII yang sesuai.

   Karena struktur template sumber berisi semua item sumber, file-file ini disalin ke proyek lokal dan oleh karena itu secara otomatis dibangun di Enterprise Developer.

## Use Case 2 - Menggunakan Template Proyek COBOL tanpa komponen sumber
<a name="tutorial-templates-ed-step2"></a>

Langkah 1 hingga 3 identik dengan[Use Case 1 - Menggunakan Template Proyek COBOL yang berisi komponen sumber](#tutorial-templates-ed-step1). 

`System`Struktur dalam kasus penggunaan ini juga berisi file definisi sumber daya lengkap dengan entri yang diperlukan untuk BankDemo, katalog yang diperlukan dengan entri ditambahkan, dan file data ASCII yang sesuai.

Namun, struktur sumber template tidak mengandung komponen apa pun. Anda harus mengimpor ini ke dalam proyek dari repositori sumber apa pun yang Anda gunakan.

1. Pilih nama proyek. Dari menu konteks terkait, pilih **Impor**.  
![\[Menu konteks proyek dengan impor dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ed-uc2-step4.png)

1. Dari dialog yang dihasilkan, di bawah bagian **Umum**, pilih **Sistem File** dan kemudian pilih Berikutnya.  
![\[Kotak Impor dengan sistem file yang dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ed-uc2-step5.png)

1. Isi bidang **direktori Dari** dengan menelusuri sistem file untuk menunjuk ke folder repositori. Pilih semua folder yang ingin Anda impor, seperti`sources`. `Into folder`Bidang akan diisi sebelumnya. Pilih **Selesai**.   
![\[Kotak sistem File dengan BankDemo direktori diperluas.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ed-uc2-step6.png)

   Setelah struktur template sumber berisi semua item sumber, mereka dibangun secara otomatis di Enterprise Developer.

## Gunakan Kasus 3 - Menggunakan proyek COBOL yang telah ditentukan sebelumnya yang menautkan ke folder sumber
<a name="tutorial-templates-ed-step3"></a>

1. Mulai Enterprise Developer dan tentukan ruang kerja yang dipilih.  
![\[Peluncur Eclipse dengan ruang kerja yang dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ed-uc3-step1.png)

1. Dari menu **File**, pilih **Impor**.  
![\[Menu File dengan Impor dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ed-uc3-step2.png)

1. Dari dialog yang dihasilkan, di bawah **Umum**, pilih **Proyek dari Folder atau Arsip** dan pilih **Berikutnya**.  
![\[Kotak Impor dengan proyek dari folder atau arsip yang dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ed-uc3-step3.png)

1. Isi **sumber Impor**, Pilih **Direktori** dan telusuri sistem file untuk memilih folder proyek yang telah ditentukan sebelumnya. Proyek yang terkandung di dalamnya memiliki tautan ke folder sumber di repositori yang sama.  
![\[Proyek impor dari sistem file atau kotak arsip dengan jalur ke sumber impor dimasukkan.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ed-uc3-step4.png)

   Pilih **Selesai**.

   Karena proyek diisi oleh tautan ke folder sumber, kode dibuat secara otomatis.

## Menggunakan Template JSON Definisi Wilayah
<a name="tutorial-templates-ed-step4"></a>

1. Beralih ke tampilan Server Explorer. Dari menu konteks terkait, pilih **Open Administration Page**, yang memulai browser default.  
![\[Menu konteks server explorer dengan halaman administrasi terbuka dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ed-json-admin-page.png)

1. **Dari layar Enterprise Server Common Web Administration (ESCWA) yang dihasilkan, pilih Impor.**  
![\[Layar Administrasi Web Umum Server Perusahaan dengan Impor dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ed-json-import.png)

1. Pilih jenis impor **JSON** dan pilih **Berikutnya**.  
![\[Kotak pilih jenis impor dengan JSON dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ed-json-import-type.png)

1. Unggah `BANKDEMO.JSON` file yang disediakan.  
![\[Kotak pilih file untuk diunggah dengan file BANKDEMO dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ed-json-upload.png)

   Setelah dipilih, pilih **Berikutnya**.  
![\[Kotak wilayah pilih dengan port yang jelas dari titik akhir yang tidak dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ed-json-next.png)

   Pada panel **Select Regions**, pastikan opsi **Clear Ports from Endpoints** tidak dipilih, lalu lanjutkan memilih **Next** melalui panel hingga panel **Perform Import** ditampilkan. Kemudian pilih **Impor** dari panel navigasi kiri.

   Akhirnya klik **Selesai**. Wilayah BANKDEMO kemudian akan ditambahkan ke daftar server.  
![\[Daftar Region dan server dengan BankDemo ditambahkan.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ed-json-server-list.png)

1. Arahkan ke **Properti Umum** untuk wilayah BANKDEMO.

1. Gulir ke bagian **Konfigurasi**.

1. Variabel lingkungan ESP perlu diatur ke `System` folder yang relevan dengan Proyek Eclipse yang dibuat pada langkah sebelumnya. Ini seharusnya`workspacefolder/projectname/System`.  
![\[Bagian konfigurasi dengan variabel ESP ditampilkan.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ed-json-ESP.png)

1. Klik **Terapkan**.

   Wilayah ini sekarang sepenuhnya dikonfigurasi untuk berjalan bersama dengan proyek Eclipse COBOL.

1. Akhirnya, kembali ke Enterprise Developer, kaitkan wilayah yang diimpor dengan proyek.  
![\[Menu konteks proyek dengan Terkait dengan proyek yang dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ed-json-associate.png)

   Lingkungan Enterprise Developer sekarang siap digunakan, dengan versi kerja lengkap BankDemo. Anda dapat mengedit, mengkompilasi, dan men-debug kode terhadap wilayah tersebut.
**penting**  
Jika Anda menggunakan versi Enterprise Developer untuk Windows, binari yang dihasilkan oleh compiler hanya dapat berjalan di Enterprise Server yang disediakan dengan Enterprise Developer. Anda tidak dapat menjalankannya di bawah runtime Modernisasi AWS Mainframe, yang didasarkan pada Linux.

# Tutorial: Mengatur Enterprise Analyzer pada Aplikasi WorkSpaces
<a name="set-up-ea"></a>

Tutorial ini menjelaskan cara mengatur Rocket Enterprise Analyzer (sebelumnya Micro Focus Enterprise Analyzer) untuk menganalisis satu atau lebih aplikasi mainframe. Alat Enterprise Analyzer menyediakan beberapa laporan berdasarkan analisisnya terhadap kode sumber aplikasi dan definisi sistem.

Pengaturan ini dirancang untuk mendorong kolaborasi tim. Instalasi menggunakan bucket Amazon S3 untuk berbagi kode sumber dengan disk virtual. Melakukan hal ini menggunakan [Rclone](https://rclone.org/)) pada mesin Windows. Dengan instans Amazon RDS umum yang menjalankan [PostgreSQL](https://www.postgresql.org/), setiap anggota tim dapat mengakses semua laporan yang diminta.

Anggota tim juga dapat memasang disk virtual Amazon S3 yang didukung di mesin pribadi mereka. dan memperbarui bucket sumber dari workstation mereka. Mereka berpotensi menggunakan skrip atau bentuk otomatisasi lainnya pada mesin mereka jika terhubung ke sistem internal lokal lainnya.

Pengaturan didasarkan pada gambar WorkSpaces Aplikasi Windows yang dibagikan Modernisasi AWS Mainframe dengan pelanggan. Pengaturan juga didasarkan pada pembuatan armada WorkSpaces Aplikasi dan tumpukan seperti yang dijelaskan dalam. [Tutorial: Mengatur WorkSpaces Aplikasi untuk digunakan dengan Rocket Enterprise Analyzer dan Rocket Enterprise Developer](set-up-appstream-mf.md)

**penting**  
Langkah-langkah dalam tutorial ini mengasumsikan bahwa Anda mengatur WorkSpaces Aplikasi dengan CloudFormation template yang dapat diunduh [cfn-m2-](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) .yl. appstream-fleet-ea-ed Untuk informasi selengkapnya, lihat [Tutorial: Mengatur WorkSpaces Aplikasi untuk digunakan dengan Rocket Enterprise Analyzer dan Rocket Enterprise Developer](set-up-appstream-mf.md).  
Untuk melakukan langkah-langkah dalam tutorial ini, Anda harus mengatur armada dan tumpukan Enterprise Analyzer Anda dan mereka harus berjalan.

Untuk penjelasan lengkap tentang fitur dan kiriman Enterprise Analyzer, lihat situs web [Enterprise Analyzer Documentation](https://www.microfocus.com/documentation/enterprise-analyzer/) on the Rocket Software (sebelumnya Micro Focus).

## Isi gambar
<a name="set-up-ea-image-contents"></a>

Selain aplikasi Enterprise Analyzer itu sendiri, gambar berisi alat dan pustaka berikut.

Alat pihak ketiga
+ [Python](https://www.python.org/)
+ [Rklon](https://rclone.org/)
+ [pgAdmin](https://www.pgadmin.org/)
+ [git-scm](https://git-scm.com/)
+ [Pengemudi PostgreSQL ODBC](https://odbc.postgresql.org/)

Perpustakaan di `C:\Users\Public`
+ BankDemo kode sumber dan definisi proyek untuk Pengembang Perusahaan:`m2-bankdemo-template.zip`.
+ Paket instalasi MFA untuk mainframe:. `mfa.zip` Untuk informasi selengkapnya, lihat [Ikhtisar Akses Mainframe](https://www.microfocus.com/documentation/enterprise-developer/30pu12/ED-VS2012/BKMMMMINTRS001.html) di dokumentasi *Pengembang Perusahaan Fokus Mikro*.
+ File perintah dan konfigurasi untuk Rclone (petunjuk penggunaannya dalam tutorial): dan. `m2-rclone.cmd` `m2-rclone.conf`

**Topics**
+ [Isi gambar](#set-up-ea-image-contents)
+ [Prasyarat](#tutorial-ea-prerequisites)
+ [Langkah 1: Pengaturan](#tutorial-ea-step1)
+ [Langkah 2: Buat folder virtual berbasis Amazon S3 di Windows](#tutorial-ea-step2)
+ [Langkah 3: Buat sumber ODBC untuk instans Amazon RDS](#tutorial-ea-step3)
+ [Sesi selanjutnya](#tutorial-ea-step4)
+ [Memecahkan masalah koneksi ruang kerja](#tutorial-ea-step5)
+ [Pembersihan sumber daya](#tutorial-ea-clean)

## Prasyarat
<a name="tutorial-ea-prerequisites"></a>
+ Unggah kode sumber dan definisi sistem untuk aplikasi pelanggan yang ingin Anda analisis ke bucket S3. Definisi sistem termasuk CICS CSD, definisi DB2 objek, dan sebagainya. Anda dapat membuat struktur folder di dalam bucket yang masuk akal untuk bagaimana Anda ingin mengatur artefak aplikasi. Misalnya, ketika Anda membuka zip BankDemo sampel, ia memiliki struktur berikut:

  ```
  demo
       |--> jcl
       |--> RDEF
       |--> transaction
       |--> xa
  ```
+ Buat dan mulai instans Amazon RDS yang menjalankan PostgreSQL. Contoh ini akan menyimpan data dan hasil yang dihasilkan oleh Enterprise Analyzer. Anda dapat membagikan contoh ini dengan semua anggota tim aplikasi. Selain itu, buat skema kosong yang disebut `m2_ea` (atau nama lain yang sesuai) dalam database. Tentukan kredensil untuk pengguna resmi yang memungkinkan mereka membuat, menyisipkan, memperbarui, dan menghapus item dalam skema ini. Anda dapat memperoleh nama database, URL endpoint servernya, dan port TCP dari konsol Amazon RDS atau dari administrator akun.
+ Pastikan Anda telah mengatur akses terprogram ke Anda Akun AWS. *Untuk informasi selengkapnya, lihat [Akses terprogram](https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys) di.Referensi Umum Amazon Web*

## Langkah 1: Pengaturan
<a name="tutorial-ea-step1"></a>

1. Mulai sesi dengan WorkSpaces Aplikasi dengan URL yang Anda terima dalam pesan email selamat datang dari WorkSpaces Aplikasi.

1. Gunakan email Anda sebagai ID pengguna Anda, dan tentukan kata sandi permanen Anda.

1. Pilih tumpukan Enterprise Analyzer.

1. Pada halaman menu WorkSpaces Aplikasi, pilih **Desktop** untuk mencapai desktop Windows yang sedang streaming armada.

## Langkah 2: Buat folder virtual berbasis Amazon S3 di Windows
<a name="tutorial-ea-step2"></a>

**catatan**  
Jika Anda sudah menggunakan Rclone selama pratinjau Modernisasi AWS Mainframe, Anda harus memperbarui `m2-rclone.cmd` ke versi yang lebih baru yang terletak di. `C:\Users\Public`

1. Salin `m2-rclone.cmd` file `m2-rclone.conf` dan file yang disediakan `C:\Users\Public` ke folder rumah Anda `C:\Users\PhotonUser\My Files\Home Folder` menggunakan File Explorer.

1. Perbarui parameter `m2-rclone.conf` konfigurasi dengan kunci AWS akses Anda dan rahasia yang sesuai, serta Anda Wilayah AWS.

   ```
   [m2-s3]
   type = s3
   provider = AWS
   access_key_id = YOUR-ACCESS-KEY
   secret_access_key = YOUR-SECRET-KEY
   region = YOUR-REGION
   acl = private
   server_side_encryption = AES256
   ```

1. Di `m2-rclone.cmd`, lakukan perubahan berikut:
   + Ubah `amzn-s3-demo-bucket` ke nama bucket Amazon S3 Anda. Misalnya, `m2-s3-mybucket`.
   + Ubah `your-s3-folder-key` ke kunci bucket Amazon S3 Anda. Misalnya, `myProject`.
   + Ubah `your-local-folder-path` ke jalur direktori tempat Anda ingin file aplikasi disinkronkan dari bucket Amazon S3 yang berisi file tersebut. Misalnya, `D:\PhotonUser\My Files\Home Folder\m2-new`. Direktori yang disinkronkan ini harus merupakan subdirektori dari Folder Rumah agar WorkSpaces Aplikasi dapat mencadangkan dan mengembalikannya dengan benar pada awal dan akhir sesi.

   ```
   :loop
   timeout /T 10
   "C:\Program Files\rclone\rclone.exe" sync m2-s3:amzn-s3-demo-bucket/your-s3-folder-key "D:\PhotonUser\My Files\Home Folder\your-local-folder-path" --config "D:\PhotonUser\My Files\Home Folder\m2-rclone.conf"
   goto :loop
   ```

1. Buka prompt perintah Windows, cd ke `C:\Users\PhotonUser\My Files\Home Folder` jika diperlukan dan jalankan`m2-rclone.cmd`. Skrip perintah ini menjalankan loop kontinu, menyinkronkan bucket Amazon S3 Anda dan kunci ke folder lokal setiap 10 detik. Anda dapat menyesuaikan waktu habis sesuai kebutuhan. Anda akan melihat kode sumber aplikasi yang terletak di bucket Amazon S3 di Windows File Explorer.

Untuk menambahkan file baru ke set yang sedang Anda kerjakan atau untuk memperbarui file yang sudah ada, unggah file ke bucket Amazon S3 dan file tersebut akan disinkronkan ke direktori Anda pada iterasi berikutnya yang ditentukan. `m2-rclone.cmd` Demikian pula, jika Anda ingin menghapus beberapa file, hapus dari bucket Amazon S3. Operasi sinkronisasi berikutnya akan menghapusnya dari direktori lokal Anda.

## Langkah 3: Buat sumber ODBC untuk instans Amazon RDS
<a name="tutorial-ea-step3"></a>

1. **Untuk memulai alat EA\$1admin, navigasikan ke menu pemilih aplikasi di sudut kiri atas jendela browser dan pilih MF EA\$1admin.**

1. Dari menu **Administer**, pilih **ODBC Data Sources**, dan pilih **Add** dari tab **User DSN**.

1. **Dalam kotak dialog Create New Data Source, pilih driver **PostgreSQL** Unicode, lalu pilih Finish.**

1. Di kotak dialog Penyiapan **PostgreSQL Unicode ODBC Driver (psqlodBC)**, tentukan dan catat nama sumber data yang Anda inginkan. Lengkapi parameter berikut dengan nilai dari instance RDS yang sebelumnya Anda buat:  
**Deskripsi**  
Deskripsi opsional untuk membantu Anda mengidentifikasi koneksi database ini dengan cepat.  
**Basis Data**  
Database Amazon RDS yang Anda buat sebelumnya.  
**Server**  
Titik akhir Amazon RDS.  
**Port**  
Port Amazon RDS.  
**Nama Pengguna**  
Seperti yang didefinisikan dalam instance Amazon RDS.  
**Kata Sandi**  
Seperti yang didefinisikan dalam instance Amazon RDS.

1. Pilih **Uji** untuk memvalidasi bahwa koneksi ke Amazon RDS berhasil, lalu pilih **Simpan untuk menyimpan DSN** Pengguna baru Anda.

1. Tunggu hingga Anda melihat pesan yang mengonfirmasi pembuatan ruang kerja yang tepat, lalu pilih **OK** untuk menyelesaikan dengan Sumber Data ODBC dan tutup alat EA\$1admin.

1. Arahkan lagi ke menu pemilih aplikasi, dan pilih Enterprise Analyzer untuk memulai alat. Pilih **Buat Baru**. 

1. Di jendela konfigurasi Workspace, masukkan nama ruang kerja Anda dan tentukan lokasinya. Ruang kerja dapat berupa disk berbasis Amazon S3 jika Anda bekerja di bawah konfigurasi ini, atau folder rumah Anda jika Anda mau.

1. Pilih **Pilih Database Lain** untuk terhubung ke instans Amazon RDS Anda.

1. **Pilih ikon **Postgre** dari opsi, lalu pilih OK.**

1. Untuk pengaturan Windows di bawah **Opsi — Tentukan Parameter Koneksi**, masukkan nama sumber data yang Anda buat. Masukkan juga nama database, nama skema, nama pengguna, dan kata sandi. Pilih **OK**.

1. Tunggu Enterprise Analyzer untuk membuat semua tabel, indeks, dan sebagainya sehingga perlu menyimpan hasil. Proses ini mungkin memakan waktu beberapa menit. Enterprise Analyzer mengonfirmasi kapan database dan ruang kerja siap digunakan.

1. Arahkan lagi ke menu pemilih aplikasi dan pilih Enterprise Analyzer untuk memulai alat.

1. Jendela startup Enterprise Analyzer muncul di lokasi ruang kerja baru yang dipilih. Pilih **OK**.

1. Arahkan ke repositori Anda di panel kiri, pilih nama repositori, dan pilih **Tambahkan file/folder ke ruang kerja Anda. Pilih folder** tempat kode aplikasi Anda disimpan untuk menambahkannya ke ruang kerja. Anda dapat menggunakan kode BankDemo contoh sebelumnya jika Anda mau. Saat Enterprise Analyzer meminta Anda untuk memverifikasi file-file tersebut, pilih **Verifikasi untuk memulai laporan verifikasi** Enterprise Analyzer awal. Mungkin perlu beberapa menit untuk menyelesaikannya, tergantung pada ukuran aplikasi Anda.

1. Perluas ruang kerja Anda untuk melihat file dan folder yang telah Anda tambahkan ke ruang kerja. Jenis objek dan laporan kompleksitas siklomatik juga terlihat di kuadran atas panel Penampil **Bagan**.

Anda sekarang dapat menggunakan Enterprise Analyzer untuk semua tugas yang diperlukan.

## Sesi selanjutnya
<a name="tutorial-ea-step4"></a>

1. Mulai sesi dengan WorkSpaces Aplikasi dengan URL yang Anda terima dalam pesan email selamat datang dari WorkSpaces Aplikasi.

1. Masuk dengan email dan kata sandi permanen Anda.

1. Pilih tumpukan Enterprise Analyzer.

1. Luncurkan `Rclone` untuk terhubung ke disk yang didukung Amazon S3 jika Anda menggunakan opsi ini untuk berbagi file ruang kerja.

1. Luncurkan Enterprise Analyzer untuk melakukan tugas Anda.

## Memecahkan masalah koneksi ruang kerja
<a name="tutorial-ea-step5"></a>

Saat Anda mencoba menyambung kembali ke ruang kerja Enterprise Analyzer, Anda mungkin melihat kesalahan seperti ini:

```
Cannot access the workspace directory D:\PhotonUser\My Files\Home Folder\EA_BankDemo. The workspace has been created on a non-shared disk of the EC2AMAZ-E6LC33H computer. Would you like to correct the workspace directory location?
```

Untuk mengatasi masalah ini, pilih **OK** untuk menghapus pesan, lalu selesaikan langkah-langkah berikut.

1. Di WorkSpaces Applications, pilih ikon **Launch Application** pada toolbar, lalu pilih **EA\$1admin** untuk memulai alat Enterprise Analyzer Administration.  
![\[Menu pemilih peluncuran WorkSpaces Aplikasi dengan alat administrasi Pengembang Rocket Enterprise yang dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/aas-launch-selector.png)

1. Dari menu **Administer**, pilih **Refresh Workspace** Path... .  
![\[Kelola menu alat administrasi Rocket Enterprise Analyzer dengan Refresh Workspace Path dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ea_admin-administer-refresh.png)

1. **Di bawah **Pilih ruang kerja**, pilih ruang kerja yang Anda inginkan, lalu pilih OK.**  
![\[Kotak dialog Select workspace dari alat administrasi Rocket Enterprise Analyzer dengan proyek yang dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ea_admin-select-workspace.png)

1. Pilih **OK** untuk mengonfirmasi pesan kesalahan.  
![\[Pesan kesalahan Enterprise Analyzer “Tidak dapat mengakses direktori ruang kerja” dengan OK dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ea_admin-select-workspace-error.png)

1. Di bawah **jalur jaringan direktori Workspace**, masukkan jalur yang benar ke ruang kerja Anda, misalnya,. `D:\PhotonUser\My Files\Home Folder\EA\MyWorkspace3`  
![\[Kotak dialog Enterprise Analyzer Jalur jaringan direktori Workspace dengan jalur contoh.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ea_admin-workspace-directory-network-path.png)

1. Tutup alat Micro Focus Enterprise Analyzer Administration.  
![\[Alat Administrasi Penganalisis Perusahaan Fokus Mikro dengan tombol Tutup dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ea_admin-close.png)

1. Di WorkSpaces Applications, pilih ikon **Launch Application** pada toolbar, dan kemudian pilih **EA** untuk memulai Micro Focus Enterprise Analyzer.  
![\[WorkSpaces Aplikasi meluncurkan ikon aplikasi dengan EA dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/aas-launch-ea.png)

1. Ulangi langkah 3 - 5.

Micro Focus Enterprise Analyzer sekarang harus terbuka dengan ruang kerja yang ada.

## Pembersihan sumber daya
<a name="tutorial-ea-clean"></a>

Jika Anda tidak lagi membutuhkan sumber daya yang Anda buat untuk tutorial ini, hapus sehingga Anda tidak dikenakan biaya lebih lanjut. Selesaikan langkah-langkah berikut:
+ Gunakan alat **EA\$1admin** untuk menghapus ruang kerja.
+ Hapus bucket S3 yang Anda buat untuk tutorial ini. Untuk informasi selengkapnya, lihat [Menghapus bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/delete-bucket.html) di Panduan Pengguna *Amazon S3*.
+ Hapus database yang Anda buat untuk tutorial ini. Untuk informasi selengkapnya, lihat [Menghapus instans DB](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html#CHAP_GettingStarted.Deleting.PostgreSQL).

# Tutorial: Mengatur Pengembang Perusahaan Roket pada WorkSpaces Aplikasi
<a name="set-up-ed"></a>

Tutorial ini menjelaskan cara mengatur Rocket Enterprise Developer (sebelumnya Micro Focus Enterprise Developer) untuk satu atau lebih aplikasi mainframe untuk memelihara, mengkompilasi, dan mengujinya menggunakan fitur Enterprise Developer. Pengaturan didasarkan pada gambar WorkSpaces Aplikasi Windows yang dibagikan Modernisasi AWS Mainframe dengan pelanggan dan pada pembuatan armada dan tumpukan WorkSpaces Aplikasi seperti yang dijelaskan dalam. [Tutorial: Mengatur WorkSpaces Aplikasi untuk digunakan dengan Rocket Enterprise Analyzer dan Rocket Enterprise Developer](set-up-appstream-mf.md)

**penting**  
Langkah-langkah dalam tutorial ini mengasumsikan bahwa Anda mengatur WorkSpaces Aplikasi menggunakan CloudFormation template yang dapat diunduh [cfn-m2-](https://d1vi4vxke6c2hu.cloudfront.net/tutorial/cfn-m2-appstream-fleet-ea-ed.yaml) .yaml. appstream-fleet-ea-ed Untuk informasi selengkapnya, lihat [Tutorial: Mengatur WorkSpaces Aplikasi untuk digunakan dengan Rocket Enterprise Analyzer dan Rocket Enterprise Developer](set-up-appstream-mf.md).  
Anda harus melakukan langkah-langkah pengaturan ini ketika armada dan tumpukan Pengembang Perusahaan aktif dan berjalan.

Untuk deskripsi lengkap tentang fitur dan kiriman Enterprise Developer v7, lihat [dokumentasi up-to-date online-nya (v7.0)](https://www.microfocus.com/documentation/enterprise-developer/ed70/ED-Eclipse/GUID-8D6B7358-AC35-4DAF-A445-607D8D97EBB2.html) di situs Rocket Software (sebelumnya Micro Focus).

## Isi gambar
<a name="set-up-ed-image-contents"></a>

Selain Enterprise Developer itu sendiri, gambar berisi gambar berisi Rumba ( TN3270 emulator). Ini juga berisi alat dan perpustakaan berikut.

Alat pihak ketiga
+ [Python](https://www.python.org/)
+ [Rklon](https://rclone.org/)
+ [pgAdmin](https://www.pgadmin.org/)
+ [git-scm](https://git-scm.com/)
+ [Pengemudi PostgreSQL ODBC](https://odbc.postgresql.org/)

Perpustakaan di `C:\Users\Public`
+ BankDemo kode sumber dan definisi proyek untuk Pengembang Perusahaan:`m2-bankdemo-template.zip`.
+ Paket instalasi MFA untuk mainframe:. `mfa.zip` Untuk informasi selengkapnya, lihat [Ikhtisar Akses Mainframe](https://www.microfocus.com/documentation/enterprise-developer/30pu12/ED-VS2012/BKMMMMINTRS001.html) di dokumentasi *Pengembang Perusahaan Fokus Mikro*.
+ File perintah dan konfigurasi untuk Rclone (petunjuk penggunaannya dalam tutorial): dan. `m2-rclone.cmd` `m2-rclone.conf`

Jika Anda perlu mengakses kode sumber yang belum dimuat ke dalam CodeCommit repositori, tetapi tersedia di bucket Amazon S3, misalnya untuk melakukan pemuatan awal kode sumber ke git, ikuti prosedur untuk membuat disk Windows virtual seperti yang dijelaskan dalam. [Tutorial: Mengatur Enterprise Analyzer pada Aplikasi WorkSpaces](set-up-ea.md)

**Topics**
+ [Isi gambar](#set-up-ed-image-contents)
+ [Prasyarat](#tutorial-ed-prerequisites)
+ [Langkah 1: Pengaturan oleh masing-masing pengguna Enterprise Developer](#tutorial-ed-step1)
+ [Langkah 2: Buat folder virtual berbasis Amazon S3 di Windows (opsional)](#tutorial-ed-step2)
+ [Langkah 3: Kloning repositori](#tutorial-ed-step3)
+ [Sesi selanjutnya](#tutorial-ed-step4)
+ [Pembersihan sumber daya](#tutorial-ed-clean)

## Prasyarat
<a name="tutorial-ed-prerequisites"></a>
+ Satu atau lebih CodeCommit repositori dimuat dengan kode sumber aplikasi yang akan dipertahankan. Pengaturan repositori harus sesuai dengan persyaratan CI/CD pipa di atas untuk membuat sinergi dengan kombinasi kedua alat.
+ Setiap pengguna harus memiliki kredensi ke repositori atau CodeCommit repositori yang ditentukan oleh administrator akun sesuai dengan informasi dalam [Otentikasi](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control.html) dan kontrol akses untuk AWS. CodeCommit Struktur kredensil tersebut ditinjau dalam [Otentikasi dan kontrol akses untuk AWS CodeCommit](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control.html) dan referensi lengkap untuk otorisasi IAM CodeCommit ada dalam [referensi CodeCommit izin](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control-permissions-reference.html): administrator dapat menentukan kebijakan IAM yang berbeda untuk peran berbeda yang memiliki kredensil khusus untuk peran untuk setiap repositori dan membatasi otorisasi pengguna ke serangkaian tugas tertentu yang harus dia selesaikan pada repositori tertentu. Jadi, untuk setiap pengelola CodeCommit repositori, administrator akun akan menghasilkan pengguna utama dan memberikan izin pengguna ini untuk mengakses repositori atau repositori yang diperlukan melalui memilih kebijakan atau kebijakan IAM yang tepat untuk akses. CodeCommit

## Langkah 1: Pengaturan oleh masing-masing pengguna Enterprise Developer
<a name="tutorial-ed-step1"></a>

1. Dapatkan kredensi IAM Anda:

   1. Connect ke AWS konsol di [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

   1. Ikuti prosedur yang dijelaskan pada langkah 3 [Penyiapan untuk pengguna HTTPS yang menggunakan kredensi Git](https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-gc.html) di *AWS CodeCommit Panduan Pengguna*. 

   1. Salin kredensial-masuk CodeCommit khusus yang dibuat IAM untuk Anda, baik dengan menampilkan, menyalin, dan kemudian menempelkan informasi ini ke file aman di komputer lokal Anda, atau dengan memilih **Unduh kredensional untuk mengunduh** informasi ini sebagai file.CSV. Anda memerlukan informasi ini untuk terhubung CodeCommit.

1. Mulai sesi dengan WorkSpaces Aplikasi berdasarkan url yang diterima di email selamat datang. Gunakan email Anda sebagai nama pengguna dan buat kata sandi Anda.

1. Pilih tumpukan Enterprise Developer Anda.

1. Pada halaman menu, pilih **Desktop** untuk mencapai desktop Windows yang dialirkan oleh armada.

## Langkah 2: Buat folder virtual berbasis Amazon S3 di Windows (opsional)
<a name="tutorial-ed-step2"></a>

Jika ada kebutuhan untuk Rclone (lihat di atas), buat folder virtual berbasis Amazon S3 di Windows: (opsional jika semua artefak aplikasi secara eksklusif berasal dari akses). CodeCommit 

**catatan**  
Jika Anda sudah menggunakan Rclone selama pratinjau Modernisasi AWS Mainframe, Anda harus memperbarui `m2-rclone.cmd` ke versi yang lebih baru yang terletak di. `C:\Users\Public`

1. Salin `m2-rclone.cmd` file `m2-rclone.conf` dan file yang disediakan `C:\Users\Public` ke folder rumah Anda `C:\Users\PhotonUser\My Files\Home Folder` menggunakan File Explorer.

1. Perbarui parameter `m2-rclone.conf` konfigurasi dengan kunci AWS akses Anda dan rahasia yang sesuai, serta Anda Wilayah AWS.

   ```
   [m2-s3]
   type = s3
   provider = AWS
   access_key_id = YOUR-ACCESS-KEY
   secret_access_key = YOUR-SECRET-KEY
   region = YOUR-REGION
   acl = private
   server_side_encryption = AES256
   ```

1. Di `m2-rclone.cmd`, lakukan perubahan berikut:
   + Ubah `amzn-s3-demo-bucket` ke nama bucket Amazon S3 Anda. Misalnya, `m2-s3-mybucket`.
   + Ubah `your-s3-folder-key` ke kunci bucket Amazon S3 Anda. Misalnya, `myProject`.
   + Ubah `your-local-folder-path` ke jalur direktori tempat Anda ingin file aplikasi disinkronkan dari bucket Amazon S3 yang berisi file tersebut. Misalnya, `D:\PhotonUser\My Files\Home Folder\m2-new`. Direktori yang disinkronkan ini harus merupakan subdirektori dari Folder Rumah agar WorkSpaces Aplikasi dapat mencadangkan dan mengembalikannya dengan benar pada awal dan akhir sesi.

   ```
   :loop
   timeout /T 10
   "C:\Program Files\rclone\rclone.exe" sync m2-s3:amzn-s3-demo-bucket/your-s3-folder-key "D:\PhotonUser\My Files\Home Folder\your-local-folder-path" --config "D:\PhotonUser\My Files\Home Folder\m2-rclone.conf"
   goto :loop
   ```

1. Buka prompt perintah Windows, cd ke `C:\Users\PhotonUser\My Files\Home Folder` jika diperlukan dan jalankan`m2-rclone.cmd`. Skrip perintah ini menjalankan loop kontinu, menyinkronkan bucket Amazon S3 Anda dan kunci ke folder lokal setiap 10 detik. Anda dapat menyesuaikan waktu habis sesuai kebutuhan. Anda akan melihat kode sumber aplikasi yang terletak di bucket Amazon S3 di Windows File Explorer.

Untuk menambahkan file baru ke set yang sedang Anda kerjakan atau untuk memperbarui file yang sudah ada, unggah file ke bucket Amazon S3 dan file tersebut akan disinkronkan ke direktori Anda pada iterasi berikutnya yang ditentukan. `m2-rclone.cmd` Demikian pula, jika Anda ingin menghapus beberapa file, hapus dari bucket Amazon S3. Operasi sinkronisasi berikutnya akan menghapusnya dari direktori lokal Anda.

## Langkah 3: Kloning repositori
<a name="tutorial-ed-step3"></a>

1. Arahkan ke menu pemilih aplikasi di sudut kiri atas jendela browser dan pilih Enterprise Developer.

1. Selesaikan pembuatan ruang kerja yang dibutuhkan oleh Enterprise Developer di folder Home Anda dengan memilih `C:\Users\PhotonUser\My Files\Home Folder` (alias`D: \PhotonUser\My Files\Home Folder`) sebagai lokasi untuk ruang kerja.

1. ******Di Enterprise Developer, kloning CodeCommit repositori Anda dengan pergi ke Project Explorer, klik kanan dan pilih **Import, Import**..., Git, Projects **from** **Git** Clone URI.****** Kemudian, masukkan kredensi masuk CodeCommit -spesifik Anda dan selesaikan dialog Eclipse untuk mengimpor kode.

Repositori CodeCommit git sekarang dikloning di ruang kerja lokal Anda.

Ruang kerja Enterprise Developer Anda sekarang siap untuk memulai pekerjaan pemeliharaan pada aplikasi Anda. Secara khusus, Anda dapat menggunakan instance lokal Enterprise Server (ES) yang terintegrasi dengan Enterprise Developer untuk secara interaktif men-debug dan menjalankan aplikasi Anda untuk memvalidasi perubahan Anda secara lokal.

**catatan**  
Lingkungan Enterprise Developer lokal, termasuk instance Enterprise Server lokal, berjalan di bawah Windows sementara Modernisasi AWS Mainframe berjalan di Linux. Kami menyarankan Anda menjalankan pengujian komplementer di lingkungan Linux yang disediakan oleh Modernisasi AWS Mainframe setelah Anda melakukan aplikasi baru CodeCommit dan membangunnya kembali untuk target ini dan sebelum Anda meluncurkan aplikasi baru ke produksi.

## Sesi selanjutnya
<a name="tutorial-ed-step4"></a>

Saat Anda memilih folder yang berada di bawah Manajemen WorkSpaces aplikasi seperti folder rumah untuk kloning CodeCommit repositori Anda, folder tersebut akan disimpan dan dipulihkan secara transparan di seluruh sesi. Selesaikan langkah-langkah berikut saat berikutnya Anda perlu bekerja dengan aplikasi: 

1. Mulai sesi dengan WorkSpaces Aplikasi berdasarkan url yang diterima di email selamat datang.

1. Login dengan email dan kata sandi permanen Anda.

1. Pilih tumpukan Enterprise Developer.

1. Luncurkan `Rclone` untuk menghubungkan (lihat di atas) ke disk yang didukung Amazon S3 saat opsi ini digunakan untuk berbagi file ruang kerja.

1. Luncurkan Enterprise Developer untuk melakukan pekerjaan Anda.

## Pembersihan sumber daya
<a name="tutorial-ed-clean"></a>

Jika Anda tidak lagi membutuhkan sumber daya yang Anda buat untuk tutorial ini, hapus sehingga Anda tidak akan terus dikenakan biaya untuk itu. Selesaikan langkah-langkah berikut:
+ Hapus CodeCommit repositori yang Anda buat untuk tutorial ini. Untuk informasi selengkapnya, lihat [Menghapus CodeCommit repositori](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-delete-repository.html) di *AWS CodeCommit Panduan Pengguna*.
+ Hapus database yang Anda buat untuk tutorial ini. Untuk informasi selengkapnya, lihat [Menghapus instans DB](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html#CHAP_GettingStarted.Deleting.PostgreSQL).

# Utilitas batch yang tersedia di Modernisasi AWS Mainframe
<a name="utilities-m2"></a>

Aplikasi mainframe sering menggunakan program utilitas batch untuk melakukan fungsi tertentu seperti menyortir data, mentransfer file menggunakan FTP, memuat data ke dalam database seperti DB2, membongkar data dari database, dan sebagainya.

Saat Anda memigrasikan aplikasi Anda ke Modernisasi AWS Mainframe, Anda memerlukan utilitas pengganti yang setara secara fungsional yang dapat melakukan tugas yang sama seperti yang Anda gunakan pada mainframe. Beberapa utilitas ini mungkin sudah tersedia sebagai bagian dari mesin runtime Modernisasi AWS Mainframe, tetapi kami menyediakan utilitas pengganti berikut:
+ M2SFTP - memungkinkan transfer file aman menggunakan protokol SFTP.
+ M2WAIT - menunggu jumlah waktu tertentu sebelum melanjutkan dengan langkah berikutnya dalam pekerjaan batch.
+ TXT2PDF - mengonversi file teks ke format PDF.
+ M2DFUTIL - menyediakan fungsi backup, restore, delete, dan copy pada set data yang mirip dengan dukungan yang disediakan oleh utilitas ADRDSSU mainframe.
+ M2RUNCMD - memungkinkan Anda menjalankan perintah, skrip, dan panggilan sistem Rocket Software (sebelumnya Micro Focus) langsung dari JCL.

Kami mengembangkan utilitas batch ini berdasarkan umpan balik pelanggan dan mendesainnya untuk menyediakan fungsionalitas yang sama dengan utilitas mainframe. Tujuannya adalah untuk membuat transisi Anda dari mainframe ke Modernisasi AWS Mainframe semulus mungkin.

**Topics**
+ [Lokasi Biner](#location-utilities)
+ [Utilitas batch M2SFTP](m2sftp.md)
+ [Utilitas batch M2WAIT](m2wait.md)
+ [TXT2Utilitas batch PDF](txt2pdf.md)
+ [Utilitas batch M2DFUTIL](m2dfutil.md)
+ [Utilitas batch M2RUNCMD](m2runcmd.md)

## Lokasi Biner
<a name="location-utilities"></a>

Utilitas ini sudah diinstal sebelumnya pada produk Rocket Enterprise Developer (ED) dan Rocket Software (ES). Anda dapat menemukannya di lokasi berikut untuk semua varian ED dan ES:
+ 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`

# 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/)

# Utilitas batch M2WAIT
<a name="m2wait"></a>

M2WAIT adalah program utilitas mainframe yang memungkinkan Anda untuk memperkenalkan periode tunggu dalam skrip JCL Anda dengan menentukan durasi waktu dalam detik, menit, atau jam. Anda dapat memanggil M2WAIT langsung dari JCL dengan melewatkan waktu yang ingin Anda tunggu sebagai parameter input. Secara internal, program M2WAIT memanggil modul yang disediakan Rocket Software (sebelumnya Micro Focus) `C$SLEEP` untuk menunggu waktu yang ditentukan.

**catatan**  
Anda dapat menggunakan alias Micro Focus untuk mengganti apa yang Anda miliki di skrip JCL Anda. Untuk informasi selengkapnya, lihat [JES Alias di dokumentasi](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-D4206FF9-32C4-43E7-9413-5E7E96AA8092.html) Micro Focus.

**Topics**
+ [Platform yang didukung](#m2wait-platforms)
+ [Konfigurasikan M2WAIT untuk Modernisasi AWS Mainframe Dikelola](#m2wait-configure-managed)
+ [Konfigurasikan M2WAIT untuk runtime Modernisasi AWS Mainframe di Amazon EC2 (termasuk Aplikasi) WorkSpaces](#m2wait-configure-customer-infra)
+ [Sampel JCL](#m2wait-jcl)

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

Anda dapat menggunakan M2WAIT 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).

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

Jika aplikasi yang dimigrasi berjalan di Modernisasi AWS Mainframe Dikelola, Anda perlu mengonfigurasi M2WAIT sebagai berikut.
+ Gunakan program M2WAIT di JCL Anda dengan melewatkan parameter input seperti yang ditunjukkan pada. [Sampel JCL](#m2wait-jcl)

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

Jika aplikasi yang dimigrasi berjalan pada runtime Modernisasi AWS Mainframe di Amazon EC2, konfigurasikan M2WAIT 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. Gunakan program M2WAIT di JCL Anda dengan meneruskan parameter input seperti yang ditunjukkan pada. [Sampel JCL](#m2wait-jcl)

## Sampel JCL
<a name="m2wait-jcl"></a>

Untuk menguji instalasi, Anda dapat menggunakan `M2WAIT1.jcl` program ini.

Contoh JCL ini menunjukkan cara memanggil M2WAIT dan meneruskannya beberapa durasi yang berbeda.

```
//M2WAIT1 JOB 'M2WAIT',CLASS=A,MSGCLASS=X,TIME=1440
//*
//* Copyright Amazon.com, Inc. or its affiliates.* 
//* All Rights Reserved.* 
//*
//*-------------------------------------------------------------------**
//* Wait for 12 Seconds*
//*-------------------------------------------------------------------**
//*
//STEP01 EXEC PGM=M2WAIT,PARM='S012'
//SYSOUT DD SYSOUT=*
//*
//*-------------------------------------------------------------------**
//* Wait for 0 Seconds (defaulted to 10 Seconds)*
//*-------------------------------------------------------------------**
//*
//STEP02 EXEC PGM=M2WAIT,PARM='S000'
//SYSOUT DD SYSOUT=*
//*
//*-------------------------------------------------------------------**
//* Wait for 1 Minute*
//*-------------------------------------------------------------------**
//*
//STEP03 EXEC PGM=M2WAIT,PARM='M001'
//SYSOUT DD SYSOUT=*
//*
//
```

# TXT2Utilitas batch PDF
<a name="txt2pdf"></a>

TXT2PDF adalah program utilitas mainframe yang biasa digunakan untuk mengonversi file teks ke file PDF. Utilitas ini menggunakan kode sumber yang sama untuk TXT2 PDF (z/OSfreeware). Kami memodifikasinya untuk berjalan di bawah lingkungan runtime Perangkat Lunak Roket Modernisasi AWS Mainframe (sebelumnya Micro Focus).

**Topics**
+ [Platform yang didukung](#txt2pdf-platforms)
+ [Konfigurasikan TXT2 PDF untuk Modernisasi AWS Mainframe Dikelola](#txt2pdf-configure-managed)
+ [Konfigurasikan TXT2 PDF untuk runtime Modernisasi AWS Mainframe di Amazon EC2 (termasuk Aplikasi) WorkSpaces](#txt2pdf-configure-customer-infra)
+ [Sampel JCL](#txt2pdf-jcl)
+ [Pengubahan](#txt2pdf-mods)
+ [Referensi](#txt2pdf-ref)

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

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

## Konfigurasikan TXT2 PDF untuk Modernisasi AWS Mainframe Dikelola
<a name="txt2pdf-configure-managed"></a>

Jika aplikasi yang dimigrasi berjalan di Modernisasi AWS Mainframe Dikelola, konfigurasikan TXT2 PDF sebagai berikut.
+ Buat perpustakaan REXX EXEC yang disebut. `AWS.M2.REXX.EXEC` Unduh [modul REXX](https://drm0z31ua8gi7.cloudfront.net/utilities/mf/TXT2PDF/rexx/TXT2PDF_rexx.zip) ini dan salin ke perpustakaan. 
  + `TXT2PDF.rex`- z/OS Freeware TXT2 PDF (dimodifikasi)
  + `TXT2PDFD.rex`- z/OS Freeware TXT2 PDF (tidak dimodifikasi)
  + `TXT2PDFX.rex`- z/OS Freeware TXT2 PDF (dimodifikasi)
  + `M2GETOS.rex`- Untuk memeriksa jenis OS (Windows atau Linux)

Untuk menguji konfigurasi Anda, lihat[Sampel JCL](#txt2pdf-jcl).

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

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

1. Atur variabel lingkungan Rocket Software `MFREXX_CHARSET` ke nilai yang sesuai, seperti “`A`” untuk data ASCII.
**penting**  
Memasukkan nilai yang salah dapat menyebabkan masalah konversi data (dari EBCDIC ke ASCII), membuat PDF yang dihasilkan tidak dapat dibaca atau tidak dapat dioperasikan. Kami merekomendasikan pengaturan `MFREXX_CHARSET` untuk mencocokkan`MF_CHARSET`.

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. Buat perpustakaan REXX EXEC yang disebut. `AWS.M2.REXX.EXEC`` Unduh [modul REXX](https://drm0z31ua8gi7.cloudfront.net/utilities/mf/TXT2PDF/rexx/TXT2PDF_rexx.zip) ini dan salin ke perpustakaan. 
   + `TXT2PDF.rex`- z/OS Freeware TXT2 PDF (dimodifikasi)
   + `TXT2PDFD.rex`- z/OS Freeware TXT2 PDF (tidak dimodifikasi)
   + `TXT2PDFX.rex`- z/OS Freeware TXT2 PDF (dimodifikasi)
   + `M2GETOS.rex`- Untuk memeriksa jenis OS (Windows atau Linux)

Untuk menguji konfigurasi Anda, lihat[Sampel JCL](#txt2pdf-jcl).

## Sampel JCL
<a name="txt2pdf-jcl"></a>

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

**TXT2PDF1.jcl**

Contoh file JCL ini menggunakan nama DD untuk konversi TXT2 PDF.

```
//TXT2PDF1 JOB 'TXT2PDF1',CLASS=A,MSGCLASS=X,TIME=1440
//*
//* Copyright Amazon.com, Inc. or its affiliates.* 
//* All Rights Reserved.* 
//*
//*-------------------------------------------------------------------**
//* PRE DELETE*
//*-------------------------------------------------------------------**
//*
//PREDEL  EXEC PGM=IEFBR14
//* 
//DD01     DD DSN=AWS.M2.TXT2PDF1.PDF.VB,                      
//            DISP=(MOD,DELETE,DELETE)
//*
//DD02     DD DSN=AWS.M2.TXT2PDF1.PDF,                       
//            DISP=(MOD,DELETE,DELETE)
//* 
//*-------------------------------------------------------------------**
//* CALL TXT2PDF TO CONVERT FROM TEXT TO PDF (VB)*
//*-------------------------------------------------------------------**
//*
//STEP01 EXEC PGM=IKJEFT1B
//*
//SYSEXEC  DD DISP=SHR,DSN=AWS.M2.REXX.EXEC
//*
//INDD     DD *
1THIS IS THE FIRST LINE ON THE PAGE 1
0THIS IS THE THIRD LINE ON THE PAGE 1
-THIS IS THE   6TH LINE ON THE PAGE 1
THIS IS THE   7TH LINE ON THE PAGE 1
+____________________________________ - OVERSTRIKE 7TH LINE          
1THIS IS THE FIRST LINE ON THE PAGE 2
0THIS IS THE THIRD LINE ON THE PAGE 2
-THIS IS THE   6TH LINE ON THE PAGE 2 
THIS IS THE   7TH LINE ON THE PAGE 2
+____________________________________ - OVERSTRIKE 7TH LINE                 
/*
//*
//OUTDD    DD DSN=AWS.M2.TXT2PDF1.PDF.VB,
//            DISP=(NEW,CATLG,DELETE),
//            DCB=(LRECL=256,DSORG=PS,RECFM=VB,BLKSIZE=0)
//*
//SYSTSPRT DD SYSOUT=*
//SYSTSIN  DD DDNAME=SYSIN
//*
//SYSIN    DD *
%TXT2PDF BROWSE Y IN DD:INDD +
OUT DD:OUTDD +
CC YES
/*
//*
//*-------------------------------------------------------------------**
//* CONVERT PDF (VB) TO PDF (LSEQ - BYTE STREAM)*
//*-------------------------------------------------------------------**
//* 
//STEP02 EXEC PGM=VB2LSEQ
//*
//INFILE   DD DSN=AWS.M2.TXT2PDF1.PDF.VB,DISP=SHR             
//*
//OUTFILE  DD DSN=AWS.M2.TXT2PDF1.PDF,                      
//            DISP=(NEW,CATLG,DELETE),
//            DCB=(LRECL=256,DSORG=PS,RECFM=LSEQ,BLKSIZE=0)
//*
//SYSOUT   DD SYSOUT=*
//*
//
```

**TXT2PDF2.jcl**

Contoh JCL ini menggunakan nama DSN untuk konversi TXT2 PDF.

```
//TXT2PDF2 JOB 'TXT2PDF2',CLASS=A,MSGCLASS=X,TIME=1440
//*
//* Copyright Amazon.com, Inc. or its affiliates.* 
//* All Rights Reserved.* 
//*
//*-------------------------------------------------------------------**
//* PRE DELETE*
//*-------------------------------------------------------------------**
//*
//PREDEL  EXEC PGM=IEFBR14
//* 
//DD01     DD DSN=AWS.M2.TXT2PDF2.PDF.VB,                      
//            DISP=(MOD,DELETE,DELETE)
//*
//DD02     DD DSN=AWS.M2.TXT2PDF2.PDF,                       
//            DISP=(MOD,DELETE,DELETE)
//* 
//*-------------------------------------------------------------------**
//* CALL TXT2PDF TO CONVERT FROM TEXT TO PDF (VB)*
//*-------------------------------------------------------------------**
//* 
//STEP01 EXEC PGM=IKJEFT1B
//*
//SYSEXEC  DD DISP=SHR,DSN=AWS.M2.REXX.EXEC
//*
//INDD     DD *
1THIS IS THE FIRST LINE ON THE PAGE 1
0THIS IS THE THIRD LINE ON THE PAGE 1
-THIS IS THE   6TH LINE ON THE PAGE 1
THIS IS THE   7TH LINE ON THE PAGE 1
+____________________________________ - OVERSTRIKE 7TH LINE          
1THIS IS THE FIRST LINE ON THE PAGE 2
0THIS IS THE THIRD LINE ON THE PAGE 2
-THIS IS THE   6TH LINE ON THE PAGE 2 
THIS IS THE   7TH LINE ON THE PAGE 2
+____________________________________ - OVERSTRIKE 7TH LINE                 
/*
//*
//SYSTSPRT DD SYSOUT=*
//SYSTSIN  DD DDNAME=SYSIN
//*
//SYSIN    DD *
%TXT2PDF BROWSE Y IN DD:INDD +
OUT 'AWS.M2.TXT2PDF2.PDF.VB' +
CC YES
/*
//*
//*-------------------------------------------------------------------**
//* CONVERT PDF (VB) TO PDF (LSEQ - BYTE STREAM)*
//*-------------------------------------------------------------------**
//*
//STEP02 EXEC PGM=VB2LSEQ
//*
//INFILE   DD DSN=AWS.M2.TXT2PDF2.PDF.VB,DISP=SHR             
//*
//OUTFILE  DD DSN=AWS.M2.TXT2PDF2.PDF,                      
//            DISP=(NEW,CATLG,DELETE),
//            DCB=(LRECL=256,DSORG=PS,RECFM=LSEQ,BLKSIZE=0)
//*
//SYSOUT   DD SYSOUT=*
//*
//
```

## Pengubahan
<a name="txt2pdf-mods"></a>

Untuk membuat program TXT2 PDF berjalan di lingkungan runtime Perangkat Lunak Roket Modernisasi AWS Mainframe, kami membuat perubahan berikut:
+ Perubahan pada kode sumber untuk memastikan kompatibilitas dengan runtime Rocket Software REXX
+ Perubahan untuk memastikan bahwa program dapat berjalan pada sistem operasi Windows dan Linux
+ Modifikasi untuk mendukung runtime EBCDIC dan ASCII

## Referensi
<a name="txt2pdf-ref"></a>

TXT2Referensi PDF dan kode sumber:
+ [Konverter teks ke PDF](https://homerow.net/rexx/txt2pdf/)
+ [z/OSFreeware TCP/IP dan Mail Tools](http://www.lbdsoftware.com/tcpip.html)
+ [TXT2Panduan Referensi Pengguna PDF](http://www.lbdsoftware.com/TXT2PDF-User-Guide.pdf)

# Utilitas batch M2DFUTIL
<a name="m2dfutil"></a>

M2DFUTIL adalah program utilitas JCL yang menyediakan fungsi backup, restore, delete, dan copy pada dataset, mirip dengan dukungan yang disediakan oleh utilitas mainframe ADRDSSU. Program ini mempertahankan banyak parameter SYSIN dari ADRDSSU, yang merampingkan proses untuk bermigrasi ke utilitas baru ini.

**Topics**
+ [Platform yang didukung](#m2dfutil-platforms)
+ [Persyaratan platform](#m2dfutil-platform)
+ [Dukungan future yang direncanakan](#m2udfutil-future-support)
+ [Lokasi aset](#mdfutil-assets)
+ [Konfigurasikan runtime Modernisasi M2DFUTIL atau AWS Mainframe di Amazon EC2 (termasuk 2.0) AppStream](#mdfutil-dependencies)
+ [Sintaks umum](#mdfutil-syntax)
+ [Sampel JCLs](#mdfutil-sample-jcls)

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

Anda dapat menggunakan M2DFUTIL di salah satu platform berikut:
+ Perangkat Lunak Rocket (sebelumnya Micro Focus) ES pada Windows (64 bit dan 32 bit)
+ Perangkat Lunak Roket ES di Linux (64 bit)

## Persyaratan platform
<a name="m2dfutil-platform"></a>

M2DFUTIL bergantung pada memanggil skrip untuk melakukan tes ekspresi reguler. Di Windows, Anda harus menginstal Windows Services for Linux (WSL) agar skrip ini dapat dijalankan.

## Dukungan future yang direncanakan
<a name="m2udfutil-future-support"></a>

Fitur yang saat ini tidak tersedia dari utilitas ADRDSSU mainframe, tetapi berada dalam lingkup future meliputi: 
+ M2 Dikelola
+ VSAM
+ Dukungan COPY untuk penggantian nama file
+ Ganti nama dukungan untuk RESTORE 
+ Beberapa INCLUDE dan EXCLUDE
+ BY klausa untuk subpemilihan oleh DSORG, CREDT, EXPDT
+ Klausa MWAIT untuk mencoba lagi kegagalan enqueue
+ Dukungan penyimpanan S3 untuk DUMP/RESTORE

## Lokasi aset
<a name="mdfutil-assets"></a>

Modul beban untuk utilitas ini disebut `M2DFUTIL.so` di Linux dan `M2DFUTIL.dll` Windows. Modul beban ini dapat ditemukan di lokasi berikut:
+ 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`

Script yang digunakan untuk pengujian ekspresi reguler disebut`compare.sh`. Skrip ini dapat ditemukan di lokasi berikut:
+ Linux: `/opt/aws/m2/microfocus/utilities/scripts`
+ Windows (32 bit): `C:\AWS\M2\MicroFocus\Utilities\scripts`

## Konfigurasikan runtime Modernisasi M2DFUTIL atau AWS Mainframe di Amazon EC2 (termasuk 2.0) AppStream
<a name="mdfutil-dependencies"></a>

Konfigurasikan wilayah Server Perusahaan Anda dengan yang berikut:
+ Tambahkan variabel berikut di **[ES-Environment**]
  + `M2DFUTILS_BASE_LOC`- Lokasi default untuk output DUMP
  + `M2DFUTILS_SCRIPTPATH`- Lokasi `compare.sh` skrip yang didokumentasikan di **Lokasi Aset**
  + `M2DFUTILS_VERBOSE`- [VERBOSE atau NORMAL]. Ini mengontrol tingkat detail dalam `SYSPRINT ` output
+ Verifikasi bahwa jalur modul beban ditambahkan ke `JES\Configuration\JES Program Path` pengaturan
+ Verifikasi bahwa skrip di direktori utilitas telah menjalankan izin. Anda dapat menambahkan izin jalankan menggunakan `chmod + x <script name>` perintah, di lingkungan Linux

## Sintaks umum
<a name="mdfutil-syntax"></a>

### MEMBUANG
<a name="mdfutil-dump"></a>

Menyediakan kemampuan untuk menyalin file dari lokasi katalog saat ini ke lokasi cadangan. Lokasi ini saat ini harus berupa sistem file.

#### Proses
<a name="mdfutil-dump-process"></a>

DUMP akan melakukan hal berikut:

1. Buat direktori lokasi target.

1. Katalog direktori lokasi target sebagai anggota PDS.

1. Tentukan file yang akan disertakan dengan memproses parameter INCLUDE.

1. Hapus pilihan file yang disertakan dengan memproses parameter EXCLUDE.

1. Tentukan apakah file yang dibuang akan DIHAPUS.

1. Enqueue file yang akan diproses.

1. Salin file.

1. Ekspor file yang disalin yang dikatalogkan informasi DCB ke file samping di lokasi target untuk membantu operasi RESTORE future.

#### Sintaksis
<a name="mdfutil-dump-syntax"></a>

```
DUMP
TARGET ( TARGET LOCATION  )    -
INCLUDE ( DSN. )
[ EXCLUDE ( DSN ) ]
[ CANCEL | IGNORE ]
[ DELETE ]
```

#### Parameter yang diperlukan
<a name="mdfutil-dump-requiredparam"></a>

Berikut ini adalah parameter yang diperlukan untuk DUMP:
+ `SYSPRINT DD NAME`- Untuk memuat informasi pencatatan tambahan
+ `TARGET`- Lokasi target. Itu bisa berupa:
  + Jalur lengkap lokasi pembuangan
  + Nama subdirektori dibuat di lokasi yang ditentukan dalam variabel **M2DFUTILS\$1BASE\$1LOC**
+ `INCLUDE`- Entah DSNAME bernama tunggal atau string pencarian DSN mainframe yang valid
+ `EXCLUDE`- Entah DSNAME bernama tunggal atau string pencarian DSN mainframe yang valid

#### Parameter opsional
<a name="mdfutil-dump-optionalparam"></a>
+ BATAL - Batalkan jika terjadi kesalahan. File yang diproses akan disimpan
+ (Default) IGNORE - Abaikan kesalahan dan proses sampai akhir
+ DELETE - Jika tidak ada kesalahan ENQ terjadi, maka file tersebut dihapus dan tidak dikatalogkan

### DELETE
<a name="mdfutil-delete"></a>

Memberikan kemampuan untuk menghapus massal dan file uncatalog. File tidak dicadangkan.

#### Proses
<a name="mdfutil-delete-process"></a>

DELETE akan melakukan hal berikut:

1. Tentukan file yang akan disertakan dengan memproses parameter INCLUDE.

1. Hapus pilihan file yang disertakan dengan memproses parameter EXCLUDE.

1. Enqueue file yang akan diproses. Mengatur disposisi ke OLD, DELETE, KEEP.

#### Sintaksis
<a name="mdfutil-delete-syntax"></a>

```
DELETE
INCLUDE ( DSN )
[ EXCLUDE ( DSN ) ]
[ CANCEL | IGNORE ]
[ DELETE ]
```

#### Parameter yang diperlukan
<a name="mdfutil-delete-requiredparam"></a>

Berikut ini adalah parameter yang diperlukan untuk DELETE:
+ `SYSPRINT DD NAME`- Untuk memuat informasi pencatatan tambahan
+ `INCLUDE`- Entah DSNAME bernama tunggal atau string pencarian DSN mainframe yang valid 
+ `EXCLUDE`- Entah DSNAME bernama tunggal atau string pencarian DSN mainframe yang valid 

#### Parameter opsional
<a name="mdfutil-delete-optionalparam"></a>
+ BATAL - Batalkan jika terjadi kesalahan. File yang diproses akan disimpan 
+ (Default) IGNORE - Abaikan kesalahan dan proses sampai akhir

### MEMULIHKAN
<a name="mdfutil-restore"></a>

Memberikan kemampuan untuk memulihkan file yang sebelumnya dicadangkan menggunakan DUMP. File dikembalikan ke lokasi katalog asli kecuali RENAME digunakan untuk mengubah DSNAME yang dipulihkan.

#### Proses
<a name="mdfutil-restore-process"></a>

RESTORE akan melakukan hal berikut:

1. Validasi direktori lokasi sumber.

1. Tentukan file yang akan disertakan dengan memproses file ekspor katalog.

1. Hapus pilihan file yang disertakan dengan memproses parameter EXCLUDE.

1. Enqueue file yang akan diproses.

1. File katalog yang tidak dikatalogkan berdasarkan informasi ekspornya.

1. Jika file sudah dikatalogkan dan informasi katalog ekspor sama, RESTORE akan menggantikan kumpulan data yang dikatalogkan jika opsi REPLACE disetel.

#### Sintaksis
<a name="mdfutil-restore-syntax"></a>

```
RESTORE
SOURCE ( TARGET LOCATION ) 
INCLUDE ( DSN )
[ EXCLUDE ( DSN ) ]
[ CANCEL | IGNORE ]
[ REPLACE]
```

#### Parameter yang diperlukan
<a name="mdfutil-restore-requiredparam"></a>

Berikut ini adalah parameter yang diperlukan untuk RESTORE:
+ `SYSPRINT DD NAME`- Untuk memuat informasi pencatatan tambahan 
+ `SOURCE`- Lokasi sumber. Itu bisa berupa:
  + Jalur lengkap lokasi pembuangan
  + Nama subdirektori dibuat di lokasi yang ditentukan dalam variabel **M2DFUTILS\$1BASE\$1LOC**
+ `INCLUDE`- Entah DSNAME bernama tunggal atau string pencarian DSN mainframe yang valid
+ `EXCLUDE`- Entah DSNAME bernama tunggal atau string pencarian DSN mainframe yang valid

#### Parameter opsional
<a name="mdfutil-restore-optionalparam"></a>
+ BATAL - Batalkan jika ada kesalahan. File yang diproses dipertahankan
+ (Default) IGNORE - Abaikan kesalahan dan proses sampai akhir
+ REPLACE - Jika file yang dipulihkan sudah dikatalogkan dan catatan katalognya sama, maka ganti file yang dikatalogkan

## Sampel JCLs
<a name="mdfutil-sample-jcls"></a>

 **Pekerjaan DUMP**

Pekerjaan ini akan membuat subdirektori yang disebut`TESTDUMP`. Ini adalah lokasi cadangan default yang ditentukan oleh variabel **M2DFUTILS\$1BASE\$1LOC**. Ini akan membuat pustaka PDS untuk cadangan ini disebut`M2DFUTILS.TESTDUMP`. Data katalog yang diekspor disimpan dalam file berurutan baris di direktori cadangan yang disebut. `CATDUMP.DAT` Semua file yang dipilih akan disalin ke direktori cadangan ini.

```
//M2DFDMP JOB 'M2DFDMP',CLASS=A,MSGCLASS=X
//STEP001  EXEC PGM=M2DFUTIL
//SYSPRINT DD DSN=TESTDUMP.SYSPRINT,
//        DISP=(NEW,CATLG,DELETE),
//        DCB=(RECFM=LSEQ,LRECL=256)
//SYSIN    DD *
DUMP TARGET(TESTDUMP)               -
     INCLUDE(TEST.FB.FILE*.ABC)     -
 CANCEL
/*
//
```

 **HAPUS pekerjaan**

Pekerjaan ini akan menghapus semua file dari katalog yang cocok dengan parameter INCLUDE.

```
/M2DFDEL JOB 'M2DFDEL',CLASS=A,MSGCLASS=X
//STEP001  EXEC PGM=M2DFUTIL
//SYSPRINT DD DSN=TESTDEL.SYSPRINT,
//        DISP=(NEW,CATLG,DELETE),
//        DCB=(RECFM=LSEQ,LRECL=256)
//SYSPRINT DD SYSOUT=A
//SYSIN    DD *
  DELETE                               -
     INCLUDE(TEST.FB.FILE*.ABC)        -
 CANCEL
/*
 //
```

 **MENGEMBALIKAN pekerjaan**

Pekerjaan ini akan mengembalikan file yang cocok dengan parameter INCLUDE dari lokasi `TESTDUMP` cadangan. File yang dikatalogkan akan diganti jika file yang dikatalogkan sama dengan yang ada di ekspor CATDUMP dan opsi REPLACE ditentukan.

```
//M2DFREST JOB 'M2DFREST',CLASS=A,MSGCLASS=X
//STEP001  EXEC PGM=M2DFUTIL
////SYSPRINT DD DSN=TESTREST.SYSPRINT,
//        DISP=(NEW,CATLG,DELETE),
//        DCB=(RECFM=LSEQ,LRECL=256)
//SYSPRINT DD SYSOUT=A
//SYSIN    DD *
RESTORE SOURCE(TESTDUMP)               -
     INCLUDE(TEST.FB.FILE*.ABC)        -
 IGNORE
 REPLACE
/*
//
```

# Utilitas batch M2RUNCMD
<a name="m2runcmd"></a>

Anda dapat menggunakan M2RUNCMD, program utilitas batch, untuk menjalankan perintah, skrip, dan panggilan sistem Rocket Software (sebelumnya Micro Focus) langsung dari JCL alih-alih menjalankannya dari terminal atau command prompt. Output dari perintah dicatat ke log spool pekerjaan batch.

**Topics**
+ [Platform yang didukung](#m2runcmd-platforms)
+ [Konfigurasikan M2RUNCMD untuk runtime Modernisasi AWS Mainframe di Amazon EC2 (termasuk 2.0) AppStream](#m2runcmd-configure)
+ [Sampel JCLs](#m2runcmd-sample-jcls)

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

Anda dapat menggunakan M2RUNCMD pada platform berikut:
+ Runtime Perangkat Lunak Roket (di Amazon EC2)
+  Semua varian produk Rocket Software Enterprise Developer (ED) dan Rocket Software Enterprise Server (ES).

## Konfigurasikan M2RUNCMD untuk runtime Modernisasi AWS Mainframe di Amazon EC2 (termasuk 2.0) AppStream
<a name="m2runcmd-configure"></a>

Jika aplikasi yang dimigrasi berjalan pada runtime Modernisasi AWS Mainframe di Amazon EC2, konfigurasikan M2RUNCMD sebagai berikut.
+ Ubah [Jalur Program Micro Focus JES](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/index.html?t=GUID-BC8A1796-9EDE-48EB-8363-31C9BDE7F96B.html) untuk menyertakan lokasi biner untuk utilitas batch. Jika Anda harus 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`

## Sampel JCLs
<a name="m2runcmd-sample-jcls"></a>

Untuk menguji instalasi, Anda dapat menggunakan salah satu dari sampel berikut JCLs.

 **RUNSCRL1.jcl**

Contoh JCL ini membuat skrip dan menjalankannya. Langkah pertama membuat skrip yang disebut `/tmp/TEST_SCRIPT.sh` dan dengan konten dari data `SYSUT1` in-stream. Langkah kedua menetapkan izin jalankan dan menjalankan skrip yang dibuat pada langkah pertama. Anda juga dapat memilih untuk hanya melakukan langkah kedua untuk menjalankan Perangkat Lunak Roket dan perintah sistem yang sudah ada.

```
//RUNSCRL1 JOB 'RUN SCRIPT',CLASS=A,MSGCLASS=X,TIME=1440
//*
//*
//*-------------------------------------------------------------------*
//*  CREATE SCRIPT (LINUX)                                           
//*-------------------------------------------------------------------*
//*
//STEP0010 EXEC PGM=IEBGENER
//*
//SYSPRINT DD SYSOUT=*
//SYSIN    DD DUMMY
//*
//SYSUT1   DD *
#!/bin/bash

set -x

## ECHO PATH ENVIRONMNET VARIABLE
echo $PATH

## CLOSE/DISABLE VSAM FILE
casfile -r$ES_SERVER -oc  -ed -dACCTFIL

## OPEN/ENABLE VSAM FILE
casfile -r$ES_SERVER -ooi -ee -dACCTFIL

exit $?
/*
//SYSUT2   DD DSN=&&TEMP,
//            DISP=(NEW,CATLG,DELETE),
//            DCB=(RECFM=LSEQ,LRECL=300,DSORG=PS,BLKSIZE=0)
//*MFE: %PCDSN='/tmp/TEST_SCRIPT.sh'
//*
//*-------------------------------------------------------------------*
//*   RUN SCRIPT (LINUX)                                              *
//*-------------------------------------------------------------------*
//*
//STEP0020 EXEC PGM=RUNCMD
//*
//SYSOUT  DD  SYSOUT=*
//* 
//SYSIN   DD *
*RUN SCRIPT
 sh /tmp/TEST_SCRIPT.sh
/*
//
```

 **SYSOUT**

Output dari perintah atau script yang dijalankan, ditulis ke dalam `SYSOUT` log. Untuk setiap perintah yang dilakukan, ini menampilkan perintah, output, dan kode pengembalian.

```
************ CMD Start ************   
                                                                                    
CMD_STR: sh /tmp/TEST_SCRIPT.sh                                                                                              
CMD_OUT:                                                                                                                                                                                                                             
+ echo /opt/microfocus/EnterpriseServer/bin:/sbin:/bin:/usr/sbin:/usr/bin    
/opt/microfocus/EnterpriseServer/bin:/sbin:/bin:/usr/sbin:/usr/bin           
+ casfile -rMYDEV -oc -ed -dACCTFIL                                                                       
-Return Code:   0                                                                                                         
Highest return code:    0                                                                                                 
+ casfile -rMYDEV -ooi -ee -dACCTFIL                                                                     
-Return Code:   8                                                                                                         
Highest return code:    8                                                                                                 
+ exit 8                                                                                                                  

CMD_RC=8                                                                                                                  

************  CMD End  ************
```

 **RUNCMDL1.jcl**

Contoh JCL ini menggunakan RUNCMD untuk menjalankan beberapa perintah.

```
//RUNCMDL1 JOB 'RUN CMD',CLASS=A,MSGCLASS=X,TIME=1440
//*
//*
//*-------------------------------------------------------------------*
//*   RUN SYSTEM COMMANDS                                             *
//*-------------------------------------------------------------------*
//*
//STEP0001 EXEC PGM=RUNCMD
//*
//SYSOUT  DD  SYSOUT=*
//* 
//SYSIN   DD *
*LIST DIRECTORY
 ls
*ECHO PATH ENVIRONMNET VARIABLE
 echo $PATH
/*
//
```