

AWS Mainframe Modernization Service (マネージドランタイム環境エクスペリエンス) は、新規のお客様に公開されなくなりました。 AWS Mainframe Modernization Service (マネージドランタイム環境エクスペリエンス) と同様の機能については、 AWS Mainframe Modernization Service (セルフマネージドエクスペリエンス) をご覧ください。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、[AWS 「 Mainframe Modernization の可用性の変更](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'
  ```

  これにより、各イメージに関連付けられたタグを持つすべてのイメージと、特定のイメージがリポジトリにリリースされた時刻が一覧表示されます。上記のコードに基づいて、イメージ上のタグがコード変換ユーティリティのバージョンを表すイメージの一覧を取得します。要件に基づいて、適切な .NET ベースイメージを選択します。

## 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 プロジェクトの実行ごとに 2 つの場所に書き込まれます。
+ 各 CodeBuild ステップのハイレベルな結果を持つログファイルは、CodeBuild で設定されたログバケットのログファイルに書き込まれます。これらのファイルは、CodeBuild フレームワーク (例: `0c03e183-ab40-4fe0-ba77- bc1d87e73b14.gz`) によって生成された GUID タイプのファイル名を持つ gzip アーカイブとして表示されます。各アーカイブには、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/ja_jp/m2/latest/userguide/images/conversion-process-overview.png)
