

AWS Mainframe Modernization Service （受管執行期環境體驗） 不再向新客戶開放。對於與 AWS Mainframe Modernization Service （受管執行期環境體驗） 類似的功能，探索 AWS Mainframe Modernization Service （自我管理體驗）。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱[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 專案中執行，並提供命令來設定專案目錄和組態檔案、評估 Assembler 程式碼、展開 Assembler 巨集，以及將 Assembler 程式碼轉換為 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 步驟高階結果的日誌檔案會寫入 CodeBuild 中設定的日誌儲存貯體中的日誌檔案。這些檔案會以 gzip 封存形式顯示，其中包含 CodeBuild 架構產生的 GUID 類型檔案名稱 （例如 `0c03e183-ab40-4fe0-ba77- bc1d87e73b14.gz`)。每個封存都包含執行 CodeBuild 專案所產生的日誌。如果 CodeBuild 專案執行失敗，此日誌檔案將包含重要的故障診斷資訊。
+ 在元件層級具有詳細執行結果的日誌檔案會寫入具有檔案名稱模式 `<Project_Bucket_name>_.log`（例如 `project- bucket_202406131200.log`) 的主要專案儲存貯體路徑中的日誌檔案。這些日誌提供：
  + 記錄輸入和輸出位置的組態摘要。
  + 使用目標檔案名稱處理的每個 Assembler 或 Macro 元件的日誌。
  + 使用檔案位置產生的報告清單。
  + 對於轉換執行，提供執行時間複製手冊的清單。

## 程序概觀
<a name="assembler-conversion-process"></a>

下圖說明將 Assembler 轉換為 COBOL 的程序：

![從 Assembler 到 COBOL 的程式碼轉換如何運作。](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/conversion-process-overview.png)
