Tutorial: Konversi kode dari Assembler ke COBOL di AWS Mainframe Modernization

Mode fokus

Tutorial: Konversi kode dari Assembler ke COBOL di AWS Mainframe Modernization - AWS Modernisasi Mainframe

Prasyarat Langkah 1: Bagikan aset build dengan Akun AWS Langkah 2: Buat ember Amazon S3 Langkah 3: Buat kebijakan IAM Langkah 4: Buat peran IAM Langkah 5: Lampirkan kebijakan IAM ke peran IAM Langkah 6: Buat CodeBuild proyek Langkah 7: Tentukan proyek dan unggah kode sumber Langkah 8: Jalankan analisis dan pahami laporannya Langkah 9: Jalankan konversi Kode Langkah 10: Verifikasi konversi Kode Langkah 11: Unduh kode yang dikonversi Pembersihan sumber daya

Anda dapat menggunakan dokumen ini sebagai step-by-step panduan untuk memahami cara mengonversi kode Assembler modernisasi mainframe ke COBOL. Selain itu, Anda juga dapat merujuk konversi kode otomatis dari Assembler ke bengkel COBOL untuk mempelajari lebih lanjut tentang proses konversi.

Topik

Prasyarat

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

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

Buka AWS Mainframe Modernization konsol di https://console.aws.amazon.com/m2/.
Di navigasi kiri, pilih Tools.
Dalam Konversi Kode Modernisasi AWS Mainframe dengan mLogica, pilih Bagikan aset dengan my. Akun AWS

penting

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

Langkah 2: Buat ember Amazon S3

Pada langkah ini, Anda membuat ember Amazon S3. Bucket pertama adalah bucket proyek AWS CodeBuild untuk menahan kode sumber dan kemudian mendorong bucket output 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.

Untuk membuat bucket proyek, masuk ke konsol Amazon S3, dan pilih Buat bucket.
Dalam konfigurasi Umum, berikan nama untuk bucket dan tentukan Wilayah AWS tempat Anda ingin membuat bucket. Contoh nama adalahcodebuild-regionId-accountId-bucket, di mana:
- regionIdadalah Wilayah AWS ember.
- accountIdadalah Akun AWS ID Anda.
catatan
Jika Anda membuat bucket berbeda Wilayah AWS dari US East (Virginia N.), tentukan LocationConstraint parameternya. Untuk informasi selengkapnya, lihat Membuat Bucket di Referensi API Amazon Simple Storage Service.
Pertahankan semua pengaturan lainnya, dan pilih Buat ember.

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

Langkah 3: Buat kebijakan IAM

Pada langkah ini, Anda membuat kebijakan IAM. Kebijakan IAM yang disediakan memberikan izin khusus AWS CodeBuild untuk berinteraksi dengan Amazon S3, Amazon Elastic Container Registry, CloudWatch log Amazon yang CodeBuild menghasilkan, dan sumber daya untuk konversi Kode. Amazon Elastic Compute Cloud Kebijakan ini tidak disesuaikan untuk pelanggan. Kebijakan 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

Masuk ke konsol IAM, dan pilih Kebijakan di panel navigasi kiri.
Pilih Buat kebijakan.

Salin dan tempel kebijakan JSON berikut ke editor kebijakan.


{ 
    "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" 
         } 
    ] 
}

Anda dapat menambahkan tag ke kebijakan secara opsional. Tag adalah pasangan nilai kunci yang dapat membantu Anda mengatur, melacak, atau mengontrol akses untuk kebijakan tersebut.
Pilih Selanjutnya: Tinjau.
Berikan nama untuk kebijakan tersebut, misalnya,CodeBuildAWSM2CCMPolicy.
Anda dapat secara opsional memasukkan deskripsi untuk kebijakan tersebut, dan meninjau ringkasan kebijakan untuk memastikannya benar.
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.

Masuk ke konsol IAM, dan pilih Peran di panel navigasi kiri.
Pilih Buat peran.
Di bawah Jenis entitas Tepercaya, pilih layanan AWS.
Di bawah Kasus penggunaan untuk layanan AWS lainnya CodeBuild, pilih, lalu pilih CodeBuildlagi.
Pilih Berikutnya.
Pada halaman Tambahkan izin, pilih Berikutnya. Anda menetapkan kebijakan untuk peran nanti.
Di bawah Rincian peran, berikan nama untuk peran tersebut, misalnya,IAMRoleTaskExecutionRoleForCodeBuild.

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


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

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.

Masuk ke konsol IAM, dan pilih Peran di panel navigasi kiri.
Di Peran, pilih peran yang Anda buat sebelumnya, misalnya,IAMRoleTaskExecutionRoleForCodeBuild.
Di kebijakan Izin, pilih Tambahkan izin, lalu Lampirkan kebijakan.
Di Kebijakan izin lainnya, pilih kebijakan yang Anda buat sebelumnya, misalnya,CodeBuildAWSM2CCMPolicy.
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

Masuk ke CodeBuild konsol, dan pilih Buat proyek build.
Di bagian konfigurasi Proyek, berikan nama untuk proyek, misalnya,1-awsm2ccm-define-project.
Di bagian Sumber, untuk penyedia Sumber, tinggalkan pilihan default.
Di bagian Lingkungan, pilih Gambar khusus.
Di bidang Environment type, pilih Linux.
Di bawah Registri gambar, pilih Registri lain.
Di bidang URL registri eksternal, ikuti AWS Mainframe Modernization kontainer bagian ini.
Di bawah Peran layanan, pilih Peran layanan yang ada, dan di bidang ARN Peran, pilih peran layanan yang Anda buat sebelumnya (mis.,IAMRoleTaskExecutionRoleForCodeBuild).
Perluas bagian Konfigurasi tambahan, lakukan hal berikut:
1. VPC: Konfigurasikan jika diperlukan berdasarkan pengaturan Anda.
2. Batas waktu: Setel ke 60 menit.
3. Batas waktu antrian: Setel ke 480 menit.
4. Enkripsi: Pilih pengaturan enkripsi yang sesuai (default baik-baik saja).
5. Di bagian variabel Lingkungan, tambahkan yang berikut ini satu per satu:
  - Nama: PROJECT_BUCKET. Nilai:codebuild-regionId-accountId- bucket. Jenis: Plaintext
  - Nama: PROJECT_DIR. Nilai:prj_codebuild_01. Jenis: Plaintext
  - Nama: AWSM2CCM_ACTION. Nilai:define_project. Jenis: Plaintext
  - Nama: AWSM2CCM_LOGGING_BUCKET. Nilai:s3:// codebuild-regionId-accountId-bucket. Jenis: Plaintext
Di bagian Buildspec, pilih Sisipkan perintah build, lalu Beralih ke editor.

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

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

Di bagian Artefak, lakukan ini:
- di bawah Ketik, 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 Artifact, pilih None.
- untuk Ganti nama artefak, hapus centang opsi ini.
- untuk Enkripsi, biarkan ke pengaturan default.
Untuk bagian Log, lakukan hal berikut:
- CloudWatch log: Dinonaktifkan
- Log S3: Diaktifkan
- Ember: codebuild-regionId-account-bucket
- Jalur log: CODEBUILD-LOGS
Pilih Buat proyek build.

Langkah 6.2: Buat proyek Analisis Kode

Untuk membuat proyek Analisis Kode

Masuk ke CodeBuild konsol, dan pilih Buat proyek build.
Di bagian konfigurasi Proyek, berikan nama untuk proyek, misalnya,2-awsm2ccm-analysis.
Di bagian Sumber, untuk penyedia Sumber, pilih Amazon S3, lalu pilih bucket input yang Anda buat sebelumnya (mis.,codebuild-regionId-accountId-bucket).
Di bidang kunci objek S3 atau folder S3, masukkan. prj_codebuild_01
Di bagian Lingkungan, pilih Gambar khusus.
Di bidang Environment type, pilih Linux.
Di bawah Registri gambar, pilih Registri lain.
Di bidang URL registri eksternal, ikuti AWS Mainframe Modernization kontainer bagian ini.
Di bawah Peran layanan, pilih Peran layanan yang ada, dan di bidang ARN Peran, pilih peran layanan yang Anda buat sebelumnya (mis.,IAMRoleTaskExecutionRoleForCodeBuild).
Perluas bagian Konfigurasi tambahan, lakukan hal berikut:
1. VPC: Konfigurasikan jika diperlukan berdasarkan pengaturan Anda.
2. Batas waktu: Setel ke 60 menit.
3. Batas waktu antrian: Setel ke 480 menit.
4. Enkripsi: Pilih pengaturan enkripsi yang sesuai (default baik-baik saja).
5. Di bagian variabel Lingkungan, tambahkan yang berikut ini satu per satu:
  - Nama: PROJECT_BUCKET. Nilai:codebuild-regionId-accountId-bucket. Jenis: Plaintext
  - Nama: PROJECT_DIR. Nilai:prj_codebuild_01. Jenis: Plaintext
  - Nama: AWSM2CCM_ACTION. Nilai:analysis. Jenis: Plaintext
  - Nama: AWSM2CCM_LOGGING_BUCKET. Nilai:s3:// codebuild-regionId-accountId-bucket. Jenis: Plaintext
Di bagian Buildspec, pilih Sisipkan perintah build, lalu Beralih ke editor.

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

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

Di bagian Artefak, lakukan ini:
- di bawah Ketik, pilih Amazon S3, lalu pilih bucket keluaran Anda (mis.,codebuild-regionId-accountId-bucket).
- untuk Path, masukkan ARTIFACTS.
- untuk Nama, masukkanprj_codebuild_01.
- untuk kemasan Artifact, pilih None.
- untuk Ganti nama artefak, hapus centang opsi ini.
- untuk Enkripsi, biarkan ke pengaturan default.
Untuk bagian Log, lakukan hal berikut:
- CloudWatch log: Dinonaktifkan
- Log S3: Diaktifkan
- Ember: codebuild-regionId-account-bucket
- Jalur log: CODEBUILD-LOGS
Pilih Buat proyek build.

Langkah 6.3: Buat proyek Konversi Kode

Untuk membuat proyek Konversi Kode

Masuk ke CodeBuild konsol, dan pilih Buat proyek build.
Di bagian konfigurasi Proyek, berikan nama untuk proyek (misalnya,3-awsm2ccm-convert).
Di bagian Sumber, untuk penyedia Sumber, pilih Amazon S3, lalu pilih bucket input yang Anda buat sebelumnya (mis.,codebuild-regionId-accountId-bucket).
Di bidang kunci objek S3 atau folder S3, masukkan. prj_codebuild_01
Di bagian Lingkungan, pilih Gambar khusus.
Di bidang Environment type, pilih Linux.
Di bawah Registri gambar, pilih Registri lain.
Di bidang URL registri eksternal, ikuti AWS Mainframe Modernization kontainer bagian ini.
Di bawah Peran layanan, pilih Peran layanan yang ada, dan di bidang ARN Peran, pilih peran layanan yang Anda buat sebelumnya; misalnya,. IAMRoleTaskExecutionRoleForCodeBuild
Perluas bagian Konfigurasi tambahan, lakukan hal berikut:
1. VPC: Konfigurasikan jika diperlukan berdasarkan pengaturan Anda.
2. Batas waktu: Setel ke 60 menit.
3. Batas waktu antrian: Setel ke 480 menit.
4. Enkripsi: Pilih pengaturan enkripsi yang sesuai (default baik-baik saja).
5. Di bagian variabel Lingkungan, tambahkan yang berikut ini satu per satu:
  - Nama: PROJECT_BUCKET. Nilai:codebuild-regionId-accountId-bucket. Jenis: Plaintext
  - Nama: PROJECT_DIR. Nilai:prj_codebuild_01. Jenis: Plaintext
  - Nama: AWSM2CCM_ACTION. Nilai:conversion. Jenis: Plaintext
  - Nama: AWSM2CCM_LOGGING_BUCKET. Nilai:s3:// codebuild-regionId-accountId-bucket. Jenis: Plaintext
Di bagian Buildspec, pilih Sisipkan perintah build, lalu Beralih ke editor.

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

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

Di bagian Artefak, lakukan ini:
- di bawah Ketik, pilih Amazon S3, lalu pilih bucket keluaran Anda (mis.,codebuild-regionId-accountId-bucket).
- untuk Path, masukkan ARTIFACTS.
- untuk Nama, masukkanprj_codebuild_01.
- untuk kemasan Artifact, pilih None.
- untuk Ganti nama artefak, hapus centang opsi ini.
- untuk Enkripsi, biarkan ke pengaturan default.
Untuk bagian Log, lakukan hal berikut:
- CloudWatch log: Dinonaktifkan
- Log S3: Diaktifkan
- Ember: codebuild-regionId-account-bucket
- Jalur log: CODEBUILD-LOGS
Pilih Buat proyek build.

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 build. Untuk melakukannya:

Masuk ke AWS CodeBuild konsol.
Di panel navigasi kiri pilih Build projects.
Pilih project (1-awsm2ccm-define-project) yang telah dibuat sebelumnya untuk membangun
Pilih Mulai membangun, dan kemudian Mulai sekarang untuk menentukan proyek. Setelah build dimulai, status akan berubah menjadi sedang berlangsung.
Pilih Detail fase untuk melihat kemajuan setiap langkah yang diatur oleh proyek. AWS CodeBuild
Tunggu sampai status telah berubah untuk berhasil untuk semua langkah.
Buka konsol Amazon S3.
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 analisis dan langkah konversi.
  1. Pilih macrolib/.
  2. Secara default satu nama makro Assembler 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 analisis dan langkah konversi.
  1. Pilih srclib/.
  2. Secara default, dua program Assembler diberi nama SQtest01.asm 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.
Verifikasi status untuk 1-awsm2ccm-define-project langkah. Seharusnya berhasil di bawah tab status build Terbaru.

Anda siap untuk langkah selanjutnya: Analisis kode.

Langkah 8: Jalankan analisis dan pahami laporannya

catatan

AWS Mainframe Modernization Langkah analisis konversi kode tidak dikenai biaya.

Pada langkah ini, Anda memulai build lain:

Di panel navigasi kiri, pilih Membangun proyek.
Pilih proyek yang Anda buat di langkah 6.2 untuk membangun:2-awsm2ccm-analysis.
Pilih Mulai build, lalu Mulai sekarang untuk menghasilkan laporan analisis. Ini akan memulai build dan mengubah status menjadi sedang berlangsung.
Pilih Detail fase di mana Anda akan melihat kemajuan setiap langkah yang diatur oleh proyek. AWS CodeBuild Tunggu hingga status berubah berhasil untuk semua langkah.
Dari AWS Management Console, buka konsol layanan Amazon S3.
Temukan dan klik bucket Amazon S3: codebuild-regionId-accountId-bucket
1. ARTIFACTS/folder berisi output analisis dan langkah konversi.
2. Pilih ARTIFACTS/prj_codebuild_01/_Reports/.
3. Laporan-laporan berikut akan tersedia:
  - AWSM2CCM-Analysis-Report-<timestamp>.pdfadalah laporan eksekutif yang menyediakan penagihan dan ruang lingkup konversi AWS Mainframe Modernization Kode, meningkatkan konversi, ringkasan konversi, dan statistik konversi terperinci. Ini juga merangkum jumlah kode dan jumlah kode yang dapat ditagih pada 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 menyediakan cara cepat untuk mengidentifikasi apakah instruksi jelas bahwa konverter tidak mendukung. Kemungkinan hasil status Konversi adalah:
    Benar-benar dikonversi: instruksi akan secara akurat dikonversi 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.
    
    Instruksi pra-kompilasi untuk memverifikasi: ini biasanya disertakan di dalam Makro, dan merujuk pada apa yang mungkin dikenal juga sebagai instruksi Bahasa Majelis Bersyarat (misalnya, AIF, AGO) pada mainframe. Ini ditangani oleh pra-kompiler yang didorong oleh instruksi atau arahan tersebut memilih dan menghasilkan kode ASM bersih/statis. Instruksi ini bergantung pada nilai aktual dari parameter Makro yang dikompilasi. Jadi, Makro yang sama dapat menghasilkan potongan kode ASM yang berbeda, tergantung pada nilai parameter yang dilewatkan. 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.txtlaporan tentang dependensi program Assembler pada Macro. Ini menyediakan cara cepat untuk menentukan apakah ada Macro yang hilang dari kode yang diunggah.
  - CrossReference_PgmToPgm.txtlaporan tentang dependensi program Assembler pada program Assembler lainnya. Ini menyediakan cara cepat untuk menentukan apakah ada program Assembler yang hilang dari kode yang diunggah.
Kembali ke konsol AWS CodeBuild layanan.
Verifikasi status untuk langkah analisis 2-awsm2ccm. Seharusnya berhasil di bawah tab status build Terbaru.

Anda siap untuk langkah selanjutnya: Konversi kode.

Langkah 9: Jalankan konversi Kode

penting

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

Pada langkah ini, Anda akan mengonfigurasi proses konversi, dan kemudian memulai build.

Dari AWS Management Console, buka layanan Amazon S3.
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.
  - Sumber Copybooks/direktori Macro: berisi Assembler Macro dan copybook yang diperlukan untuk konversi.
  - Konversi Copybook/Macro dapat berupa:
    Semua: Tombol radio ini menunjukkan bahwa konversi penuh akan mengonversi semua Copybook/makro yang tersedia di direktori terlepas dari apakah yang sedang digunakan oleh program atau tidak.
    
    Called_only: Tombol radio ini menunjukkan bahwa konversi penuh hanya akan mengonversi copybook/makro yang benar-benar digunakan oleh program.
  - penting
    Anda tidak perlu membuat ulang Copy/Macro jika sudah ada.
    
    Jika ini benar, alat tidak akan mengonversi Copybook/makro lagi, jika sudah dikonversi (ada di folder output).
  - Target: Konversi program (kode yang dihasilkan) tergantung pada kompiler COBOL target. Opsi berikut didukung:
    “IBM” untuk mainframe IBM
    
    “MF” untuk Micro Focus COBOL
    
    “VERYANT” untuk Veryant iScobol
    
    “NTT” untuk NTT DATA Enterprise COBOL (Unikix)
  - Endianess and 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)/Little (Little-Endian). Misalnya, mainframe IBM z/OS adalah Big-Endian, Windows adalah Little-Endian, Linux bervariasi berdasarkan distribusi (misalnya Amazon Linux 2 on adalah Little-Endian). EC2
    
    Bitness: 32/64 (jika tidak diberikan, default akan 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 Rocket Software (sebelumnya Micro Focus) target COBOL, CBL direkomendasikan 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 COBOL Perangkat Lunak Rocket, CBL direkomendasikan untuk memungkinkan Pengembang Perusahaan Rocket mengenali file dengan benar.
  - Ekstensi Copybooks/Macro yang dikonversi: Ini untuk mengatur ekstensi file untuk copybook COBOL yang dihasilkan. Kosong (“”):: tidak ada ekstensi. Untuk target COBOL Perangkat Lunak Rocket, CPY disarankan untuk memungkinkan Pengembang Perusahaan Rocket mengenali file dengan benar.
  - Level jejak: Trace 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
  - Lacak mode terbuka file: Tidak digunakan. Pengaturan default append direkomendasikan.
  - 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:
    KANAN: Opsi ini akan menempatkan komentar atau informasi tambahan di posisi yang tepat setelah kolom tujuh puluh tiga (73). Dalam COBOL kode ditulis dalam 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 FILLER Sinkronisasi dengan nama: Opsi ini terkait dengan penyelarasan dalam memori bidang biner (Assembler “H”, “F”, “D” tipe data, 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 perataan 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 DESIMAL-POINT IS COMMA akan ditambahkan ke paragraf COBOL “SPECIAL-NAMES”.
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.
Kembali ke AWS CodeBuild layanan.
Pilih proyek yang akan dibuat sebelumnya: 3-awsm2ccm-convert
1. Pilih Mulai membangun, dan kemudian Mulai sekarang untuk mengonversi program Assembler dan Macro ke program COBOL dan copybook.
2. Tunggu status build berubah menjadi Succeeded untuk proyek ini. Ini akan berada di bawah tab Status build terbaru.

Langkah 10: Verifikasi konversi Kode

Dari AWS Management Console, buka layanan Amazon S3.
Temukan dan klik bucket Amazon S3:. codebuild-regionId-accountId-bucket
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 sangat penting untuk mencegah penagihan duplikat ke 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 mengandung kode Assembler dan juga tidak mungkin untuk mengekstrak kode pelanggan dari file-file ini.

penting
Tidak 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 apa pun pada direktori ini atau isinya.
Klik codebuild-regionId-accountId-bucket untuk kembali ke ember.
Pilih ARTIFACTS/prj_codebuild_01/. _Converted/ folder berisi output COBOL yang dihasilkan sebagai hasil dari langkah konversi Kode. Ini akan memiliki subdirektori berikut:
- copybooks/folder berisi copybook COBOL yang dihasilkan.
- program/folder berisi program COBOL yang dihasilkan.
- folder runtime_lib/ berisi program COBOL tambahan dan copybook yang disediakan oleh solusi.
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 di lingkungan COBOL target.

Dari AWS Management Console, buka layanan Amazon S3.
Temukan dan klik bucket Amazon S3:. codebuild-regionId-accountId-bucket
Arahkan ke lokasi:ARTIFACTS/prj_codebuild_01/_Converted/.
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
```
Menganalisis dan mengkompilasi 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 instans di Panduan Pengguna IAM.
Hapus CodeBuild proyek yang Anda buat untuk tutorial ini. Untuk informasi selengkapnya, lihat Menghapus proyek build CodeBuild di Panduan AWS CodeBuild pengguna.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Memahami komponen dan proses

Integrasi Charon

Topik berikutnya:

Integrasi Charon

Topik sebelumnya:

Memahami komponen dan proses

Perlu bantuan?

Di halaman ini

Apakah halaman ini membantu Anda?

Berikan umpan balik

Privasi Syarat situs Preferensi cookie

Pilih preferensi cookie Anda

Sesuaikan preferensi cookie

Penting

Kinerja

Fungsional

Iklan

Tidak dapat menyimpan preferensi cookie

Tutorial: Konversi kode dari Assembler ke COBOL di AWS Mainframe Modernization

Topik

Prasyarat

penting

Langkah 2: Buat ember Amazon S3

catatan

Langkah 3: Buat kebijakan IAM

Untuk membuat kebijakan

Langkah 4: Buat peran IAM

Langkah 5: Lampirkan kebijakan IAM ke peran IAM

Langkah 6: Buat CodeBuild proyek

Langkah 6.1: Buat proyek Define

Untuk membuat proyek Define

Langkah 6.2: Buat proyek Analisis Kode

Untuk membuat proyek Analisis Kode

Langkah 6.3: Buat proyek Konversi Kode

Untuk membuat proyek Konversi Kode

Langkah 7: Tentukan proyek dan unggah kode sumber

Langkah 8: Jalankan analisis dan pahami laporannya

catatan

Langkah 9: Jalankan konversi Kode

penting

penting

Langkah 10: Verifikasi konversi Kode

penting

Langkah 11: Unduh kode yang dikonversi

Pembersihan sumber daya

Topik berikutnya:

Topik sebelumnya:

Perlu bantuan?

Di halaman ini

Apakah halaman ini membantu Anda?