AWS Transform カスタムを使用して Easytrieve を最新の言語に変換する

AWS Transform カスタム用にインフラストラクチャをプロビジョニングします。

安全な変換環境をホストするために必要な本番環境対応のインフラストラクチャをデプロイします。これには、Easytrieve コードを変換するために必要なツール、IAM アクセス許可、ネットワーク設定で設定されたプライベート Amazon EC2 インスタンスが含まれます。Infrastructure as Code (IaC) を使用して環境をプロビジョニングするには、Easytrieve to Modern Languages Transformation with AWS Transform Custom GitHub リポジトリのデプロイ手順に従ってください。

変換用の入力マテリアルを準備します。

BRE 変換定義を作成する

Easytrieve ソースコードから BRE (ビジネスルール抽出) のカスタム変換定義を作成するには、次の手順に従います。

1. このパターンのコードリポジトリに移動し、ドキュメントフォルダから bre_transformation_definition.md を document_references フォルダとともに EZT コーディングガイドとともにコピーします。

2. CLI AWS Transform でそのコンテンツを任意の場所にアップロードし、次のステップで使用するパスの場所を書き留めます。

3. atx コマンドを使用して CLI AWS Transform から を呼び出します。

4. CLI でこのプロンプトを指定します。

ステップ 2> のコンテンツへのパス <path to content で利用可能な変換定義ファイルを使用してカスタム変換を作成する

AWS Transform は、BRE 生成用の新しいカスタム変換定義を作成します。

5. 変換定義を確認し、必要に応じて変更を加えます。

BRE 変換定義の発行

BRE 変換定義を確認して検証したら、自然言語プロンプトを使用して AWS Transform カスタムレジストリに発行し、Easytrieve-Business-Rule-Extract などの定義名を指定できます。

変換定義を作成します。

以下の手順に従って、機能検証による EZT から Java への変換のカスタム変換定義を作成します。

変換定義を発行します。

変換定義を確認して検証したら、自然言語プロンプトを使用してカスタムレジストリに AWS Transform 発行し、Easytrieve-to-Java-Migration などの定義名を指定できます。

BRE 生成ジョブを実行します。

AWS Transform CLI コマンドを実行し、非インタラクティブまたはインタラクティブオプションを選択します。

非インタラクティブ実行 (完全自律):

atx custom def exec --transformation-name "Easytrieve-Business-Rule-Extract" --code-repository-path ~/root/transform-workspace/mainframe-source/source-code --non-interactive --trust-all-tools

インタラクティブ実行 (人的監視あり):

atx custom def exec -n "Easytrieve-Business-Rule-Extract" -p ~/root/transform-workspace/mainframe-source/source-code

中断された実行を再開する:

atx --resume

OR

atx --conversation-id <conversation-id>  

生成された BRE ドキュメントを、Easytrieve-to-Java-to-Java 変換ステップで入力として使用する bre-doc/ フォルダに移動します。

変換検証の概要を確認します。

カスタム変換を実行する AWS Transform 前に、メインフレームバッチジョブの実行前にキャプチャされた必要なデータファイルがフォルダに含まれていることを確認します input-data 。メインフレームバッチジョブの実行後、 output-dataフォルダが結果のファイルをキャプチャしていることを確認します。すべてのファイルは、実行要件に基づいて EBCDIC エンコードを使用してSequential/Text/DB2 形式になります。

カスタム変換ジョブを実行します。

AWS Transform CLI コマンドを実行し、非インタラクティブまたはインタラクティブオプションを選択します。

:# Non-interactive execution (fully autonomous):
atx custom def exec \
  --transformation-name "Easytrieve-to-Java-Migration" \
  --code-repository-path ~/root/transform-workspace/mainframe-source/source-code \
  --build-command "mvn clean install" \
  --non-interactive \
  --trust-all-tools \

# Interactive execution (with human oversight):
atx custom def exec \
  -n "Easytrieve-to-Java-Migration" \
  -p ~/root/transform-workspace/mainframe-source/source-code \
  -c "mvn clean install"

# Resume interrupted execution:
atx -resume
# OR
atx --conversation-id <conversation-id>

AWS Transform は、変換の実行中にビルド/テストコマンドを使用して を自動的に検証します。

変換検証の概要を確認します。

検証レポートにアクセスします。

以下のコマンドを入力して、詳細な検証アーティファクトを確認します。

# Full validation report
cat ~/.aws/atx/custom/$LATEST_SESSION/artifacts/validation_report.html

# Generated code location
ls ~/.aws/atx/custom/$LATEST_SESSION/generated/

# Execution logs
cat ~/.aws/atx/custom/$LATEST_SESSION/logs/execution.log

継続的な学習のためにナレッジ項目を有効にします。

提案されたナレッジ項目を永続的な設定に昇格させることで、将来の変換精度を向上させます。変換後、エージェントは識別されたパターンとマッピングルールをローカルセッションディレクトリに保存します。これらの学習した項目を確認して適用するには、Amazon EC2 インスタンスで次のコマンドを実行します。

# List all knowledge items for a specific transformation definition
atx custom def list-ki -n <transformation-name>

# Retrieve the details of a specific knowledge item
atx custom def get-ki -n <transformation-name> --id <id>

# Update the status of a knowledge item (ENABLED or DISABLED)
atx custom def update-ki-status -n <transformation-name> --id <id> --status ENABLED

# Update the knowledge item configuration to enable auto-approval
atx custom def update-ki-config -n <transformation-name> --auto-enabled TRUE