Transformieren Sie Easytrieve in moderne Sprachen, indem Sie AWS Transform benutzerdefiniert

Stellen Sie die Infrastruktur AWS Transform kundenspezifisch bereit.

Stellen Sie die produktionsbereite Infrastruktur bereit, die für die Bereitstellung einer sicheren Transformationsumgebung erforderlich ist. Dazu gehört eine private Amazon EC2 EC2-Instance, die mit den erforderlichen Tools, IAM-Berechtigungen und Netzwerkeinstellungen für die Konvertierung von Easytrieve-Code konfiguriert ist. Um die Umgebung mithilfe von Infrastructure as Code (IaC) bereitzustellen, folgen Sie den Bereitstellungsanweisungen im Repository Easytrieve to Modern Languages Transformation with Custom. AWS Transform GitHub

Bereiten Sie die Eingangsmaterialien für die Transformation vor.

Erstellen Sie eine BRE-Transformationsdefinition

Gehen Sie wie folgt vor, um die benutzerdefinierte Transformationsdefinition für BRE (Business Rule Extraction) aus dem Easytrieve-Quellcode zu erstellen.

1. Gehen Sie zum Code-Repository für dieses Muster und kopieren Sie bre_transformation_definition.md aus dem Dokumentenordner zusammen mit dem Ordner document_references mit dem EZT-Codierungshandbuch.

2. Laden Sie diesen Inhalt in der AWS Transform CLI hoch, laden Sie ihn an einen Ort Ihrer Wahl hoch und notieren Sie sich den Pfad, der in den nächsten Schritten verwendet werden soll.

3. Rufen Sie AWS Transform über die CLI mit dem Befehl atx auf.

4. Geben Sie diese Aufforderung in der CLI ein:

Erstellen Sie eine benutzerdefinierte Transformation mithilfe meiner Transformationsdefinitionsdatei, die unter Pfad verfügbar ist <path to content from step #2 >

AWS Transform erstellt eine neue benutzerdefinierte Transformationsdefinition für die BRE-Generierung.

5. Überprüfen Sie die Transformationsdefinition und nehmen Sie bei Bedarf Änderungen vor.

Veröffentlichen Sie die BRE-Transformationsdefinition

Nach der Überprüfung und Validierung der BRE-Transformationsdefinition können Sie sie mit einer Aufforderung in natürlicher Sprache in der AWS Transform benutzerdefinierten Registrierung veröffentlichen und dabei einen Definitionsnamen wie angeben Easytrieve-Business-Rule-Extract.

Erstellen Sie eine Transformationsdefinition.

Gehen Sie wie folgt vor, um die benutzerdefinierte Transformationsdefinition für die Transformation von EZT in Java mit funktionaler Validierung zu erstellen.

Veröffentlichen Sie die Transformationsdefinition.

Nach der Überprüfung und Validierung der Transformationsdefinition können Sie sie mit einer Aufforderung in natürlicher Sprache in der AWS Transform benutzerdefinierten Registrierung veröffentlichen und dabei einen Definitionsnamen wie angeben Easytrieve-to-Java-Migration.

Führen Sie den BRE-Generierungsjob aus.

Führen Sie den AWS Transform CLI-Befehl aus und wählen Sie die Option „Nicht interaktiv“ oder „Interaktiv“:

Non-interactive Ausführung (völlig autonom):

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

Interaktive Ausführung (unter menschlicher Aufsicht):

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

Unterbrochene Ausführung fortsetzen:

atx --resume

ODER

atx --conversation-id <conversation-id>  

Verschieben Sie das generierte BRE-Dokument in den Ordner bre-doc/, um es während des Transformationsschritts als Eingabe zu verwenden. Easytrieve-to-Java

Lesen Sie die Zusammenfassung der Transformationsvalidierung.

Stellen Sie vor der Ausführung der AWS Transform benutzerdefinierten Transformation sicher, dass der input-data Ordner die erforderlichen Datendateien enthält, die vor der Ausführung des Mainframe-Batchjobs erfasst wurden. Stellen Sie nach der Ausführung des Mainframe-Batchjobs sicher, dass der output-data Ordner die resultierenden Dateien aufzeichnet. Alle Dateien haben ein Sequential/Text/DB2 Format, das die EBCDIC-Kodierung verwendet, die den Ausführungsanforderungen entspricht.

Führen Sie den benutzerdefinierten Transformationsjob aus.

Führen Sie den AWS Transform CLI-Befehl aus und wählen Sie die Option „Nicht interaktiv“ oder „Interaktiv“:

:# 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 validiert automatisch anhand von build/test Befehlen während der Ausführung der Transformation.

Lesen Sie die Zusammenfassung der Transformationsvalidierung.

Greifen Sie auf Validierungsberichte zu.

Geben Sie die folgenden Befehle ein, um die detaillierten Validierungsartefakte zu überprüfen:

# 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

Aktivieren Sie Wissenselemente für kontinuierliches Lernen.

Verbessern Sie die Genauigkeit future Transformationen, indem Sie vorgeschlagene Wissenselemente in Ihre persistente Konfiguration aufnehmen. Nach einer Transformation speichert der Agent identifizierte Muster und Zuordnungsregeln in Ihrem lokalen Sitzungsverzeichnis. Führen Sie die folgenden Befehle auf Ihrer Amazon EC2 EC2-Instance aus, um diese erlernten Elemente zu überprüfen und anzuwenden:

# 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