View a markdown version of this page

Tutorial: Menyebarkan CardDemo aplikasi pada NTT DATA - AWS Modernisasi Mainframe

AWS Pengalaman yang dikelola mandiri Modernisasi Mainframe tidak lagi terbuka untuk pelanggan baru. Untuk kemampuan yang mirip dengan pengalaman yang dikelola mandiri Modernisasi AWS Mainframe, jelajahi kemampuan dari penawaran langsung vendor dan dari. AWS Transform Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Untuk informasi selengkapnya, lihat Perubahan ketersediaan Modernisasi AWS Mainframe.

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

AWS Layanan Modernisasi Mainframe (pengalaman Managed Runtime Environ ment) tidak lagi terbuka untuk pelanggan baru. Untuk kemampuan yang mirip dengan Layanan Modernisasi AWS Mainframe (pengalaman Lingkungan Runtime Terkelola), jelajahi Layanan Modernisasi AWS Mainframe (Self-ManagedExperience). Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Untuk informasi selengkapnya, lihat Perubahan ketersediaan Modernisasi AWS Mainframe.

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

Tutorial: Menyebarkan CardDemo aplikasi pada NTT DATA

Halaman ini memandu Anda melalui proses langkah demi langkah untuk menerapkan 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 AWS dan memamerkan serta teknologi mitra untuk kasus penggunaan migrasi mainframe dan modernisasi.

Untuk informasi lebih lanjut tentang aplikasi ini, lihat, GitHub repositori untuk CardDemo.

Diagram alir penerapan

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.

Prasyarat

  • Ikuti petunjuk yang diberikan dalam AWS Replatforming Modernisasi Mainframe dengan NTT DATA menggunakan NTT DATA UniKix Marketplace AMI.

  • Ubah opsi metadata instans IMDSv2 menjadi Opsional seperti yang disebutkan di Kem balikan penggunaan IMDsv1 di panduan pengguna Amazon EC2.

  • Unduh komponen CardDemo runtime untuk NTT DATA UniKix dari

    GitHub repositori.

  • Masuk ke instance EC2 UniKix runtime sebagaiec2-user.

  • Ekstrak komponen CardDemo runtime yang diunduh menggunakan tautan ini: UniKix _ CardDemo _runtime_v1.zip.

    • Direktori yang diekstraksi harus berisi bin dan migrated_app direktori.

    • Pindahkan keduanya bin dan migrated_app direktori di bawah $HOME direktori Anda. Jalannya akan terlihat seperti itu/home/ec2-user.

    • Anda harus memiliki direktori berikut di$HOME:

      • /home/ec2-user/bin

      • /home/ec2-user/migrated_app

    • Pindahkan semua file di dalam HOME/bin direktori $ perintah berikut:

      • chmod +x $HOME/bin/*

Langkah 1: Siapkan lingkungan

Setelah menyelesaikan prasyarat, langkah pertama adalah mempersiapkan lingkungan tempat Anda ingin menerapkan CardDemo aplikasi.

  1. Masuk ke instance EC2 UniKix runtime sebagaiec2-user.

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

    ls -l /opt/software/
  3. Periksa CardDemo aplikasi yang dimigrasi. Anda akan melihat semua kode sumber, termasuk peta BMS, program COBOL, COBOL Copybooks, dan JCLs. Anda juga akan menemukan ekspor katalog BPE dan TPE, definisi sumber daya CICS, dan data yang dimigrasi seperti file berurutan dan file VSAM dengan melakukan ini:

    ls $HOME/migrated_app/*/*
  4. Buat struktur folder dengan menjalankan create_project skrip dengan perintah berikut:

    sh $HOME/bin/create_project
  5. Aktif CardDemo kan lingkungan dengan mencari file carddemo.env setup menggunakan:

    source $HOME/bin/carddemo.env

Langkah 2: Buat wilayah TPE

Setelah Anda mengaktifkan lingkungan tempat Anda ingin menerapkan 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
  2. 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
  3. Hasilkan file lingkungan pengguna khusus untuk wilayah TPE ini dengan menjalankan kixregion createScript perintah. Perintah ini membuat atau memperbarui $KIXSYS/bin/userenv berdasarkan konfigurasi wilayah TPE.

    kixregion createScript $KIXSYS
  4. Aktifkan wilayah TPE dengan mencari file lingkungan pengguna ($KIXSYS/bin/userenv).

    source $KIXSYS/bin/userenv
  5. Bangun wilayah TPE dengan menjalankan kixinstall2 perintah.

    kixinstall2

Langkah 3: Buat simpul dan subsistem BPE

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

  1. Ubah kepemilikan dan izinINSTEBM.

    sudo chown root $INSTEBM sudo chmod 4755 $INSTEBM
  2. Buat node BPE menggunakan INSTEBM perintah. Direktori simpul BPE disediakan sebagai parameter input.

    $INSTEBM $EBMHOME
  3. Aktifkan lingkungan batch dengan mencari batchenv file dari node BPE yang baru dibuat.

    source $EBMHOME/batchenv
  4. Buat subsistem BPE dalam node ini menggunakan Batch Administration Manager (bam). Per bam intah akan membuka antarmuka Manajer Administrasi Batch.

    bam
    1. Mulai node BPE menggunakan antarmuka BAM. Pilih opsi 2, Lingkungan Sistem dari menu utama.

      Di Batch Administrator Manager, pilih opsi 2 Lingkungan Sistem.
    2. Pilih opsi 2, Mul ai/ (Stop) Batch Node untuk memulai node BPE.

      Di Lingkungan Sistem, pilih opsi 2 node Start/Stop batch.
    3. Setelah dimulai, tekan tombol Return dua kali untuk kembali ke menu utama BAM.

      Layar Batch Node Startup selesai.
    4. Untuk membuat subsistem BPE, pilih opsi 3, Aplikasi & Subsistem.

      Opsi 3 Aplikasi dan Subsistem dipilih pada halaman Batch Administrator Manager.
    5. Kemudian pilih opsi 3, Buat Subsistem.

      Opsi 3 Buat Subsistem yang dipilih pada layar Aplikasi dan Subsistem.
    6. Masukkan nama subsistem sebagaisys1.

      Memasukkan sys1 pada layar Buat.
    7. Pilih opsi 3, Manajemen Data.

      Memilih opsi 3 Manajemen Data pada layar Buat di Aplikasi dan Subsistem.
    8. Pilih opsi 5, karena CardDemo aplikasi melibatkan file sekuensial dan VSAM.

      Pilih opsi 5 untuk menyertakan file sekuensial dan VSAM.
    9. (Opsional). Tekan “R” untuk kembali ke halaman Buat Menu, tinjau berbagai opsi konfigurasi yang tersedia.

    10. Pada halaman Buat, masukkan “C” untuk membuat subsistemsys1.

      Tekan “C” pada keyboard untuk membuat subsistem sys1.
    11. Tinjau pengaturan, dan masukkan “C” untuk melanjutkan pengaturan lingkungan lainnya. Pengaturan lingkungan ini sudah terisi sebelumnya karena variabel lingkungan yang diperlukan yang ditentukan dalam file carddemo.env pengaturan dan struktur folder yang direkomendasikan sedang ada.

    12. Masukkan “y” untuk mengonfirmasi dan menyimpan pengaturan lingkungan saat ini.

      Menampilkan pengaturan lingkungan subsistem sys1 selesai. Juga ketik “y” untuk menyimpan pengaturan saat ini.
    13. Masukkan “y” untuk menampilkan log saat membangun subsistem.

      Menunjukkan membangun sistem runtime NTT DATA COBOL sys1 di layar.
    14. Tekan tombol Ret urn 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 Return untuk melanjutkan.
      Kembali ke menu Create dan menunjukkan subsistem sys1 dibuat. Dan konfigurasi diperbarui. Meminta untuk menekan kembali untuk melanjutkan.
      Menu Utama untuk Administrator Batch. Meminta untuk memasukkan Q untuk keluar dari menu ini.
  5. Aktifkan subsistem BPE dengan mencari batchenv dengan nama subsistem. sys1

    source $EBMHOME/batchenv sys1

Langkah 4: Mengkompilasi dan menyebarkan CardDemo aplikasi

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

  1. Aktif CardDemo kan lingkungan lagi dengan mencari file carddemo.env setup.

    source $HOME/bin/carddemo.env
  2. Arahkan ke direktori sumber COBOL.

    cd $MIGAPP_DIR/cbl
  3. Mengkompilasi program Cobol CBACT01C.cbl menggunakan compile skrip.

    compile CBACT01C.cbl
  4. Mengkompilasi semua program Cobol menggunakan compile.all skrip.

    compile.all
  5. Arahkan ke direktori sumber peta BMS.

    cd $MIGAPP_DIR/bms
  6. Mengkompilasi peta BMS COACTUP.bms menggunakan compbms skrip.

    compbms COACTUP.bms
  7. Kompilasi semua peta BMS menggunakan compbms.all skrip.

    compbms.all
  8. Verifikasi binari yang dikompilasi untuk peta COBOL dan BMS.

    ls $PROJECT_ROOT/loadlib ls $PROJECT_ROOT/maps
  9. Menyebarkan artefak aplikasi lain seperti JCL, prosedur, file data, dan definisi sumber daya CICS menggunakan skrip. deploy_app

    deploy_app
  10. Arahkan ke direktori proyek JCL.

    cd $PROJECT_ROOT/jcl
  11. 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
  12. 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
  13. Terjemahkan semua prosedur JCL dan 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

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*
  2. Arahkan ke direktori $ KIXSYS.

    cd $KIXSYS
  3. Impor katalog TPE menggunakan kiximpcat perintah.

    kiximpcat -c CATALOG -l CATALOG.lst
  4. Impor definisi sumber daya CICS menggunakan perintah kiximptbl.

    kiximptbl

Langkah 6: Mulai dan hubungkan TPE dengan BPE

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

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

    kixverify -r ALL
  2. Mulai wilayah TPE.

    kixregion start $KIXSYS
  3. 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 Subsistem sebagai sys1. TPE terhubung dan pengguna TPE adalah pengguna ec2.

Langkah 7: Jalankan CardDemo aplikasi

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

UniKix Runtime AMI dilengkapi dengan emulator terminal TN3270 yang dapat Anda luncurkan langsung dari instance UniKix EC2.

Hubungkan ke TPE menggunakan emulator terminal TN3270
  • Luncurkan terminal TN3270 menggunakan perintah. kixterm

    kixterm
    Layar utama aplikasi UniKix CardDemo sampel TPE untuk mainframe.

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

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

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

    cat $KIXSYS/unikixrc.cfg
    Menampilkan detail file UniKix unikixrc.cfg dengan port pendengar sebagai 15440.
  3. Konfigurasikan emulator terminal TN3270 Anda untuk menggunakan alamat IP instance UniKix runtime dan nomor port 15440.

Transaksi Online

Bagian ini mengasumsikan bahwa Anda telah terhubung ke emulator terminal TN3270 menggunakan perintahkixterm.

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

  2. Pada transaksi awal CC00 (layar masukUSER001) masukkan nama pengguna dan kata PASSWORD sandi.

    Layar utama untuk CardDemo. Menampilkan bahwa ini adalah CardDemo aplikasi Kredit untuk Modernisasi Mainframe. Meminta untuk memasukkan ID pengguna dan kata sandi Anda.
  3. Pilih opsi “01” dari Menu Utama untuk melihat akun.

    CardDemo menu utama aplikasi di emulator dengan opsi yang dipilih sebagai 1.
  4. Di layar Lihat Akun, masukkan nomor akun (misalnya, 00000000010). Anda akan melihat informasi akun yang diisi dari data yang dimigrasi.

    Rincian CardDemo aplikasi dengan nomor rekening yang dimasukkan sebagai 00000000010.
  5. Tekan tombol “PF03” dua kali untuk kembali ke layar Log in, dan keluar dari terminal TN3270 dengan menekan “Ctrl+C” (Windows) atau “Cmd+C” (Macbook).

Lowongan kerja Batch

  1. Arahkan ke direktori JCL.

    cd $MBMSUB
  2. Kirim pekerjaan MFCATGL1 dan amati output log pekerjaan.

    BPESUB READCARD
  3. Secara opsional, Anda dapat melihat log pekerjaan dari $SUBSYS_OUTDIR direktori.

    ls -lrt $SUBSYS_OUTDIR/*

Anda sekarang telah berhasil menerapkan 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

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

Kesalahan: Kesalahan lisensi

Jika Anda menerima kesalahan kegagalan lisensi selama mengikuti tutorial ini, bisa jadi IMDSv2 diaktifkan di EC2 Anda. Anda dapat mengatasi masalah ini dengan memodifikasi opsi metadata instans IMDSv2 menjadi Opsional seperti yang disebutkan dalam Memuli hkan penggunaan IMDsv1 di panduan pengguna Amazon EC2.

Kesalahan: TPE tidak terhubung ke BPE

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

kixterm
  1. Masukkan nama transaksi sebagaiCTBL.

  2. Di menu Table Manager, pilih opsi Tabel Standar.

  3. Pada layar Tabel standar, pilih opsi Tabel Konfigur asi VSAM.

  4. Periksa apakah Sambungkan ke node batch? diatur ke "Y dan Direktori Node benar.

Tabel Konfigurasi VSAM di emulator terminal TN3270. Menampilkan nilai untuk masing-masing bidang dalam tabel.