Transformez Easytrieve en langues modernes en utilisant AWS Transform personnalisé

Fournissez l'infrastructure AWS Transform sur mesure.

Déployez l'infrastructure prête pour la production requise pour héberger un environnement de transformation sécurisé. Cela inclut une instance Amazon EC2 privée configurée avec les outils nécessaires, les autorisations IAM et les paramètres réseau pour convertir le code Easytrieve. Pour configurer l'environnement à l'aide de l'infrastructure en tant que code (IaC), suivez les instructions de déploiement du référentiel Easytrieve to Modern Languages Transformation with AWS Transform Custom GitHub .

Préparez les matières premières pour la transformation.

Créer une définition de transformation BRE

Suivez ces étapes pour créer la définition de transformation personnalisée pour BRE (Business Rule Extraction) à partir du code source d'Easytrieve.

1. Accédez au dépôt de code correspondant à ce modèle et copiez bre_transformation_definition.md du dossier documents ainsi que du dossier document_references contenant le guide de codage EZT.

2. Téléchargez ce contenu dans le téléchargement de la AWS Transform CLI vers un emplacement de votre choix et notez l'emplacement du chemin à utiliser dans les étapes suivantes.

3. Appelez AWS Transform depuis la CLI avec la commande atx.

4. Fournissez cette invite dans la CLI :

Créez une transformation personnalisée à l'aide de mon fichier de définition de transformation disponible sur path <path to content from step #2 >

AWS Transform crée une nouvelle définition de transformation personnalisée pour la génération BRE.

5. Passez en revue la définition de la transformation et apportez des modifications si nécessaire.

Publier la définition de la transformation BRE

Après avoir examiné et validé la définition de transformation BRE, vous pouvez la publier dans le registre AWS Transform personnalisé avec une invite en langage naturel, en fournissant un nom de définition tel que Easytrieve-Business-Rule-Extract.

Créez une définition de transformation.

Suivez ces étapes pour créer la définition de transformation personnalisée pour la transformation EZT vers Java avec validation fonctionnelle.

Publiez la définition de la transformation.

Après avoir examiné et validé la définition de transformation, vous pouvez la publier dans le registre AWS Transform personnalisé à l'aide d'une invite en langage naturel, en fournissant un nom de définition tel que Easytrieve-to-Java-Migration.

Exécutez la tâche de génération BRE.

Exécutez la commande AWS Transform CLI en choisissant l'option non interactive ou interactive :

Non-interactive exécution (totalement autonome) :

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

Exécution interactive (avec supervision humaine) :

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

Reprendre l'exécution interrompue :

atx --resume

OU

atx --conversation-id <conversation-id>  

Déplacez le document BRE généré vers le dossier bre-doc/ à utiliser comme entrée lors de l' Easytrieve-to-Java étape de transformation.

Consultez le résumé de validation de la transformation.

Avant d'exécuter la transformation AWS Transform personnalisée, vérifiez que le input-data dossier contient les fichiers de données requis capturés avant l'exécution du traitement par lots du mainframe. Après l'exécution de la tâche par lots sur le mainframe, assurez-vous que le output-data dossier capture les fichiers obtenus. Tous les fichiers sont au Sequential/Text/DB2 format utilisant le codage EBCDIC en fonction des exigences d'exécution.

Exécutez le travail de transformation personnalisé.

Exécutez la commande AWS Transform CLI en choisissant l'option non interactive ou interactive :

:# 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 valide automatiquement par le biais de build/test commandes lors de l'exécution de la transformation.

Consultez le résumé de validation de la transformation.

Accédez aux rapports de validation.

Entrez les commandes suivantes pour passer en revue les artefacts de validation détaillés :

# 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

Activez les éléments de connaissances pour un apprentissage continu.

Améliorez la précision des transformations futures en intégrant les éléments de connaissances suggérés à votre configuration permanente. Après une transformation, l'agent stocke les modèles identifiés et les règles de mappage dans votre répertoire de session local. Pour consulter et appliquer ces éléments appris, exécutez les commandes suivantes sur votre instance 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