View a markdown version of this page

教程:将代码从汇编器转换为 COBOL AWS Mainframe Modernization - AWS Mainframe Modernization

经过仔细考虑,我们决定从 2026 年 6 月 30 日起关闭新客户访问AWS大型机现代化自我管理体验的权限。现有客户可以继续照常使用该服务。AWS继续投资改善AWS大型机现代化自我管理体验的安全性和可用性,但我们不打算引入新功能。有关更多信息,请参阅AWS大型机现代化可用性变更

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

AWS大型机现代化服务(托管运行时环境体验)不再向新客户开放。有关类似于AWS大型机现代化服务(托管运行时环境体验)的功能,请浏览AWS大型机现代化服务(Self-Managed体验)。现有客户可以继续正常使用该服务。有关更多信息,请参阅AWS大型机现代化可用性变更

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

教程:将代码从汇编器转换为 COBOL AWS Mainframe Modernization

您可以将本文档用作分步指南,了解如何将大型机现代化汇编器代码转换为 COBOL。除此之外,您还可以参阅从汇编器到 COBOL 的自动代码转换讲习会,了解有关该转换过程的更多信息。

先决条件

阅读本了解汇编器转换的代码转换功能计费节,了解 Assembler 代码转换如何对您产生费用(账单报告)AWS 账户管理,以及计费的工作方式。

步骤 1:与共享构建资产AWS 账户

在此步骤中,请确保与您共享构建资产AWS 账户,尤其是在使用资产的区域。

  1. 打开AWS Mainframe Modernization控制台,网址为https://console.aws.amazon.com/m2/

  2. 在左侧导航中,选择工具

  3. 使用 mLogica 进行的 AWS 大型机现代化代码转换中,选择与我共享资产。AWS 账户

重要

您需要在要进行构建的每个AWS区域执行一次此步骤。

步骤 2:创建 Amazon S3 存储桶

在此步骤中,您将创建 Amazon S3 存储桶。第一个存储桶是供AWS CodeBuild保存源代码的项目存储桶,然后推送输出存储桶以保存AWS CodeBuild输出(转换后的代码)。有关更多信息,请参阅《Amazon S3 用户指南》中的创建、配置和使用 Amazon S3 存储桶

  1. 要创建项目存储桶,请登录 Amazon S3 控制台,然后选择创建存储桶

  2. 常规配置中,提供存储桶的名称并指定要AWS 区域在哪里创建存储桶。一个示例名称为 codebuild-regionId-accountId-bucket,其中:

    • regionId是最AWS 区域重要的。

    • accountId是你的AWS 账户身份证。

    注意

    如果您要在与美国东部(弗吉尼亚北部)不同的AWS 区域位置创建存储桶,请指定LocationConstraint参数。有关更多信息,请参阅《Amazon Simple Storage Service API 参考》中的创建存储桶

  3. 保留所有其他设置,并选择创建存储桶

无论您为这些存储桶选择的名称如何,请务必在本教程中保持统一。

步骤 3:创建 IAM 策略

在此步骤中,您将创建一个 IAM 策略。所提供的 IAM 策略授予与 Amazon S3、Amazon 弹性容器注册表、 CodeBuild 生成的亚马逊 CloudWatch 日志以及用于代码转换的Amazon Elastic Compute Cloud资源进行交互的特定权限AWS CodeBuild。此策略不是为客户自定义的。该政策授予交互权限,并获取代码转化统计数据以向客户开具相应账单的权限。AWS Mainframe Modernization

要了解如何创建 IAM 策略,请参阅《IAM 用户指南》中的创建 IAM 策略

创建策略
  1. 登录 IAM 控制台,然后在左侧导航窗格中选择策略

  2. 选择创建策略

  3. 将下面的 JSON 策略复制并粘贴到策略编辑器中。

    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. (可选)您可以向策略添加标签。标签是一些键值对,可以帮助您组织、跟踪或控制对策略的访问。

  5. 选择 Next:Review

  6. 提供策略名称,例如 CodeBuildAWSM2CCMPolicy

  7. (可选)您可以输入策略的描述,并检查策略摘要以确保其正确。

  8. 选择创建策略

步骤 4:创建 IAM 角色

在此步骤中,在 CodeBuild 将之前创建的 IAM 策略与该新 IAM 角色关联后,您将创建一个允许您与AWS资源交互的新 IAM 角色。

有关创建服务角色的信息,请参阅 IAM 用户指南中的创建角色以向AWS服务委派权限

  1. 登录 IAM 控制台,然后在左侧导航窗格中选择角色

  2. 选择创建角色

  3. 可信实体类型下,选择 AWS 服务

  4. 在 “其他 AWS 服务的使用案例” 下 CodeBuild,选择,然后CodeBuild再次选择。

  5. 选择下一步

  6. 添加权限页面上,选择下一步。您稍后给该角色分配策略。

  7. 角色详细信息下,提供角色的名称,例如 IAMRoleTaskExecutionRoleForCodeBuild

  8. 选择可信实体下,验证策略文档是否如下所示:

    JSON
    { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "codebuild.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }
  9. 选择创建角色

步骤 5:将 IAM 策略附加到 IAM 角色

在此步骤中,您需要将之前创建的 IAM 策略附加到 IAMRoleTaskExecutionRoleForCodeBuild IAM 角色。

  1. 登录 IAM 控制台,然后在左侧导航窗格中选择角色

  2. 角色中,选择您之前创建的角色,例如 IAMRoleTaskExecutionRoleForCodeBuild

  3. 权限策略中,依次选择添加权限附加策略

  4. 其他权限策略中,选择您之前创建的策略,例如 CodeBuildAWSM2CCMPolicy

  5. 选择附加策略

步骤 6:创建 CodeBuild 项目

在此步骤中,您将基于上述buildspec.yml文件创建三个不同的 CodeBuild 项目。

步骤 6.1:创建定义项目

创建定义项目
  1. 登录 CodeBuild 控制台,然后选择 “创建构建项目”。

  2. 项目配置部分中,为项目提供一个名称,例如 1-awsm2ccm-define-project

  3. 部分中,对于源提供商,保留默认选择。

  4. 环境部分中,选择自定义映像

  5. 环境类型字段中,选择 Linux

  6. 映像注册表中,选择其他注册表

  7. 外部注册表 URL 字段中,按照 AWS Mainframe Modernization容器部分中的说明进行操作。

  8. 服务角色下,选择现有服务角色,然后在角色 ARN 字段中,选择您之前创建的服务角色(例如 IAMRoleTaskExecutionRoleForCodeBuild)。

  9. 展开其他配置部分,进行如下设置:

    1. VPC:请根据您的设置需要进行配置。

    2. 超时:设置为 60 分钟

    3. 排队超时:设置为 480 分钟

    4. 加密:选择适当的加密设置(默认设置即可)。

    5. 环境变量部分中,逐一添加以下内容:

      • 名称:PROJECT_BUCKET。值:codebuild-regionId-accountId- bucket。类型:Plaintext

      • 名称:PROJECT_DIR。值:prj_codebuild_01。类型:Plaintext

      • 名称:AWSM2CCM_ACTION。值:define_project。类型:Plaintext

      • 名称:AWSM2CCM_LOGGING_BUCKET。值:s3:// codebuild-regionId-accountId-bucket。类型:Plaintext

  10. Buildspec 部分中,选择插入构建命令,然后选择切换到编辑器

  11. 将当前值替换为:

    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

    其中,PROJECT_DIR 是其中可用的环境变量。 CodeBuild有关更多信息,请参阅构建环境中的环境变量

  12. 构件部分中,执行以下操作:

    • 类型下,选择 Amazon S3,然后选择您的输出存储桶,例如 codebuild-regionId-accountId-bucket

    • 对于路径,请将此字段留空。

    • 对于名称,请输入 prj_codebuild_01

    • 对于构件打包,请选择

    • 对于覆盖构件名称,请取消选中此选项。

    • 对于加密,请保留默认设置。

  13. 对于日志部分,请按如下方式设置:

    • CloudWatch 日志:已禁用

    • S3 日志:已启用

    • 存储桶:codebuild-regionId-account-bucket

    • 日志路径:CODEBUILD-LOGS

  14. 选择 Create build project(创建构建项目)

步骤 6.2:创建代码分析项目

创建代码分析项目
  1. 登录 CodeBuild 控制台,然后选择 “创建构建项目”。

  2. 项目配置部分中,为项目提供一个名称,例如 2-awsm2ccm-analysis

  3. 部分中,对于源提供商,请选择 Amazon S3,然后选择您之前创建的输入存储桶(例如 codebuild-regionId-accountId-bucket)。

  4. S3 对象键S3 文件夹字段中,输入 prj_codebuild_01

  5. 环境部分中,选择自定义映像

  6. 环境类型字段中,选择 Linux

  7. 映像注册表中,选择其他注册表

  8. 外部注册表 URL 字段中,按照 AWS Mainframe Modernization容器部分中的说明进行操作。

  9. 服务角色下,选择现有服务角色,然后在角色 ARN 字段中,选择您之前创建的服务角色(例如 IAMRoleTaskExecutionRoleForCodeBuild)。

  10. 展开其他配置部分,进行如下设置:

    1. VPC:请根据您的设置需要进行配置。

    2. 超时:设置为 60 分钟

    3. 排队超时:设置为 480 分钟

    4. 加密:选择适当的加密设置(默认设置即可)。

    5. 环境变量部分中,逐一添加以下内容:

      • 名称:PROJECT_BUCKET。值:codebuild-regionId-accountId-bucket。类型:Plaintext

      • 名称:PROJECT_DIR。值:prj_codebuild_01。类型:Plaintext

      • 名称:AWSM2CCM_ACTION。值:analysis。类型:Plaintext

      • 名称:AWSM2CCM_LOGGING_BUCKET。值:s3:// codebuild-regionId-accountId-bucket。类型:Plaintext

  11. Buildspec 部分中,选择插入构建命令,然后选择切换到编辑器

  12. 将当前值替换为:

    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

    其中,PROJECT_DIR 是其中可用的环境变量。 CodeBuild有关更多信息,请参阅构建环境中的环境变量

  13. 构件部分中,执行以下操作:

    • 类型下,选择 Amazon S3,然后选择您的输出存储桶(例如 codebuild-regionId-accountId-bucket)。

    • 对于路径,请输入 ARTIFACTS

    • 对于名称,请输入 prj_codebuild_01

    • 对于构件打包,请选择

    • 对于覆盖构件名称,请取消选中此选项。

    • 对于加密,请保留默认设置。

  14. 对于日志部分,请按如下方式设置:

    • CloudWatch 日志:已禁用

    • S3 日志:已启用

    • 存储桶:codebuild-regionId-account-bucket

    • 日志路径:CODEBUILD-LOGS

  15. 选择 Create build project(创建构建项目)

步骤 6.3:创建代码转换项目

创建代码转换项目
  1. 登录 CodeBuild 控制台,然后选择 “创建构建项目”。

  2. 项目配置部分中,为项目提供一个名称(例如 3-awsm2ccm-convert)。

  3. 部分中,对于源提供商,请选择 Amazon S3,然后选择您之前创建的输入存储桶(例如 codebuild-regionId-accountId-bucket)。

  4. S3 对象键S3 文件夹字段中,输入 prj_codebuild_01

  5. 环境部分中,选择自定义映像

  6. 环境类型字段中,选择 Linux

  7. 映像注册表中,选择其他注册表

  8. 外部注册表 URL 字段中,按照 AWS Mainframe Modernization容器部分中的说明进行操作。

  9. 服务角色下,选择现有服务角色,然后在角色 ARN 字段中,选择您之前创建的服务角色,例如 IAMRoleTaskExecutionRoleForCodeBuild

  10. 展开其他配置部分,进行如下设置:

    1. VPC:请根据您的设置需要进行配置。

    2. 超时:设置为 60 分钟

    3. 排队超时:设置为 480 分钟

    4. 加密:选择适当的加密设置(默认设置即可)。

    5. 环境变量部分中,逐一添加以下内容:

      • 名称:PROJECT_BUCKET。值:codebuild-regionId-accountId-bucket。类型:Plaintext

      • 名称:PROJECT_DIR。值:prj_codebuild_01。类型:Plaintext

      • 名称:AWSM2CCM_ACTION。值:conversion。类型:Plaintext

      • 名称:AWSM2CCM_LOGGING_BUCKET。值:s3:// codebuild-regionId-accountId-bucket。类型:Plaintext

  11. Buildspec 部分中,选择插入构建命令,然后选择切换到编辑器

  12. 将当前值替换为:

    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

    其中,PROJECT_DIR 是其中可用的环境变量。 CodeBuild有关更多信息,请参阅构建环境中的环境变量

  13. 构件部分中,执行以下操作:

    • 类型下,选择 Amazon S3,然后选择您的输出存储桶(例如 codebuild-regionId-accountId-bucket)。

    • 对于路径,请输入 ARTIFACTS

    • 对于名称,请输入 prj_codebuild_01

    • 对于构件打包,请选择

    • 对于覆盖构件名称,请取消选中此选项。

    • 对于加密,请保留默认设置。

  14. 对于日志部分,请按如下方式设置:

    • CloudWatch 日志:已禁用

    • S3 日志:已启用

    • 存储桶:codebuild-regionId-account-bucket

    • 日志路径:CODEBUILD-LOGS

  15. 选择 Create build project(创建构建项目)

步骤 7:定义项目并上传源代码

定义项目会设置项目文件夹和配置文件,并使用默认配置进行初始化。在此步骤中,启动构建。要实现此目的,应按照以下步骤进行:

  1. 登录AWS CodeBuild控制台。

  2. 在左侧导航窗格中,选择构建项目

  3. 选择先前创建的项目(1-awsm2ccm-define-project)来进行构建

  4. 选择开始构建,然后选择立即开始来定义项目。构建开始后,状态将变为进行中

  5. 选择 “阶段详细信息” 以查看由项目编排的每个步骤的进度。AWS CodeBuild

  6. 等待所有步骤的状态均变为已成功

  7. 前往 Amazon S3 控制台。

  8. 找到并单击名为 codebuild-regionId-accountId-bucket 的 Amazon S3 存储桶

    • CODEBUILD-LOGS/文件夹包含正在运行的AWS CodeBuild项目的AWS CodeBuild日志。

    • prj_codebuild_01/ 文件夹包含项目结构。该文件夹在分析、扩展宏和转换步骤中使用。您可以选择 prj_codebuild_01/ 来了解详细信息

    • cobol_reserved.rsw 是为转换器保留的配置文件(COBOL 字列表)。该文件在转换步骤中使用。

    • Macro_Expansion/ 文件夹包含要扩展到汇编器程序中的宏。该文件夹在扩展宏步骤中使用。

    • macro_settings.json 配置文件包含自定义宏替换。该文件在扩展宏步骤中使用。

    • macrolib/ 文件夹包含要转换的汇编器宏。该文件夹在分析和转换步骤中使用。

      1. 选择 macrolib/

      2. 默认会提供一个名为 MACRO1.mac 的汇编器宏作为示例文件。请删除此文件,因为分析不需要该文件。

      3. 将您的宏上传到此目录中。

    • project_settings_aux.json 配置文件包含与代码页相关的设置。该文件在转换步骤中使用。

    • project_settings.json 配置文件包含转换器的设置。该文件在转换步骤中使用。

    • srclib/ 文件夹包含要转换的汇编器程序。该文件夹在分析和转换步骤中使用。

      1. 选择 srclib/

      2. 默认会提供名为 SQtest01.asmSQtest02.asm 的两个汇编器程序作为示例。请删除这两个文件,因为分析和转换不需要它们。

      3. 将您的汇编器程序上传到此目录中。

  9. 确认 1-awsm2ccm-define-project 步骤的状态。此步骤应该在最新构建状态选项卡下显示为“已成功”。

您已准备好进行下一步操作:代码分析

步骤 8:运行分析并理解报告

注意

AWS Mainframe Modernization代码转换分析步骤是免费的。

在此步骤中,您将启动另一个构建:

  1. 在左侧导航窗格中,选择构建项目

  2. 选择您在步骤 6.2 中创建的项目来进行构建:2-awsm2ccm-analysis

  3. 选择开始构建,然后选择立即开始以生成分析报告。此时将开始进行构建,状态将变为进行中

  4. 选择阶段详细信息,您将在其中看到项目精心策划的每个步骤的进度。AWS CodeBuild等到所有步骤的状态均变为已成功

  5. 从中AWS 管理控制台,转到 Amazon S3 服务控制台。

  6. 找到并单击 Amazon S3 存储桶:codebuild-regionId-accountId-bucket

    1. ARTIFACTS/ 文件夹包含分析转换步骤的输出。

    2. 选择 ARTIFACTS/prj_codebuild_01/_Reports/

    3. 将提供以下报告:

      • AWSM2CCM-Analysis-Report-<timestamp>.pdf是一份执行报告,提供了AWS Mainframe Modernization代码转换计费和范围,改进了转换、转换摘要和详细的转化统计信息。该报告还汇总了项目级别的代码数量和可计费代码数,并提供了每个组件的指标和引用成员列表。在进行实际转换之前,请务必运行并检查此报告。

      • Conversion_Detailed_Statistics.txt 提供了每个组件中的每条指令的频率和预期转换结果(显示为“转换状态”)。该报告提供了一种方法来快速识别转换器是否支持指令。可能的转换状态结果有:

        • 完全转换:指令将被准确地转换为 COBOL。

        • 部分转换:支持该指令,但使用了不支持的参数或表达式。转换后可能需要手动调整。

        • 未转换:转换器不支持该指令。

        • Pre-compile 验证说明:这些说明通常包含在宏中,指的是大型机上可能也称为条件汇编语言(例如 AIF、AGO)的指令。这些由预编译器处理,预编译器由此类指令或指令驱动,选择并生成 clean/staticASM 代码。这些指令依赖于所编译的宏参数的实际值。因此,同一个宏可以根据所传递的参数值生成不同的 ASM 代码片段。之所以如此,就是因为存在这样的预编译指令。在这种情况下,可以考虑扩展或重新设计宏。

      • Conversion_Global_Statistics.txt 提供组件级别的转换状态摘要。

      • CrossReference_PgmToCpyMacro.txt 报告汇编器程序对宏的依赖。该报告提供了一种方法来快速确定上传的代码中是否缺少任何宏。

      • CrossReference_PgmToPgm.txt 报告汇编器程序对其他汇编器程序的依赖。该报告提供了一种方法来快速确定上传的代码中是否缺少任何汇编器程序。

  7. 返回AWS CodeBuild服务控制台。

  8. 确认 2-awsm2ccm-analysis 步骤的状态。此步骤应该在最新构建状态选项卡下显示为已成功

您已准备好进行下一步操作:代码转换

步骤 9:运行代码转换

重要

AWS Mainframe Modernization代码转换转换步骤将按您的使用量计费。有关定价的更多信息,请参阅 了解汇编器转换的代码转换功能计费

在此步骤中,您将配置转换过程,然后开始构建。

  1. 从中AWS 管理控制台,转到 Amazon S3 服务。

  2. 找到并单击 Amazon S3 存储桶:codebuild-regionId-accountId-bucket

    1. 转到 prj_codebuild_01/

    2. 选择 project_settings.json,然后选择下载

    3. 打开 project_settings.json 文件,您会看到以下 JSON 结构:

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

      其中,

      • Source program directory:包含转换所需的汇编器程序。

      • 源 copybooks/Macros目录:包含转换所需的汇编器宏和抄本。

      • Copybooks/Macros 转换可以是:

        • 全部:此单选按钮表示完全转换将转换目录中所有 copybook/Macros 可用的内容,无论程序是否正在使用该目录。

        • Called_only:此单选按钮表示完全转换只会转换程序实际 copybook/Macros 使用的转换。

      • 重要

        Copy/Macro 如果它已经存在,则无需重新生成。

        如果为 true,则如果该工具已经转换(存在于输出文件夹中),则该工具将不会 copybook/Macro再次进行转换。

      • Target:程序的转换结果(生成的代码)取决于目标 COBOL 编译器。支持以下选项:

        • “IBM”,适用于 IBM 大型机

        • “MF”,适用于 Micro Focus COBOL

        • “VERYANT”,适用于 Veryant isCOBOL

        • “NTT”,适用于 NTT DATA Enterprise COBOL(Unikix)

      • 字节序和位数:程序(生成的代码)的转换取决于目标平台()。bit/endianess此组合支持选择以下受支持的选项:

        • Endianess:(for Big-Endian)/Little(Little-Endian)。例如,IBM z/OS 的大型机是 Big-Endian,Windows 是 Little-Endian,Linux 因发行版而异(例如,EC2 上的 Amazon Linux 2 是 Little-Endian)。

        • Bitness: 32/64 (如果未给出,则默认为 32)。建议设置为 32 位。

      • Converted program extension:这是为了设置所生成的 COBOL 程序的文件扩展名。空(“”):没有扩展名。对于 Rocket Software(前身为 Micro Focus)CO BOL 目标,建议 CBL 让 Rocket Enterprise Develo

      • Converted CICS program extension:这是为了设置所生成的 CICS COBOL 程序的文件扩展名。空(“”):没有扩展名。对于 Rocket Software CO BOL 目标,建议使用 CBL 让 Rocket Enterprise 开发人员能够正确识别文件。

      • 转换后的 copybooks/Macros扩展名:这是为了为生成的 COBOL 字帖设置文件扩展名。空(“”):没有扩展名。对于 Rocket Software COBOL 目标,建议使用 CPY 来让 Rocket Enterprise Developer

      • 跟踪级别:跟踪是转换 CodeBuild 过程中使用的记录信息。用户可以通过选择所提供的任何一个选项来选择详细级别。

        • ERROR = TRACE ERROR:仅显示转换错误。

        • STANDARD = TRACE STANDARD:显示转换错误和标准信息。这是推荐设置。

        • ALL = TRACE ALL:最大跟踪级别

      • Trace file open mode:未使用。建议使用默认设置 append

      • Data definition level:这表示在工作存储和链接部分中定义的子字段的初始级别(在级别“01”之后)。必须是一个数字。

      • Start picture column:这与生成的 COBOL 代码的格式有关,表示放置 PIC 子句的列(在字段名称之后)。必须是一个数字。

      • Original source placement:这表示注释在程序中的放置位置。有两个选项:

        • RIGHT:此选项会将注释或附加信息放在第七十三(73)列之后的右侧位置。在 COBOL 中,代码写在前七十二(1-72)列中,从第七十三列开始(>= 73 列)的任何内容都将被视为注释。

        • ABOVE:此选项会将注释放在已转换内容的上方。

      • Generate Sync FILLER with name:此选项与二进制字段(汇编器“H”、“F”、“D”数据类型,这些数据类型会转换为 COBOL“COMP”数据类型)在内存中的对齐有关。为了保证正确的对齐边界,将在转换过程中添加显式填充字段。这是一个基于文本的选项,其值必须是字符串(比如 FILL-SYNC)。

      • Use SYNC clause:此选项与二进制字段在内存中的对齐有关。Yes = 将所有字段转换为 COBOL。“COMP”将用“SYNC”子句定义(例如,05 WRKFLD PIC S9(09) COMP SYNC)。

      • 小数点逗号:如果这是真的,则 IS CO MMA 子句将被添加到 “SPECIAL-NAMES” COBOL 段落中。DECIMAL-POINT

    4. 根据您的需求更改相应的参数,然后保存 project_settings.json

    5. 从 Amazon S3 存储桶中的 prj_codebuild_01/ 中删除现有的 project_settings.json 文件,然后上传新版本。

  3. 返回AWS CodeBuild服务。

  4. 选择先前创建的项目(3-awsm2ccm-convert)来进行构建

    1. 选择开始构建,然后选择立即开始,将汇编器程序和宏转换为 COBOL 程序和副本。

    2. 等待此项目的构建状态变为已成功。该状态会显示在最新构建状态选项卡下。

步骤 10:验证代码转换

  1. 从中AWS 管理控制台,转到 Amazon S3 服务。

  2. 找到并单击 Amazon S3 存储桶:codebuild-regionId-accountId-bucket

  3. 导航到awsm2ccm-do-not-delete 。AWS Mainframe Modernization在转换过程中,代码转换会为每个汇编器或宏模块创建编码的二进制文件。这些文件对于防止向客户重复计费以及跟踪所提供的汇编器代码被分析和转换了多少至关重要。这些文件存放在以下位置:codebuild-regionId-accountId- bucket/awsm2ccm-do-not-delete/<your_AWS_account_id>/Hash。这些编码的文件不包含任何汇编器代码,也不能从中提取客户代码。

    重要

    请勿手动编辑或删除这些文件。编辑或删除这些文件可能会导致对相同组件进行重复计费。

    请将 awsm2ccm-do-not-delete/ 文件夹视为系统管理的目录。对此目录或其内容进行任何更改支持之前,请先进行咨询。

  4. 单击 codebuild-regionId-accountId-bucket 返回存储桶。

  5. 选择 ARTIFACTS/prj_codebuild_01/_Converted/ 文件夹包含作为代码转换步骤的结果生成的 COBOL 输出。该文件夹将包含以下子目录:

    • copybooks/ 文件夹,包含生成的 COBOL 副本。

    • programs/ 文件夹,包含生成的 COBOL 程序。

    • runtime_lib/ 文件夹,包含解决方案提供的其他 COBOL 程序和副本。

  6. 如果分析报告和其他报告表明转换成功,并且AWS CodeBuild项目标记为成功,请从 _ Conver 3-awsm2ccm-convert ted/ 目录中下载 COBOL 代码和抄本。

步骤 11:下载转换后的代码

在此步骤中,从 _Converted/ 目录中下载 COBOL 代码和副本,然后在目标 COBOL 环境中对其进行编译。

  1. 从中AWS 管理控制台,转到 Amazon S3 服务。

  2. 找到并单击 Amazon S3 存储桶:codebuild-regionId-accountId-bucket

  3. 导航到以下位置: ARTIFACTS/prj_codebuild_01/_Converted/

  4. _Converted/ 下的所有子目录中下载转换后的 COBOL 代码。您也可以使用以下 CLI 命令一次性下载它们:

    aws s3 cp s3://codebuild-regionId-accountId- bucket/ARTIFACTS/prj_codebuild_01/_Converted/ . --recursive
  5. 在目标 COBOL 环境中分析和编译转换后的 COBOL。

清理资源

如果您不再需要为本教程创建的资源,请将其删除,以免产生额外费用。为此,请完成以下步骤:

  • 删除您为本教程创建的 S3 存储桶。有关更多信息,请参阅《Amazon Simple Storage Service 用户指南》中的删除存储桶

  • 删除您为本教程创建的 IAM 策略。有关更多信息,请参阅《IAM 用户指南》中的删除 IAM 策略

  • 删除您为本教程创建的 IAM 角色。有关更多信息,请参阅《IAM 用户指南》中的删除角色或实例配置文件

  • 删除您为本教程创建的 CodeBuild 项目。有关更多信息,请参阅《AWS CodeBuild用户指南》 CodeBuild中的删除构建项目