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. | Développeur d’applications |
| 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. | Développeur d’applications |
| 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.[See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/transform-easytrieve-modern-languages.html) | Développeur d’applications |
| 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*. | Développeur d’applications |
### Génération d'un extrait de règles métier (BRE)
| Sous-tâche | Description | Compétences requises |
| --- | --- | --- |
| 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
OUatx --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. | Développeur d’applications |
### Préparez les données de référence pour la validation.
| Sous-tâche | Description | Compétences requises |
| --- | --- | --- |
| 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.[See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/transform-easytrieve-modern-languages.html) | Développeur d’applications |
| 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
AWS Transform valide automatiquement par le biais de build/test commandes lors de l'exécution de la transformation. | Développeur d’applications |
### Validez et distribuez le code testé
| Sous-tâche | Description | Compétences requises |
| --- | --- | --- |
| Consultez le résumé de validation de la transformation. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/transform-easytrieve-modern-languages.html) | Développeur d’applications |
| 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
| Développeur d’applications |
| 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
# Retrieve the details of a specific knowledge item
atx custom def get-ki -n --id
# Update the status of a knowledge item (ENABLED or DISABLED)
atx custom def update-ki-status -n --id --status ENABLED
# Update the knowledge item configuration to enable auto-approval
atx custom def update-ki-config -n --auto-enabled TRUE
| Développeur d’applications |
## Résolution des problèmes
| Problème | Solution |
| --- | --- |
| *Configuration des chemins d'entrée et de sortie*
Les fichiers d'entrée ne sont pas lus ou les fichiers de sortie ne sont pas écrits correctement. | Spécifiez le chemin complet du répertoire dans lequel les fichiers d'entrée sont stockés et indiquez clairement l'emplacement où la sortie doit être écrite. Assurez-vous que les autorisations d'accès appropriées sont configurées pour ces répertoires.
Les meilleures pratiques incluent l'utilisation de chemins absolus plutôt que de chemins relatifs pour éviter toute ambiguïté et la vérification que tous les chemins spécifiés existent avec les read/write autorisations appropriées. |
| *Reprise des exécutions interrompues*
L'exécution a été interrompue ou doit être poursuivie là où elle s'est arrêtée | Vous pouvez reprendre l'exécution là où vous l'avez interrompue en fournissant l'ID de conversation dans la commande CLI.
Trouvez l'identifiant de conversation dans les journaux de votre précédente tentative d'exécution. |
| *Résolution des contraintes de mémoire*
Une erreur de mémoire insuffisante se produit lors de l'exécution. | Vous pouvez demander AWS Transform de partager la taille actuelle de la JVM en mémoire, puis d'augmenter l'allocation de mémoire en fonction de ces informations. Cet ajustement permet de répondre à des exigences de traitement plus importantes.
Envisagez de diviser les tâches volumineuses en lots plus petits si les contraintes de mémoire persistent après les ajustements. |
| *Corriger les divergences entre les fichiers de sortie*
Les fichiers de sortie ne correspondent pas aux attentes et AWS Transform indiquent qu'aucune autre modification n'est possible. | Fournissez des commentaires spécifiques et des raisons techniques expliquant pourquoi la sortie actuelle est incorrecte. Incluez de la documentation technique ou commerciale supplémentaire pour répondre à vos besoins. Ce contexte détaillé permet de AWS Transform corriger le code afin de générer les fichiers de sortie appropriés. [See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/transform-easytrieve-modern-languages.html) |
## Ressources connexes
+ [AWS Transform documentation personnalisée](https://docs.aws.amazon.com/transform/latest/userguide/custom.html)
+ [Générateur de rapports Easytrieve 11.6](https://techdocs.broadcom.com/us/en/ca-mainframe-software/devops/ca-easytrieve-report-generator/11-6/getting-started.html)