View a markdown version of this page

Tutorial: Konversi kode dari Assembler ke COBOL di AWS Mainframe Modernization - 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: Konversi kode dari Assembler ke COBOL di AWS Mainframe Modernization

Anda dapat menggunakan dokumen ini sebagai panduan langkah demi langkah untuk memahami cara mengonversi kode Assembler modernisasi mainframe ke COBOL. Selain itu, Anda juga dapat merujuk konversi kode Otomatis dari Assembler ke lokakarya COBOL untuk mempelajari lebih lanjut tentang proses konversi.

Prasyarat

Baca Memahami penagihan konversi Kode untuk konversi Assembler bagian ini untuk memahami bagaimana konversi kode Assembler menghasilkan biaya (laporan penagihan) pada Anda AWS Account Management, dan cara penagihan bekerja.

Langkah 1: Bagikan aset build dengan Akun AWS

Pada langkah ini, pastikan bahwa Anda berbagi aset bangunan dengan Anda Akun AWS, terutama di Wilayah tempat aset digunakan.

  1. Buka AWS Mainframe Modernization konsol di https://console.aws.amazon.com/m2/.

  2. Di navigasi kiri, pilih Tools.

  3. Di Kon versi Kode Modernisasi Mainframe AWS dengan MLogica, pilih Bagikan aset dengan milik saya. Akun AWS

penting

Anda perlu melakukan langkah ini sekali di setiap AWS Wilayah tempat Anda ingin melakukan pembangunan.

Langkah 2: Buat bucket Amazon S3

Pada langkah ini, Anda membuat bucket Amazon S3. Bucket pertama adalah bucket proyek AWS CodeBuild untuk menyimpan kode sumber dan kemudian mendorong bucket keluaran untuk menahan AWS CodeBuild output (kode yang dikonversi). Untuk informasi selengkapnya, lihat Membuat, mengonfigurasi, dan bekerja dengan bucket Amazon S3 di Panduan Pengguna Amazon S3.

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

  2. Di Konfigurasi Umum, berikan nama untuk bucket dan tent Wilayah AWS ukan tempat Anda ingin membuat bucket. Contoh nama adalahcodebuild-regionId-accountId-bucket, di mana:

    • regionIdadalah Wilayah AWS dari ember.

    • accountIdadalah Akun AWS ID Anda.

    catatan

    Jika Anda membuat bucket di tempat yang berbeda Wilayah AWS dari AS Timur (Virginia Utara), tentukan LocationConstraint parameternya. Untuk informasi selengkapnya, lihat Membuat Bucket di Referensi API Layanan Penyimpanan Sederhana Amazon.

  3. Pertahankan semua pengaturan lainnya, dan pilih Buat bucket.

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

Langkah 3: Buat kebijakan IAM

Pada langkah ini, Anda membuat kebijakan https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html IAM. Kebijakan IAM yang disediakan memberikan izin khusus AWS CodeBuild untuk berinteraksi dengan Amazon S3, Amazon Elastic Container Registry, CloudWatch log Amazon yang dihasilkan CodeBuild , dan Amazon Elastic Compute Cloud sumber daya untuk konversi Kode. Kebijakan ini tidak disesuaikan untuk pelanggan. Kebijakan ini memberikan izin AWS Mainframe Modernization untuk berinteraksi, dan mengambil statistik konversi Kode untuk menagih pelanggan dengan tepat.

Untuk mempelajari cara membuat kebijakan IAM, lihat Membuat kebijakan IAM di panduan pengguna IAM.

Untuk membuat kebijakan
  1. Masuk ke konsol IAM, dan pilih Kebijakan di panel navigasi kiri.

  2. Pilih Buat kebijakan.

  3. Salin dan tempel kebijakan JSON berikut ke editor kebijakan.

    JSON
    { "Version":"2012-10-17", "Statement": [ { "Action": [ "s3:PutObject", "s3:GetObject", "s3:GetBucketLocation", "s3:ListBucket", "s3:PutObjectAcl", "s3:GetBucketAcl" ], "Resource": [ "arn:aws:s3:::codebuild-regionId-accountId-bucket", "arn:aws:s3:::codebuild-regionId-accountId-bucket/*", "arn:aws:s3:::aws-m2-repo-*" ], "Effect": "Allow" }, { "Action": [ "ecr:GetAuthorizationToken", "ecr:BatchCheckLayerAvailability", "ecr:BatchGetImage", "ecr:GetDownloadUrlForLayer", "logs:*", "ec2:DescribeSecurityGroups", "ec2:DescribeSubnets", "ec2:DescribeNetworkInterfaces", "ec2:DeleteNetworkInterface", "ec2:CreateNetworkInterface", "ec2:DescribeDhcpOptions", "ec2:DescribeVpcs", "ec2:CreateNetworkInterfacePermission" ], "Resource": "*", "Effect": "Allow" } ] }
  4. Anda dapat menambahkan tag ke kebijakan secara opsional. Tag adalah pasangan kunci-nilai yang dapat membantu Anda mengatur, melacak, atau mengontrol akses untuk kebijakan.

  5. Pilih Next:Review.

  6. Berikan nama untuk kebijakan, misalnya,CodeBuildAWSM2CCMPolicy.

  7. Secara opsional, Anda dapat memasukkan deskripsi untuk kebijakan, dan meninjau ringkasan kebijakan untuk memastikannya benar.

  8. Pilih Buat kebijakan.

Langkah 4: Buat peran IAM

Pada langkah ini, Anda membuat peran IAM 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 di Panduan Pengguna IAM.

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

  2. Pilih Buat peran.

  3. Di bawah Jenis entitas tepercaya, pilih layanan AWS.

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

  5. Pilih Berikutnya.

  6. Pada halaman Tambahkan izin, pilih Berikutnya. Anda menetapkan kebijakan ke peran nanti.

  7. Di bawah Detail peran, berikan nama untuk peran, misalnya,IAMRoleTaskExecutionRoleForCodeBuild.

  8. 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" } ] }
  9. Pilih Buat peran.

Langkah 5: Lampirkan kebijakan IAM ke peran IAM

Pada langkah ini, Anda melampirkan kebijakan IAM yang sebelumnya Anda buat ke peran IAMRoleTaskExecutionRoleForCodeBuild IAM.

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

  2. Di Per an, pilih peran yang Anda buat sebelumnya, misalnya,IAMRoleTaskExecutionRoleForCodeBuild.

  3. Di Kebijakan Izin, pilih Tambah izin, lalu Lamp irkan kebijakan.

  4. Di Kebijakan izin lainnya, pilih kebijakan yang Anda buat sebelumnya, misalnya,CodeBuildAWSM2CCMPolicy.

  5. Pilih Lampirkan kebijakan.

Langkah 6: Buat CodeBuild proyek

Pada langkah ini, Anda membuat tiga CodeBuild proyek berbeda berdasarkan buildspec.yml file yang disebutkan di atas.

Langkah 6.1: Buat proyek Define

Untuk membuat proyek Define
  1. Masuk ke CodeBuild konsol, dan pilih Buat proyek build.

  2. Di bagian konfigurasi proyek, berikan nama untuk proyek, misalnya,1-awsm2ccm-define-project.

  3. Di bagian Sumber, untuk Penye dia Sumber, tinggalkan pilihan default.

  4. Di bagian Lingkungan, pilih Gambar kustom.

  5. Di bidang Environment type, pilih Linux.

  6. Di bawah Registri gambar, pilih Registry lain.

  7. Di bidang URL registri eksternal, ikuti AWS Mainframe Modernization kontainer bagian tersebut.

  8. Di bawah Peran layanan, pilih Peran layanan yang ada, dan di bidang Peran ARN, pilih peran layanan yang Anda buat sebelumnya (misalnya,IAMRoleTaskExecutionRoleForCodeBuild).

  9. Perluas bagian konfigurasi tambahan, lakukan hal berikut:

    1. VPC: Konfigurasikan jika diperlukan berdasarkan pengaturan Anda.

    2. Waktu habis: Setel ke 60 menit.

    3. Batas waktu antrian: Setel ke 480 menit.

    4. Enkripsi: Pilih pengaturan enkripsi yang sesuai (defaultnya baik-baik saja).

    5. Di bagian Variabel lingkungan, tambahkan yang berikut ini satu per satu:

      • Nama: PROJECT_BUCKET. Nilai:codebuild-regionId-accountId- bucket. Jenis: Plainteks

      • Nama: PROJECT_DIR. Nilai:prj_codebuild_01. Jenis: Plainteks

      • Nama: AWSM 2CCM_ACTION. Nilai:define_project. Jenis: Plainteks

      • Nama: AWSM 2CCM_LOGGING_BUCKET. Nilai:s3:// codebuild-regionId-accountId-bucket. Jenis: Plainteks

  10. Di bagian Buildspec, pilih S isipkan perintah build, lalu Beralih ke editor.

  11. Ganti nilai saat ini dengan ini:

    version: 0.2 phases: build: commands: - . /app/awsm2ccm_prod/bin/setup_env.sh - run_awsm2ccm.sh $PROJECT_DIR artifacts: files: - '**/*' discard-paths: no base-directory: $PROJECT_DIR

    dimana, PROJECT_DIR adalah variabel lingkungan yang tersedia di dalamnya. CodeBuild Untuk informasi selengkapnya, lihat Variabel lingkungan di lingkungan build.

  12. Di bagian Artefak, lakukan ini:

    • di bawah Jenis, pilih Amazon S3, lalu pilih bucket keluaran Anda, misalnya,codebuild-regionId-accountId-bucket.

    • untuk Path, biarkan bidang ini kosong.

    • untuk Nama, masukkanprj_codebuild_01.

    • untuk Kemasan artefak, pilih Tidak Ada.

    • untuk Meng ganti nama artefak, hapus centang pada opsi ini.

    • untuk Enkripsi, biarkan ke pengaturan default.

  13. Untuk bagian Log, lakukan hal berikut:

    • CloudWatch log: Din onaktifkan

    • Log S3: Di aktifkan

    • Ember: codebuild-regionId-account-bucket

    • Jalur log: CODEBUILD-LOGS

  14. Pilih Buat proyek pembangunan.

Langkah 6.2: Buat proyek Analisis Kode

Untuk membuat proyek Analisis Kode
  1. Masuk ke CodeBuild konsol, dan pilih Buat proyek build.

  2. Di bagian konfigurasi proyek, berikan nama untuk proyek, misalnya,2-awsm2ccm-analysis.

  3. Di bagian Sumber, untuk Penye dia Sumber, pilih Amazon S3, lalu pilih bucket input yang Anda buat sebelumnya (misalnya,codebuild-regionId-accountId-bucket).

  4. Di kolom tombol objek S3 atau folder S3, masukkanprj_codebuild_01.

  5. Di bagian Lingkungan, pilih Gambar kustom.

  6. Di bidang Environment type, pilih Linux.

  7. Di bawah Registri gambar, pilih Registry lain.

  8. Di bidang URL registri eksternal, ikuti AWS Mainframe Modernization kontainer bagian tersebut.

  9. Di bawah Peran layanan, pilih Peran layanan yang ada, dan di bidang Peran ARN, pilih peran layanan yang Anda buat sebelumnya (misalnya,IAMRoleTaskExecutionRoleForCodeBuild).

  10. Perluas bagian konfigurasi tambahan, lakukan hal berikut:

    1. VPC: Konfigurasikan jika diperlukan berdasarkan pengaturan Anda.

    2. Waktu habis: Setel ke 60 menit.

    3. Batas waktu antrian: Setel ke 480 menit.

    4. Enkripsi: Pilih pengaturan enkripsi yang sesuai (defaultnya baik-baik saja).

    5. Di bagian Variabel lingkungan, tambahkan yang berikut ini satu per satu:

      • Nama: PROJECT_BUCKET. Nilai:codebuild-regionId-accountId-bucket. Jenis: Plainteks

      • Nama: PROJECT_DIR. Nilai:prj_codebuild_01. Jenis: Plainteks

      • Nama: AWSM 2CCM_ACTION. Nilai:analysis. Jenis: Plainteks

      • Nama: AWSM 2CCM_LOGGING_BUCKET. Nilai:s3:// codebuild-regionId-accountId-bucket. Jenis: Plainteks

  11. Di bagian Buildspec, pilih S isipkan perintah build, lalu Beralih ke editor.

  12. Ganti nilai saat ini dengan ini:

    version: 0.2 phases: build: commands: - ln -s $CODEBUILD_SRC_DIR $PROJECT_DIR - . /app/awsm2ccm_prod/bin/setup_env.sh - run_awsm2ccm.sh $PROJECT_DIR artifacts: files: - '*.log' - '_Converted/*/*' - '_Reports/*' secondary-artifacts: reports: files: - '_Reports/AWSM2CCM*' discard-paths: no base-directory: $PROJECT_DIR

    dimana, PROJECT_DIR adalah variabel lingkungan yang tersedia di dalamnya. CodeBuild Untuk informasi selengkapnya, lihat Variabel lingkungan di lingkungan build.

  13. Di bagian Artefak, lakukan ini:

    • di bawah Jenis, pilih Amazon S3, lalu pilih bucket keluaran Anda (mis.,codebuild-regionId-accountId-bucket).

    • untuk Path, masukkan ARTI FACTS.

    • untuk Nama, masukkanprj_codebuild_01.

    • untuk Kemasan artefak, pilih Tidak Ada.

    • untuk Meng ganti nama artefak, hapus centang pada opsi ini.

    • untuk Enkripsi, biarkan ke pengaturan default.

  14. Untuk bagian Log, lakukan hal berikut:

    • CloudWatch log: Din onaktifkan

    • S3 Log: Di aktifkan

    • Ember: codebuild-regionId-account-bucket

    • Jalur log: CODEBUILD-LOGS

  15. Pilih Buat proyek pembangunan.

Langkah 6.3: Buat proyek Konversi Kode

Untuk membuat proyek Konversi Kode
  1. Masuk ke CodeBuild konsol, dan pilih Buat proyek build.

  2. Di bagian konfigurasi proyek, berikan nama untuk proyek (misalnya,3-awsm2ccm-convert).

  3. Di bagian Sumber, untuk Penye dia Sumber, pilih Amazon S3, lalu pilih bucket input yang Anda buat sebelumnya (misalnya,codebuild-regionId-accountId-bucket).

  4. Di kolom tombol objek S3 atau folder S3, masukkanprj_codebuild_01.

  5. Di bagian Lingkungan, pilih Gambar kustom.

  6. Di bidang Environment type, pilih Linux.

  7. Di bawah Registri gambar, pilih Registry lain.

  8. Di bidang URL registri eksternal, ikuti AWS Mainframe Modernization kontainer bagian tersebut.

  9. Di bawah Peran layanan, pilih Peran layanan yang ada, dan di bidang Peran ARN, pilih peran layanan yang Anda buat sebelumnya; misalnya,IAMRoleTaskExecutionRoleForCodeBuild.

  10. Perluas bagian konfigurasi tambahan, lakukan hal berikut:

    1. VPC: Konfigurasikan jika diperlukan berdasarkan pengaturan Anda.

    2. Waktu habis: Setel ke 60 menit.

    3. Batas waktu antrian: Setel ke 480 menit.

    4. Enkripsi: Pilih pengaturan enkripsi yang sesuai (defaultnya baik-baik saja).

    5. Di bagian Variabel lingkungan, tambahkan yang berikut ini satu per satu:

      • Nama: PROJECT_BUCKET. Nilai:codebuild-regionId-accountId-bucket. Jenis: Plainteks

      • Nama: PROJECT_DIR. Nilai:prj_codebuild_01. Jenis: Plainteks

      • Nama: AWSM 2CCM_ACTION. Nilai:conversion. Jenis: Plainteks

      • Nama: AWSM 2CCM_LOGGING_BUCKET. Nilai:s3:// codebuild-regionId-accountId-bucket. Jenis: Plainteks

  11. Di bagian Buildspec, pilih S isipkan perintah build, lalu Beralih ke editor.

  12. Ganti nilai saat ini dengan ini:

    version: 0.2 phases: build: commands: - export AWSM2CCM_PUSH_RUNTIME_COPYBOOKS=y - ln -s $CODEBUILD_SRC_DIR $PROJECT_DIR - . /app/awsm2ccm_prod/bin/setup_env.sh - run_awsm2ccm.sh $PROJECT_DIR artifacts: files: - '*.log' - '_Converted/*/*' - '_Reports/*' discard-paths: no base-directory: $PROJECT_DIR

    dimana, PROJECT_DIR adalah variabel lingkungan yang tersedia di dalamnya. CodeBuild Untuk informasi selengkapnya, lihat Variabel lingkungan di lingkungan build.

  13. Di bagian Artefak, lakukan ini:

    • di bawah Jenis, pilih Amazon S3, lalu pilih bucket keluaran Anda (mis.,codebuild-regionId-accountId-bucket).

    • untuk Path, masukkan ARTI FACTS.

    • untuk Nama, masukkanprj_codebuild_01.

    • untuk Kemasan artefak, pilih Tidak Ada.

    • untuk Meng ganti nama artefak, hapus centang pada opsi ini.

    • untuk Enkripsi, biarkan ke pengaturan default.

  14. Untuk bagian Log, lakukan hal berikut:

    • CloudWatch log: Din onaktifkan

    • S3 Log: Di aktifkan

    • Ember: codebuild-regionId-account-bucket

    • Jalur log: CODEBUILD-LOGS

  15. Pilih Buat proyek pembangunan.

Langkah 7: Tentukan proyek dan unggah kode sumber

Define Project mengatur folder proyek dan file konfigurasi, diinisialisasi dengan konfigurasi default. Pada langkah ini, Anda memulai pembangunan. Untuk melakukannya:

  1. Masuk ke AWS CodeBuild konsol.

  2. Di panel navigasi kiri pilih Bangun proyek.

  3. Pilih proyek yang dibuat sebelumnya (1-awsm2ccm-define-project) untuk membangun

  4. Pilih Mulai membangun, dan kemudian Mulai sekarang untuk menentukan proyek. Setelah build dimulai, status akan berubah menjadi sedang berlangsung.

  5. Pilih Detail fase untuk melihat kemajuan setiap langkah yang diatur oleh AWS CodeBuild proyek.

  6. Tunggu hingga status berubah menjadi berhasil untuk semua langkah.

  7. Buka konsol Amazon S3.

  8. Temukan dan klik bucket Amazon S3 bernama codebuild-regionId-accountId-bucket

    • CODEBUILD-LOGS/folder berisi AWS CodeBuild log untuk AWS CodeBuild proyek yang sedang berjalan.

    • prj_codebuild_01/folder yang berisi struktur proyek. Ini digunakan selama analisis, expand_macros, dan langkah konversi. Anda dapat memilih prj_codebuild_01/ untuk menjelajahi detail

    • cobol_reserved.rswfile konfigurasi (daftar kata COBOL) disediakan untuk konverter. Ini digunakan selama langkah konversi.

    • Macro_Expansion/folder berisi makro untuk diperluas ke program Assembler. Ini digunakan selama langkah expand_macros.

    • macro_settings.jsonfile konfigurasi berisi penggantian makro yang disesuaikan. Ini digunakan selama langkah expand_macros.

    • macrolib/folder berisi makro Assembler yang akan dikonversi. Ini digunakan selama langkah analisis dan konversi.

      1. Pilih macrolib/.

      2. Secara default satu makro Assembler bernama MACRO1.mac disediakan sebagai file sampel. Hapus file ini karena tidak diperlukan untuk analisis.

      3. Unggah makro Anda di direktori ini.

    • project_settings_aux.jsonfile konfigurasi berisi pengaturan yang terkait dengan halaman kode. Ini digunakan selama langkah konversi.

    • project_settings.jsonfile konfigurasi berisi pengaturan untuk konverter. Ini digunakan selama langkah konversi.

    • srclib/folder berisi program Assembler yang akan dikonversi. Ini digunakan selama langkah analisis dan konversi.

      1. Pilih srclib/.

      2. Secara default, dua program Assembler diberi SQtest01.asm nama dan SQtest02.asm disediakan sebagai sampel. Hapus file-file ini karena tidak diperlukan untuk analisis dan konversi Anda.

      3. Unggah program Assembler Anda di direktori ini.

  9. Verifikasi status untuk 1-awsm2ccm-define-project langkah. Seharusnya berhasil di bawah tab status build terbaru.

Anda siap untuk langkah berikutnya: Analisis kode.

Langkah 8: Jalankan analisis dan memahami laporan

catatan

AWS Mainframe Modernization Langkah analisis konversi kode tidak dikenai biaya.

Pada langkah ini, Anda memulai build lain:

  1. Di panel navigasi kiri, pilih Bangun proyek.

  2. Pilih proyek yang Anda buat pada langkah 6.2 untuk membangun:2-awsm2ccm-analysis.

  3. Pilih Mulai membangun, lalu Mulai sekarang untuk menghasilkan laporan analisis. Ini akan memulai pembangunan dan mengubah status menjadi sedang berlangsung.

  4. Pilih detail fase di mana Anda akan melihat kemajuan setiap langkah yang diatur oleh AWS CodeBuild proyek. Tunggu hingga status berubah menjadi berhasil untuk semua langkah.

  5. Dari Konsol Manajemen AWS, buka konsol layanan Amazon S3.

  6. Temukan dan klik bucket Amazon S3: codebuild-regionId-accountId-bucket

    1. ARTIFACTS/folder berisi output dari langkah-langkah analisis dan konversi.

    2. Pilih ARTIFACTS/prj_codebuild_01/_Reports/.

    3. Laporan berikut akan tersedia:

      • AWSM2CCM-Analysis-Report-<timestamp>.pdfadalah laporan eksekutif yang menyediakan tagihan dan cakupan konversi AWS Mainframe Modernization Kode, meningkatkan konversi, ringkasan konversi, dan statistik konversi terperinci. Ini juga merangkum jumlah kode dan jumlah kode yang dapat ditagih di tingkat proyek dan menyediakan metrik dan daftar anggota yang direferensikan untuk setiap komponen. Sangat penting untuk menjalankan dan memeriksa laporan ini sebelum menjalankan konversi yang sebenarnya.

      • Conversion_Detailed_Statistics.txtmemberikan frekuensi dan hasil konversi yang diharapkan (ditampilkan sebagai “Status konversi”) untuk setiap instruksi yang ditemukan di setiap komponen. Ini memberikan cara cepat untuk mengidentifikasi apakah instruksi jelas bahwa konverter tidak mendukung. Kem ungkinan hasil status Konversi adalah:

        • Benar-benar dikonversi: instruksi akan dikonversi secara akurat ke COBOL.

        • Sebagian dikonversi: instruksi didukung tetapi menggunakan parameter atau ekspresi yang tidak didukung. Penyesuaian manual kemungkinan diperlukan setelah konversi.

        • Tidak dikonversi: instruksi tidak didukung oleh konverter.

        • Pre-compile instruksi untuk memverifikasi: ini biasanya disertakan di dalam Makro, dan merujuk ke apa yang mungkin dikenal juga sebagai instruksi Bahasa Perakitan Ber syarat (misalnya, AIF, AGO) pada mainframe. Ini ditangani oleh pra-kompiler yang didorong oleh instruksi atau arahan tersebut memilih dan menghasilkan kode clean/static ASM. Instruksi ini tergantung pada nilai aktual dari parameter Makro yang dikompilasi. Jadi, Makro yang sama dapat menghasilkan potongan kode ASM yang berbeda, tergantung pada nilai parameter yang dilewati. Ini karena adanya instruksi pra-kompilasi tersebut. Dalam hal ini, pertimbangkan untuk memperluas atau merekayasa ulang Makro.

      • Conversion_Global_Statistics.txtmemberikan ringkasan status Konversi pada tingkat komponen.

      • CrossReference_PgmToCpyMacro.txtmelaporkan dependensi program Assembler pada Makro. Ini menyediakan cara cepat untuk menentukan apakah ada Macro yang hilang dari kode yang diunggah.

      • CrossReference_PgmToPgm.txtmelaporkan dependensi program Assembler pada program Assembler lainnya. Ini menyediakan cara cepat untuk menentukan apakah ada program Assembler yang hilang dari kode yang diunggah.

  7. Kembali ke konsol AWS CodeBuild layanan.

  8. Verifikasi status untuk langkah analisis 2-awsm 2ccm. Seharusnya berhasil di bawah tab status build terbaru.

Anda siap untuk langkah berikutnya: Kon versi kode.

Langkah 9: Jalankan konversi Kode

penting

AWS Mainframe Modernization Langkah konversi kode akan ditagih sesuai penggunaan Anda. Untuk informasi selengkapnya tentang penagihan, lihatMemahami penagihan konversi Kode untuk konversi Assembler.

Pada langkah ini, Anda akan mengkonfigurasi proses konversi, dan kemudian memulai pembangunan.

  1. Dari Konsol Manajemen AWS, buka layanan Amazon S3.

  2. Temukan dan klik bucket Amazon S3:codebuild-regionId-accountId-bucket.

    1. Kunjungi prj_codebuild_01/.

    2. Pilihproject_settings.json, dan pilih Unduh.

    3. Buka project_settings.json file untuk melihat struktur JSON berikut:

      { "Source programs directory":"srclib", "Source copybooks/macros directory":"macrolib", "Copybook/Macros Conversion":"Called_only", "Do not regenerate the Copy/Macro if already exists":"false", "Target Compiler":"IBM", "Endianess":"Big", "Converted programs extension":"", "Converted CICS programs extension":"", "Converted copies/macros extension":"", "Trace Level":"STANDARD", "Trace file open mode":"append", "Data definition level":5, "Start picture column":40, "Generate Sync FILLER with name":"FILL-SYNC", "Use SYNC clause":"yes", "Decimal Point Comma":"true", "Original Source Placement":"RIGHT" }

      dimana,

      • Direktori program sumber: berisi program Assembler yang diperlukan untuk konversi.

      • copybooks/MacrosDirektori sumber: berisi Macro Assembler dan copybook yang diperlukan untuk konversi.

      • Copybooks/Macros konversi dapat berupa:

        • Semua: Tombol radio ini menunjukkan bahwa konversi penuh akan mengonversi semua yang copybook/Macros tersedia di direktori terlepas dari apakah itu sedang digunakan oleh program atau tidak.

        • Called_only: Tombol radio ini menunjukkan bahwa konversi penuh hanya akan mengonversi copybook/Macros yang sebenarnya digunakan oleh program.

      • penting

        Anda tidak perlu meregenerasi Copy/Macro jika sudah ada.

        Jika ini benar, alat tidak akan mengonversi copybook/Macro lagi, jika sudah dikonversi (ada di folder keluaran).

      • Target: Konversi program (kode yang dihasilkan) tergantung pada kompiler COBOL target. Opsi berikut didukung:

        • “IBM” untuk mainframe IBM

        • “MF” untuk Fokus Mikro COBOL

        • “VERYANT” untuk Veryant iSCOBOL

        • “NTT” untuk Perusahaan DATA NTT COBOL (Unikix)

      • Endianess dan Bitness: Konversi program (kode yang dihasilkan) tergantung pada platform target (). bit/endianess Kombo ini memungkinkan pemilihan opsi yang didukung berikut:

        • Endianess: Besar (untuk Big-Endian) /Kecil (Little-Endian). Misalnya, z/OS mainframe IBM adalah Big-Endian, Windows adalah Little-Endian, Linux bervariasi berdasarkan distribusi (misalnya Amazon Linux 2 di EC2 adalah Little-Endian).

        • Bitness: 32/64 (jika tidak diberikan, defaultnya adalah 32). Pengaturan yang disarankan adalah 32 bit.

      • Ekstensi program yang dikonversi: Ini untuk mengatur ekstensi file untuk program COBOL yang dihasilkan. Kosong (“”): tidak ada ekstensi. Untuk target COBOL Rocket Software (sebelumnya Micro Focus), CBL disarankan untuk memungkinkan Rocket Enterprise Developer mengenali file dengan benar.

      • Ekstensi program CICS yang dikonversi: Ini untuk mengatur ekstensi file untuk program COBOL CICS yang dihasilkan. Kosong (“”):: tidak ada ekstensi. Untuk target Rocket Software COBOL, CBL disarankan untuk mengaktifkan Rocket Enterprise Developer mengenali file dengan benar.

      • Ek copybooks/Macros stensi yang dikonversi: Ini untuk mengatur ekstensi file untuk buku salinan COBOL yang dihasilkan. Kosong (“”):: tidak ada ekstensi. Untuk target Rocket Software COBOL, CPY disarankan untuk mengaktifkan Rocket Enterprise Developer mengenali file dengan benar.

      • Tingkat jejak: Pelacakan adalah informasi yang dicatat menggunakan CodeBuild selama konversi. Pengguna dapat memilih tingkat detail dengan memilih salah satu opsi yang disediakan.

        • ERROR = TRACE ERROR: hanya kesalahan konversi yang ditampilkan.

        • STANDARD = TRACE STANDARD: kesalahan konversi dan informasi standar ditampilkan. Ini adalah pengaturan yang disarankan.

        • ALL = TRACE ALL: tingkat penelusuran maksimum

      • Mode buka file pelac akan: Tidak digunakan. Pengaturan default append disarankan.

      • Tingkat definisi data: Ini menunjukkan tingkat awal sub-bidang (setelah level “01”) yang ditentukan di bagian penyimpanan kerja dan tautan. Pasti angka.

      • Mulai kolom gambar: Ini tentang format kode COBOL yang dihasilkan dan menunjukkan kolom tempat klausa PIC ditempatkan (setelah nama bidang). Pasti angka.

      • Penempatan sumber asli: Ini menunjukkan posisi di mana komentar ditempatkan dalam program. Ini memiliki dua opsi:

        • KAN AN: Opsi ini akan menempatkan komentar atau informasi tambahan di posisi yang tepat setelah kolom tujuh puluh tiga (73). Dalam COBOL kode ditulis di tujuh puluh dua (1-72) kolom pertama dan apa pun dari kolom tujuh puluh tiga (>= 73) akan diperlakukan sebagai komentar.

        • ATAS: Opsi ini akan menempatkan komentar di atas konten yang diterjemahkan.

      • Hasilkan Sync FILLER dengan nama: Opsi ini terkait dengan penyelarasan dalam memori bidang biner (tipe data Assembler “H”, “F”, “D”, yang dikonversi ke tipe data COBOL “COMP”). Untuk menjamin batas penyelarasan yang tepat, bidang pengisi eksplisit akan ditambahkan selama konversi. Ini adalah opsi berbasis teks, nilainya harus berupa string (seperti FILL-SYNC).

      • Gunakan klausa SYNC: Opsi ini mengacu pada penyelarasan dalam memori bidang biner. Ya = semua bidang dikonversi ke COBOL. “COMP” akan didefinisikan dengan klausa “SYNC” (misalnya, 05 WRKFLD PIC S9 (09) COMP SYNC).

      • Koma titik desimal: Jika ini benar, klausa DECIMAL-POINT IS COMMA akan ditambahkan ke paragraf "SPECIAL-NAMES" COBOL.

    4. Berdasarkan kebutuhan Anda, ubah parameter yang sesuai, lalu simpanproject_settings.json.

    5. Hapus project_settings.json file yang ada dari prj_codebuild_01/ bucket Amazon S3, lalu unggah versi baru.

  3. Kembali ke AWS CodeBuild layanan.

  4. Pilih proyek untuk membangun yang Anda buat sebelumnya: 3-awsm2ccm-convert

    1. Pilih Mulai membangun, lalu Mulai sekarang untuk mengonversi program Assembler dan Macro ke program COBOL dan copybook.

    2. Tunggu status build berubah menjadi Ber hasil untuk proyek ini. Ini akan berada di bawah tab status build terbaru.

Langkah 10: Verifikasi konversi Kode

  1. Dari Konsol Manajemen AWS, buka layanan Amazon S3.

  2. Temukan dan klik bucket Amazon S3:codebuild-regionId-accountId-bucket.

  3. Arahkan ke awsm2ccm-do-not-delete . AWS Mainframe Modernization Konversi kode membuat file biner yang dikodekan untuk setiap modul Assembler atau Makro selama proses konversi. File-file ini penting untuk mencegah penagihan duplikat kepada pelanggan dan juga untuk melacak berapa banyak kode Assembler yang disediakan dianalisis dan dikonversi. File disimpan di lokasi berikut:codebuild-regionId-accountId- bucket/awsm2ccm-do-not-delete/<your_AWS_account_id>/Hash. File yang dikodekan tidak berisi kode Assembler dan juga tidak mungkin untuk mengekstrak kode pelanggan dari file-file ini.

    penting

    Jangan mengedit file-file ini secara manual atau menghapus file-file ini. Mengedit atau menghapus file-file ini dapat mengakibatkan beberapa tagihan untuk komponen yang sama.

    Perlakukan awsm2ccm-do-not-delete/ folder sebagai direktori yang dikelola sistem. Konsultasikan Dukungan sebelum membuat perubahan pada direktori ini atau isinya.

  4. Klik codebuild-regionId-accountId-bucket untuk kembali ke bucket.

  5. Memilih ARTIFACTS/prj_codebuild_01/. _Converted/ folder berisi output COBOL yang dihasilkan sebagai hasil dari langkah konversi Kode. Ini akan memiliki subdirektori berikut:

    • folder copybooks/ berisi copybooks COBOL yang dihasilkan.

    • programs/ folder berisi program COBOL yang dihasilkan.

    • folder runtime_lib/ berisi program COBOL tambahan dan buku salinan yang disediakan oleh solusi.

  6. Jika Laporan Analisis dan laporan lainnya menunjukkan bahwa konversi berhasil, dan AWS CodeBuild proyek 3-awsm2ccm-convert ditandai Berhasil, unduh kode COBOL dan buku salinan dari direktori _ Converted/.

Langkah 11: Unduh kode yang dikonversi

Pada langkah ini, unduh kode COBOL dan copybook dari direktori _Converted/, dan kompilasi mereka di lingkungan COBOL target.

  1. Dari Konsol Manajemen AWS, buka layanan Amazon S3.

  2. Temukan dan klik bucket Amazon S3:codebuild-regionId-accountId-bucket.

  3. Arahkan ke lokasi: ARTIFACTS/prj_codebuild_01/_Converted/.

  4. Unduh kode COBOL yang dikonversi dari semua subdirektori di bawah _Converted/. Anda juga dapat menggunakan perintah CLI berikut untuk mengunduhnya sekaligus:

    aws s3 cp s3://codebuild-regionId-accountId- bucket/ARTIFACTS/prj_codebuild_01/_Converted/ . --recursive
  5. Analisis dan kompilasi COBOL yang dikonversi di lingkungan COBOL target.

Pembersihan sumber daya

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 di Panduan Pengguna Layanan Penyimpanan Sederhana Amazon.

  • Hapus kebijakan IAM yang Anda buat untuk tutorial ini. Untuk informasi selengkapnya, lihat Menghapus kebijakan IAM di Panduan Pengguna IAM.

  • Hapus peran IAM yang Anda buat untuk tutorial ini. Untuk informasi selengkapnya, lihat Menghapus peran atau profil instance di Panduan Pengguna IAM.

  • Hapus CodeBuild proyek yang Anda buat untuk tutorial ini. Untuk informasi selengkapnya, lihat Mengh apus proyek build CodeBuild di dalam Panduan AWS CodeBuild Pengguna.