

AWS 大型机现代化服务（托管运行时环境体验）不再向新客户开放。有关类似于 AWS 大型机现代化服务（托管运行时环境体验）的功能，请浏览 AWS 大型机现代化服务（自我管理体验）。现有客户可以继续正常使用该服务。有关更多信息，请参阅[AWS 大型机现代化可用性变更](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)。

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

# 了解代码转换功能的组件和过程
<a name="assembler-conversion-components-process"></a>

AWS Mainframe Modernization 代码转换过程包括各种组件，例如 AWS Mainframe Modernization 容器、S3 项目存储桶和日志文件位置。

**Topics**
+ [AWS Mainframe Modernization 容器](#assembler-conversion-components-container)
+ [S3 项目存储桶](#assembler-conversion-components-s3)
+ [日志文件位置](#assembler-conversion-components-log)
+ [过程概述](#assembler-conversion-process)

## AWS Mainframe Modernization 容器
<a name="assembler-conversion-components-container"></a>

AWS Mainframe Modernization 代码转换容器在 AWS CodeBuild 项目中运行，并提供用于设置项目目录和配置文件、评估汇编器代码、展开汇编器宏以及将汇编器代码转换为 COBOL 的命令。

您将有权访问以下 AWS ECR 存储库：`381492161314.dkr.ecr.us-east-1.amazonaws.com/aws-mlogica-codebuild-prod`。

您可以通过以下两种方式之一来使用这些映像：
+ 通过使用图像时，请使用最新的标签 AWS CodeBuild。使用映像时，您将使用以下路径：`381492161314.dkr.ecr.us-east-1.amazonaws.com/aws-mlogica-codebuild-prod`。这意味着 AWS CodeBuild 它将把最后一次推送到存储库中的任何一个镜像。
+ 列出版本并从中进行选择。为此，请在 CLI 中使用以下命令列出存储库中的不同版本：

  ```
  aws ecr describe-images \
    --registry-id 381492161314 \
    --repository-name aws-mlogica-codebuild-prod \
    --query 'imageDetails[*].{ImagePushedAt: imagePushedAt, ImageTags: imageTags}' \
    --output json | jq '[.[] | {ImageURI: (.ImageTags[] | "381492161314.dkr.ecr.us-east-1.amazonaws.com/aws-mlogica-codebuild-prod:" + .), ImagePushedAt: .ImagePushedAt}] | sort_by(.ImagePushedAt) | reverse'
  ```

  这会列出所有映像（每个映像都带有关联的标签），以及特定映像发布到存储库的时间。根据上面的代码，您将获得一个映像列表，映像上的标签代表代码转换实用程序的版本。您可以根据自己的需求选择合适的映像。

## S3 项目存储桶
<a name="assembler-conversion-components-s3"></a>

输入和输出代码、使用扩展宏更新的代码以及由 AWS Mainframe Modernization 代码转换生成的报告存储在您在中创建的项目存储桶中。 AWS Account Management通过向 AWS 服务角色授予权限，您可以为 AWS Mainframe Modernization 代码转换提供对存储桶的访问权限。

## 日志文件位置
<a name="assembler-conversion-components-log"></a>

在每次执行 CodeBuild 项目期间，日志文件都写在两个位置：
+ 包含每个 CodeBuild 步骤高级结果的日志文件将写入中配置的 Logging 存储桶中的日志文件中 CodeBuild。这些文件以 gzip 存档的形式出现，其文件名由 CodeBuild 框架生成 GUID 类型（例如）。`0c03e183-ab40-4fe0-ba77- bc1d87e73b14.gz`每个档案都包含执行 CodeBuild 项目时生成的日志。如果 CodeBuild项目执行失败，则此日志文件将包含重要的故障排除信息。
+ 包含组件级详细执行结果的日志文件将写入到项目的主存储桶路径中，并采用文件名模式 `<Project_Bucket_name>_.log`（例如 `project- bucket_202406131200.log`）。这些日志会提供：
  + 记录输入和输出位置的配置摘要。
  + 根据目标文件名处理的每个汇编器或宏组件的日志。
  + 根据文件位置生成的报告列表。
  + 对于转换执行，会提供运行时副本列表。

## 过程概述
<a name="assembler-conversion-process"></a>

下图说明了将汇编器转换为 COBOL 的过程：

![从汇编器到 COBOL 的代码转换是如何工作的。](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/conversion-process-overview.png)
