

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.

# AWS Modernisasi Mainframe Replatforming dengan NTT DATA
<a name="unikix"></a>

AWS Modernisasi Mainframe menawarkan berbagai Amazon Machine Images (AMI). AMI ini memfasilitasi penyediaan cepat instans Amazon EC2, menciptakan lingkungan yang disesuaikan untuk rehosting dan replatforming aplikasi mainframe dengan menggunakan Data NTT. AWS Panduan ini memberikan langkah-langkah yang diperlukan untuk mengakses dan menggunakannya AMIs. 

## Prasyarat
<a name="prereqs-unikix"></a>
+ Pastikan Anda memiliki akses administrator ke AWS akun tempat Anda dapat membuat instans Amazon EC2.
+ Pastikan layanan Modernisasi AWS Mainframe tersedia di Wilayah tempat Anda berencana membuat instans Amazon EC2. Lihat [Daftar Layanan AWS yang Tersedia berdasarkan Wilayah](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/).
+ Identifikasi VPC Amazon tempat Anda ingin membuat instans Amazon EC2.

## Berlangganan Gambar Mesin Amazon
<a name="subscribe-to-images-unikix"></a>

Saat berlangganan produk AWS Marketplace, Anda dapat meluncurkan instans dari AMI produk.

1. Masuk ke Konsol Manajemen AWS dan buka AWS Marketplace konsol di [https://console.aws.amazon.com/marketplace](https://console.aws.amazon.com/marketplace).

1. Pilih **Kelola langganan**.

1. Salin dan tempel tautan berikut ke bilah alamat browser: [https://aws.amazon.com/marketplace/pp/prodview-eg227ymldsnx2](https://aws.amazon.com/marketplace/pp/prodview-eg227ymldsnx2)

1. Pilih **Lanjutkan Berlangganan**.

1. Jika syarat dan ketentuan dapat diterima, pilih **Terima Syarat**. Langganan mungkin memakan waktu beberapa menit untuk diproses.

1. Tunggu pesan terima kasih muncul. Pesan ini mengonfirmasi bahwa Anda telah berhasil berlangganan produk.

1. Di panel navigasi kiri, pilih **Kelola langganan**. Tampilan ini menunjukkan semua langganan Anda.

## Luncurkan replatform Modernisasi AWS Mainframe dengan instans DATA NTT
<a name="launch-data-replatform-unikix"></a>

1. Buka AWS Marketplace konsol di [https://console.aws.amazon.com/marketplace](https://console.aws.amazon.com/marketplace).

1. Di panel navigasi kiri, pilih **Kelola langganan**.

1. Temukan AMI yang ingin Anda luncurkan, dan pilih **Luncurkan instance baru**.

1. Di bawah **Wilayah**, pilih Wilayah yang diizinkan terdaftar.

1. Pilih **Lanjutkan untuk meluncurkan melalui EC2**. Tindakan ini membawa Anda ke konsol Amazon EC2.

1. Masukkan nama untuk server.

1. Pilih jenis instans yang sesuai dengan kinerja proyek dan persyaratan biaya Anda. Titik awal yang disarankan untuk ukuran misalnya adalah`c5.2xLarge`.

1. Pilih key pair yang ada atau buat dan simpan yang baru. Untuk informasi tentang pasangan kunci, lihat [pasangan kunci Amazon EC2 dan instans Linux](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html) di Panduan Pengguna Amazon EC2.

1. Edit pengaturan jaringan dan pilih VPC yang terdaftar yang diizinkan dan subnet yang sesuai.

1. Pilih grup keamanan yang ada atau buat yang baru. Jika ini adalah contoh Enterprise Server Amazon EC2, biasanya memungkinkan lalu lintas TCP ke port 86 dan 10086 untuk mengelola konfigurasi Perangkat Lunak Rocket (sebelumnya Micro Focus).

1. Konfigurasikan penyimpanan untuk instans Amazon EC2.

1. Tinjau ringkasan dan pilih **Launch instance**. Agar peluncuran berhasil, jenis instance harus valid. Jika peluncuran gagal, pilih **Edit konfigurasi instans** dan pilih jenis instans yang berbeda.

1. Setelah Anda melihat pesan sukses, pilih **Connect to instance**.

1. Buka konsol Amazon EC2 di. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)

1. **Di panel navigasi kiri, di bawah menu **Instans**, pilih Instans.**

1. Di panel utama, periksa status instans Anda.

## Memulai dengan Data NTT
<a name="unikix-getting-started"></a>

Setelah Anda menyediakan instans Amazon EC2, SSH ke dalamnya dengan nama pengguna. `ec2-user` Layar akan terlihat seperti gambar berikut.

![\[Layar SSH dengan instans Amazon EC2 dan nama pengguna yang disediakan.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/unikix-start-screen.png)


Di bawah `/opt/software/` folder, ada folder bernama`UniKix_Product_Guides`, seperti yang ditunjukkan pada gambar berikut.

![\[Layar SSH dengan detail /opt/software/ folder. Temukan foldernyaUniKix_Product_Guides.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/unikix-product-guides.png)


`UniKix_Product_Guides`Folder tersebut menyertakan dokumentasi untuk komponen berikut yang diinstal pada instans Amazon EC2 ini:
+ NTT DATA TPE
+ NTT DATA BPE
+ NTT DATA Perusahaan COBOL
+ NTT DATA Aman UniKix 
+ Manajer Pusat DATA UniKix NTT

`software`Folder yang muncul pada gambar sebelumnya memiliki binari untuk komponen yang tercantum di atas.

Setelah Anda berhasil memvalidasi instans Amazon EC2, mulailah AWS menggunakan Mainframe Modernization Replatform dengan NTT DATA dengan mengikuti dokumentasi Data NTT.

# Tutorial: Menyebarkan CardDemo aplikasi pada DATA NTT
<a name="tutorial-unikix-runtime"></a>

Halaman ini memandu Anda melalui step-by-step proses penerapan aplikasi CardDemo sampel pada replatform Modernisasi AWS Mainframe dengan runtime NTT DATA Unikix.

Aplikasi CardDemo sampel adalah aplikasi mainframe yang disederhanakan yang dirancang dan dikembangkan untuk menguji dan menampilkan dan teknologi mitra untuk migrasi mainframe AWS dan kasus penggunaan modernisasi. 

Untuk informasi lebih lanjut tentang aplikasi ini, lihat, [GitHubrepositori](https://github.com/aws-samples/aws-mainframe-modernization-carddemo) untuk. CardDemo

**Topics**
+ [Diagram alir penyebaran](#tutorial-unikix-workflow)
+ [Prasyarat](#tutorial-unikix-prerequisites)
+ [Langkah 1: Siapkan lingkungan](#tutorial-unikix-prepare)
+ [Langkah 2: Buat wilayah TPE](#tutorial-unikix-tpe)
+ [Langkah 3: Buat node BPE dan subsistem](#tutorial-unikix-bpe)
+ [Langkah 4: Kompilasi dan terapkan aplikasi CardDemo](#tutorial-unikix-compile)
+ [Langkah 5: Impor katalog BPE dan TPE](#tutorial-unikix-import)
+ [Langkah 6: Mulai dan hubungkan TPE dengan BPE](#unikix-tutorial-connect)
+ [Langkah 7: Jalankan CardDemo aplikasi](#unikix-tutorial-run-application)
+ [Pemecahan masalah](#tutorial-unikix-troubleshoot)

## Diagram alir penyebaran
<a name="tutorial-unikix-workflow"></a>

Diagram berikut menunjukkan setiap langkah dalam alur kerja untuk menerapkan aplikasi pada runtime NTT DATA Unikix.

![\[Alur kerja keseluruhan penerapan aplikasi pada runtime NTT DATA Unikix.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/unikix-process.png)


## Prasyarat
<a name="tutorial-unikix-prerequisites"></a>
+ Ikuti petunjuk yang diberikan dalam [AWS Modernisasi Mainframe Replatforming dengan NTT DATA](unikix.md) menggunakan [NTT DATA Marketplace UniKix AMI](https://aws.amazon.com/marketplace/pp/prodview-eg227ymldsnx2).
+ Ubah opsi metadata instans **IMDSv2**menjadi **Opsional** seperti yang disebutkan dalam [Kembalikan penggunaan IMDSv1](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-IMDS-existing-instances.html) dalam panduan pengguna *Amazon EC2*.
+ Unduh komponen CardDemo runtime untuk NTT DATA dari UniKix 

  [GitHub repositori](https://github.com/aws-samples/aws-mainframe-modernization-carddemo/blob/main/samples/m2/unikix/UniKix_CardDemo_runtime_v1.zip).
+ Masuk ke instance EC2 UniKix runtime sebagai. `ec2-user`
+ Ekstrak komponen CardDemo runtime yang diunduh menggunakan tautan ini: [UniKix\$1 CardDemo \$1runtime\$1v1.zip](https://github.com/aws-samples/aws-mainframe-modernization-carddemo/blob/main/samples/m2/unikix/UniKix_CardDemo_runtime_v1.zip).
  + Direktori yang diekstrak harus berisi `bin` dan `migrated_app` direktori.
  + Pindahkan keduanya `bin` dan `migrated_app` direktori di bawah `$HOME` direktori Anda. Jalannya akan terlihat seperti`/home/ec2-user`.
  + Anda harus memiliki direktori berikut di: `$HOME`
    + `/home/ec2-user/bin`
    + `/home/ec2-user/migrated_app`
  + Pindahkan semua file di dalam direktori \$1HOME/bin perintah berikut:
  + 
    + `chmod +x $HOME/bin/*`

## Langkah 1: Siapkan lingkungan
<a name="tutorial-unikix-prepare"></a>

Setelah menyelesaikan prasyarat, langkah pertama adalah menyiapkan lingkungan tempat Anda ingin menyebarkan aplikasi. CardDemo 

1. Masuk ke instance EC2 UniKix runtime sebagai. `ec2-user`

1. Amati daftar UniKix perangkat lunak yang dikemas dalam AMI, seperti TPE, BPE, dan COBOL, bersama dengan yang lain dari lokasi UniKix produk NTT DATA dengan menggunakan perintah berikut dalam instans EC2 Anda:

   ```
   ls -l /opt/software/
   ```

1. Periksa CardDemo aplikasi yang dimigrasi. Anda akan melihat semua kode sumber, termasuk peta BMS, program COBOL, Copybook COBOL, dan. JCLs Anda juga akan menemukan ekspor katalog BPE dan TPE, definisi sumber daya CICS, dan data yang dimigrasi seperti file sekuensial dan file VSAM dengan melakukan ini:

   ```
   ls  $HOME/migrated_app/*/*
   ```

1. Buat struktur folder dengan menjalankan `create_project` skrip dengan perintah berikut:

   ```
   sh $HOME/bin/create_project
   ```

1. Aktifkan CardDemo lingkungan dengan mencari file `carddemo.env` penyiapan menggunakan:

   ```
   source $HOME/bin/carddemo.env
   ```

## Langkah 2: Buat wilayah TPE
<a name="tutorial-unikix-tpe"></a>

Setelah Anda mengaktifkan lingkungan tempat Anda ingin menyebarkan aplikasi, Anda perlu membuat wilayah TPE.

1. Buat wilayah TPE menggunakan `kixregion createRegion` perintah yang membutuhkan input seperti`$KIXSYS`,`$JAVA_HOME`, dan. `$KIXLICDIR` Variabel lingkungan ini sudah diatur dalam file `carddemo.env` setup.

   ```
   kixregion createRegion $KIXSYS $JAVA_HOME $KIXLICDIR
   ```

1. Konfigurasikan wilayah TPE menggunakan `kixregion setAttr` perintah.

   ```
   kixregion setAttr $KIXSYS server.tx.languages.cobol.enabled true
   kixregion setAttr $KIXSYS server.tx.languages.cobol.flavor vcobol
   kixregion setAttr $KIXSYS server.tx.languages.cobol.home $VCOBOL
   kixregion setAttr $KIXSYS maps.location $PROJECT_ROOT/maps
   kixregion setAttr $KIXSYS programs.location $PROJECT_ROOT/loadlib
   kixregion setAttr $KIXSYS environment.KIXDATA $KIXDATA
   kixregion setAttr $KIXSYS td.jobq.submission.node $EBMHOME
   kixregion setAttr $KIXSYS td.jobq.submission.subsys $EBMSYS
   ```

1. Hasilkan file lingkungan pengguna khusus untuk wilayah TPE ini dengan menjalankan perintah. `kixregion createScript` Perintah ini membuat atau memperbarui `$KIXSYS/bin/userenv` berdasarkan konfigurasi wilayah TPE.

   ```
   kixregion createScript $KIXSYS
   ```

1. Aktifkan wilayah TPE dengan mencari file lingkungan pengguna (`$KIXSYS/bin/userenv`).

   ```
   source $KIXSYS/bin/userenv
   ```

1. Bangun wilayah TPE dengan menjalankan `kixinstall2` perintah.

   ```
   kixinstall2
   ```

## Langkah 3: Buat node BPE dan subsistem
<a name="tutorial-unikix-bpe"></a>

Setelah membuat wilayah TPE, Anda perlu membuat node dan subsistem BPE dengan mengikuti langkah-langkah ini.

1. Ubah kepemilikan dan izin. `INSTEBM`

   ```
   sudo chown root $INSTEBM 
   sudo chmod 4755 $INSTEBM
   ```

1. Buat node BPE menggunakan `INSTEBM` perintah. Direktori node BPE disediakan sebagai parameter input.

   ```
   $INSTEBM $EBMHOME
   ```

1. Aktifkan lingkungan batch dengan mencari `batchenv` file dari node BPE yang baru dibuat.

   ```
   source $EBMHOME/batchenv
   ```

1. Buat subsistem BPE dalam node ini menggunakan Batch Administration Manager (bam). `bam`Perintah akan membuka antarmuka Manajer Administrasi Batch.

   ```
   bam
   ```

   1. Mulai node BPE menggunakan antarmuka BAM. Pilih opsi 2, **Lingkungan Sistem** dari menu utama.  
![\[Di Manajer Administrator Batch, pilih opsi 2 Lingkungan Sistem.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/unikix-bpe-1.png)

   1. Pilih opsi 2, **Mulai/ (Berhenti) Batch Node untuk memulai node** BPE.   
![\[Di System Environments, pilih opsi 2 Start/Stop batch node.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/unikix-bpe-2.png)

   1. Setelah dimulai, tekan **tombol Return** dua kali untuk kembali ke menu utama BAM.  
![\[Layar selesai Batch Node Startup.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/unikix-bpe-3.png)

   1. Untuk membuat subsistem BPE, pilih opsi 3, **Aplikasi &** Subsistem.  
![\[Opsi 3 Aplikasi dan Subsistem dipilih pada halaman Manajer Administrator Batch.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/unikix-bpe-4.png)

   1. Kemudian pilih opsi 3, **Buat Subsistem**.  
![\[Opsi 3 Buat Subsistem yang dipilih pada layar Aplikasi dan Subsistem.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/unikix-bpe-5.png)

   1. Masukkan nama subsistem sebagai`sys1`.  
![\[Memasukkan sys1 di layar Buat.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/unikix-bpe-6.png)

   1. Pilih opsi 3, **Manajemen Data**.  
![\[Pilih opsi 3 Manajemen Data di Buat layar di Aplikasi dan Subsistem.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/unikix-bpe-7.png)

   1. Pilih opsi 5, karena CardDemo aplikasi melibatkan file sekuensial dan VSAM.  
![\[Pilih opsi 5 untuk menyertakan file sekuensial dan VSAM.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/unikix-bpe-8.png)

   1. (Opsional). Tekan “R” untuk kembali ke halaman **Buat Menu**, tinjau berbagai opsi konfigurasi yang tersedia.

   1. Pada halaman **Buat**, masukkan “C” untuk membuat subsistem`sys1`.  
![\[Tekan “C” pada keyboard untuk membuat subsistem sys1.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/unikix-bpe-9.png)

   1. Tinjau pengaturan, dan masukkan “C” untuk melanjutkan pengaturan lingkungan lainnya. Pengaturan lingkungan ini telah diisi sebelumnya karena variabel lingkungan yang diperlukan yang ditentukan dalam file `carddemo.env` pengaturan dan struktur folder yang direkomendasikan berada di tempatnya.

   1. Masukkan “y” untuk mengonfirmasi dan menyimpan pengaturan lingkungan saat ini.  
![\[Menampilkan pengaturan lingkungan subsistem sys1 selesai. Juga ketik “y” untuk menyimpan pengaturan saat ini.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/unikix-bpe-10.png)

   1. Masukkan “y” untuk menampilkan log saat membangun subsistem.  
![\[Menunjukkan membangun sistem runtime NTT DATA COBOL sys1 di layar.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/unikix-bpe-11.png)

   1. Tekan **tombol Return** sampai Anda kembali ke Menu Utama dan keluar dari antarmuka BAM dengan memilih opsi **Quit**.  
![\[Menampilkan sistem runtime COBOL yang dibuat. Juga meminta untuk menekan Kembali untuk melanjutkan.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/unikix-bpe-12.png)  
![\[Kembali ke menu Create dan menunjukkan subsistem sys1 dibuat. Dan konfigurasi diperbarui. Prompt untuk menekan kembali untuk melanjutkan.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/unikix-bpe-13.png)  
![\[Menu Utama untuk Administrator Batch. Meminta masuk Q untuk keluar dari menu ini.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/unikix-bpe-14.png)

1. Aktifkan subsistem BPE dengan mencari nama `batchenv` subsistem. `sys1`

   ```
   source $EBMHOME/batchenv sys1
   ```

## Langkah 4: Kompilasi dan terapkan aplikasi CardDemo
<a name="tutorial-unikix-compile"></a>

Pada langkah ini, Anda mengkompilasi program COBOL dan menyebarkan artefak aplikasi seperti JCL, prosedur, file data, dan definisi sumber daya CICS.

1. Aktifkan CardDemo lingkungan lagi dengan mencari file `carddemo.env` pengaturan.

   ```
   source $HOME/bin/carddemo.env
   ```

1. Arahkan ke direktori sumber COBOL.

   ```
   cd $MIGAPP_DIR/cbl
   ```

1. Kompilasi program Cobol `CBACT01C.cbl` menggunakan `compile` skrip.

   ```
   compile CBACT01C.cbl
   ```

1. Kompilasi semua program Cobol menggunakan `compile.all` skrip.

   ```
   compile.all
   ```

1. Arahkan ke direktori sumber peta BMS.

   ```
   cd $MIGAPP_DIR/bms
   ```

1. Kompilasi peta BMS `COACTUP.bms` menggunakan `compbms` skrip.

   ```
   compbms COACTUP.bms
   ```

1. Kompilasi semua peta BMS menggunakan `compbms.all` skrip.

   ```
   compbms.all
   ```

1. Verifikasi binari yang dikompilasi untuk peta COBOL dan BMS.

   ```
   ls $PROJECT_ROOT/loadlib
   ls $PROJECT_ROOT/maps
   ```

1. Menyebarkan artefak aplikasi lain seperti JCL, prosedur, file data, dan definisi sumber daya CICS menggunakan skrip. `deploy_app`

   ```
   deploy_app
   ```

1. Arahkan ke direktori proyek JCL.

   ```
   cd $PROJECT_ROOT/jcl
   ```

1. Terjemahkan JCL ACCTFILE ke BPE JCL Macro. Gunakan `mvstrans` perintah, menggunakan opsi “-v” untuk verifikasi JCL, dan opsi “-f” untuk membuat makro.

   ```
   mvstrans ACCTFILE -v
   mvstrans ACCTFILE -f
   ```

1. Terjemahkan prosedur JCL REPROC ke prosedur BPE JCL Makro. Gunakan `mvstrans` perintah dengan opsi “-p” bersama dengan opsi “-v” untuk verifikasi, dan opsi “-f” untuk membuat makro.

   ```
   mvstrans REPROC -v -p
   mvstrans REPROC -f -p
   ```

1. Terjemahkan semua JCLs dan prosedur JCL.

   ```
   for file in "./jmvs/*"; do mvstrans $file -f; done > jmvs.out
   for file in "./mvsp/*"; do mvstrans $file -p -f; done > mvsp.out
   ```

## Langkah 5: Impor katalog BPE dan TPE
<a name="tutorial-unikix-import"></a>

Pada langkah ini, Anda mengimpor katalog BPE dan TPE menggunakan perintah yang berbeda.

1. Impor katalog BPE menggunakan `loadcat` perintah.

   ```
   loadcat $MIGAPP_DIR/catlg/bpe/BPECAT*
   ```

1. Arahkan ke direktori \$1KIXSYS.

   ```
   cd $KIXSYS
   ```

1. Impor katalog TPE menggunakan `kiximpcat` perintah.

   ```
   kiximpcat -c CATALOG -l CATALOG.lst
   ```

1. Impor definisi sumber daya CICS menggunakan perintah kiximptbl.

   ```
   kiximptbl
   ```

## Langkah 6: Mulai dan hubungkan TPE dengan BPE
<a name="unikix-tutorial-connect"></a>

Pada langkah ini, Anda harus memulai wilayah TPE yang dibuat sebelumnya bersama dengan manajer BPE dan menghubungkannya untuk dapat menjalankan aplikasi sampel CardDemo .

1. Jalankan `kixverify` perintah terhadap semua file VSAM untuk memastikan mereka diatur ulang dan file yang sebelumnya dibuka ditutup.

   ```
   kixverify -r ALL
   ```

1. Mulai wilayah TPE.

   ```
   kixregion start $KIXSYS
   ```

1. Pastikan BPE dan TPE terhubung. Ini sangat penting karena file VSAM dimiliki oleh TPE, dan operasi batch apa pun yang mengakses VSAM akan memerlukan koneksi ke TPE.

   ```
   ebmsys -t
   ```  
![\[Menampilkan nama Subsystem sebagai sys1. TPE terhubung dan pengguna TPE adalah ec2-user.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/unikix-start-1.png)

## Langkah 7: Jalankan CardDemo aplikasi
<a name="unikix-tutorial-run-application"></a>

Pada langkah ini, Anda menjalankan CardDemo aplikasi di emulator TN3270 terminal.

AMI UniKix runtime dilengkapi dengan emulator terminal TN3270 yang dapat Anda luncurkan langsung dari instans EC2. UniKix 

**Connect ke TPE menggunakan TN3270 terminal emulator**
+ Luncurkan TN3270 terminal menggunakan `kixterm` perintah.

  ```
  kixterm
  ```  
![\[Layar utama aplikasi UniKix CardDemo sampel TPE untuk mainframe.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/unikix-carddemo-00.png)

(Opsional). Jika Anda ingin menggunakan emulator terminal Anda sendiri:

1. Dapatkan alamat IP instans UniKix runtime dari konsol Amazon EC2.

1. Dapatkan nomor port untuk menghubungkan ke wilayah TPE menggunakan emulator TN3270 terminal. Anda dapat menemukan ini di TNServer ListenPort dari file unikixrc.cfg.

   ```
   cat $KIXSYS/unikixrc.cfg
   ```  
![\[Menampilkan rincian file UniKix unikixrc.cfg dengan port listener sebagai 15440.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/unikix-carddemo-1.png)

1. Konfigurasikan emulator TN3270 terminal Anda untuk menggunakan alamat IP instance UniKix runtime dan nomor port 15440.

**Transaksi Online**

Bagian ini mengasumsikan bahwa Anda telah terhubung ke emulator TN3270 terminal menggunakan `kixterm` perintah.

1. Setelah menghubungkan dari emulator TN3270 terminal, tekan tombol “Enter” untuk menghapus layar TPE dan masukkan transaksi awal.

1. Pada transaksi awal CC00 (layar masuk) masukkan `USER001` nama pengguna dan `PASSWORD` kata sandi.  
![\[Layar utama untuk CardDemo. Menampilkan bahwa ini adalah CardDemo aplikasi Kredit untuk Modernisasi Mainframe. Meminta untuk memasukkan ID pengguna dan kata sandi Anda.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/unikix-carddemo-2.png)

1. Pilih opsi “01" dari **Menu Utama** untuk melihat akun.  
![\[CardDemo menu utama aplikasi di emulator dengan opsi yang dipilih sebagai 1.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/unikix-carddemo-3.png)

1. Di layar **Lihat Akun**, masukkan nomor akun (mis., 00000000010). Anda akan melihat informasi akun yang diisi dari data yang dimigrasi.  
![\[Rincian CardDemo aplikasi dengan nomor akun yang dimasukkan sebagai 00000000010.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/unikix-carddemo-4.png)

1. Tekan tombol “PF03” dua kali untuk kembali ke layar Masuk, dan keluar dari TN3270 terminal dengan menekan “Ctrl\$1C” (Windows) atau “Cmd\$1C” (Macbook).

**Lowongan kerja Batch**

1. Arahkan ke direktori JCL.

   ```
   cd $MBMSUB
   ```

1. Kirim pekerjaan `MFCATGL1` dan amati output log pekerjaan.

   ```
   BPESUB READCARD
   ```

1. Secara opsional, Anda dapat melihat log pekerjaan dari `$SUBSYS_OUTDIR` direktori.

   ```
   ls -lrt $SUBSYS_OUTDIR/*
   ```

Anda sekarang telah berhasil menyebarkan CardDemo aplikasi ke UniKix runtime NTT DATA dan memverifikasi aplikasi yang sedang berjalan dengan menavigasi melalui beberapa layar online CICS dan pekerjaan batch.

## Pemecahan masalah
<a name="tutorial-unikix-troubleshoot"></a>

Berikut ini adalah beberapa kesalahan umum yang mungkin Anda temukan saat menyiapkan CardDemo aplikasi.

### Kesalahan: Kesalahan perizinan
<a name="tutorial-unikix-troubleshoot-license-issue"></a>

Jika Anda menerima kesalahan kegagalan lisensi selama mengikuti tutorial ini, bisa jadi **IMDSv2**diaktifkan di EC2 Anda. Anda dapat mengatasi masalah ini dengan mengubah opsi metadata instans **IMDSv2**menjadi **Opsional** seperti yang disebutkan dalam [Memulihkan penggunaan IMDSv1 dalam panduan](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-IMDS-existing-instances.html) pengguna *Amazon* EC2.

### Kesalahan: TPE tidak terhubung ke BPE
<a name="tutorial-unikix-troubleshoot-tpe-connection"></a>

Jika TPE tidak terhubung ke BPE, pastikan **Tabel Konfigurasi VSAM dikonfigurasi** dengan benar dengan direktori BPE Node. Untuk mengakses Tabel Konfigurasi VSAM, luncurkan emulator TN3270 terminal menggunakan perintah berikut:

```
kixterm
```

1. Masukkan nama transaksi sebagai`CTBL`.

1. Di menu **Table Manager**, pilih opsi **Tabel Standar**.

1. Pada Tabel standar layar, pilih opsi **Tabel Konfigurasi VSAM**.

1. Periksa apakah **Connect ke batch node?** diatur ke "**Y** dan Direktori Node benar.

![\[Tabel Konfigurasi VSAM di emulator TN3270 terminal. Menampilkan nilai untuk masing-masing bidang dalam tabel.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/unikix-troubleshoot.png)
