Tutoriel : Convertir le code d'Assembler en COBOL dans AWS Mainframe Modernization

1. Ouvrez la AWS Mainframe Modernization console à l'adresse https://console.aws.amazon.com/m2/.

2. Dans la barre de navigation de gauche, sélectionnez Outils.

3. Dans Conversion de code de modernisation du mainframe AWS avec mLogica, choisissez Share assets with my. Compte AWS

1. Pour créer le compartiment de projet, connectez-vous à la console Amazon S3 et choisissez Créer un compartiment.

2. Dans Configuration générale, donnez un nom au compartiment et indiquez l' Région AWS endroit où vous souhaitez le créer. Voici un exemple de nomcodebuild-regionId-accountId-bucket, où :

   • regionIdest celui Région AWS du seau.

   • accountIdest votre Compte AWS identifiant.

   Note

   Si vous créez le bucket dans une région différente Région AWS de l'est des États-Unis (Virginie du Nord), spécifiez le LocationConstraint paramètre. Pour plus d'informations, consultez la section Créer un bucket dans le manuel Amazon Simple Storage Service API Reference.

3. Conservez tous les autres paramètres et choisissez Créer un compartiment.

Pour créer une politique

1. Connectez-vous à la console IAM et choisissez Politiques dans le volet de navigation de gauche.

2. Choisissez Create Policy (Créer une politique).

3. Copiez et collez la politique JSON suivante dans l'éditeur de règles.

   JSON

   { 
       "Version":"2012-10-17", 
       "Statement": [ 
           { 
               "Action": [
                   "s3:PutObject", 
                   "s3:GetObject", 
                   "s3:GetBucketLocation", 
                   "s3:ListBucket", 
                   "s3:PutObjectAcl", 
                   "s3:GetBucketAcl" 
               ], 
               "Resource": [ 
                   "arn:aws:s3:::codebuild-regionId-accountId-bucket", 
                   "arn:aws:s3:::codebuild-regionId-accountId-bucket/*", 
                   "arn:aws:s3:::aws-m2-repo-*" ], 
                       "Effect": "Allow" 
             }, 
             {
                 "Action": [ 
                   "ecr:GetAuthorizationToken", 
                   "ecr:BatchCheckLayerAvailability", 
                   "ecr:BatchGetImage", 
                   "ecr:GetDownloadUrlForLayer", 
                   "logs:*", 
                   "ec2:DescribeSecurityGroups", 
                   "ec2:DescribeSubnets", 
                   "ec2:DescribeNetworkInterfaces", 
                   "ec2:DeleteNetworkInterface", 
                   "ec2:CreateNetworkInterface", 
                   "ec2:DescribeDhcpOptions", 
                   "ec2:DescribeVpcs", 
                   "ec2:CreateNetworkInterfacePermission" 
               ], 
               "Resource": "*", 
               "Effect": "Allow" 
            } 
       ] 
   }
   

4. Vous pouvez éventuellement ajouter des balises à la politique. Les balises sont des paires clé-valeur qui peuvent vous aider à organiser, suivre ou contrôler l'accès à la politique.

5. Sélectionnez Next:Review.

6. Donnez un nom à la politique, par exempleCodeBuildAWSM2CCMPolicy.

7. Vous pouvez éventuellement saisir une description de la politique et consulter le résumé de la politique pour vous assurer qu'il est correct.

8. Choisissez Create Policy (Créer une politique).

1. Connectez-vous à la console IAM et choisissez Roles dans le volet de navigation de gauche.

2. Choisissez Créer un rôle.

3. Sous Type d'entité de confiance, choisissez le service AWS.

4. Sous Cas d'utilisation pour d'autres services AWS CodeBuild, choisissez, puis choisissez CodeBuild à nouveau.

5. Choisissez Suivant.

6. Sur la page Add permissions (Ajouter des autorisations), sélectionnez Next (Suivant). Vous attribuez une politique au rôle ultérieurement.

7. Dans Détails du rôle, donnez un nom au rôle, par exempleIAMRoleTaskExecutionRoleForCodeBuild.

8. Sous Sélectionner les entités fiables, vérifiez que le document de politique ressemble à ce qui suit :

   JSON

   {
             "Version":"2012-10-17",
             "Statement": [
               {
                 "Effect": "Allow",
                 "Principal": {
                   "Service": "codebuild.amazonaws.com"
                 },
                 "Action": "sts:AssumeRole"
               }
             ]
   }
   

9. Choisissez Créer un rôle.

1. Connectez-vous à la console IAM et choisissez Roles dans le volet de navigation de gauche.

2. Dans Rôles, choisissez le rôle que vous avez créé précédemment, par exempleIAMRoleTaskExecutionRoleForCodeBuild.

3. Dans Politiques d'autorisations, choisissez Ajouter des autorisations, puis Joindre des politiques.

4. Dans Autres politiques d'autorisations, choisissez les politiques que vous avez créées précédemment, par exempleCodeBuildAWSM2CCMPolicy.

5. Choisissez Attacher des politiques.

Pour créer le projet Define

1. Connectez-vous à la CodeBuild console et choisissez Create build project.

2. Dans la section Configuration du projet, donnez un nom au projet, par exemple1-awsm2ccm-define-project.

3. Dans la section Source, pour Fournisseur source, conservez la sélection par défaut.

4. Dans la section Environnement, choisissez Image personnalisée.

5. Dans le champ Type d'environnement, choisissez Linux.

6. Sous Registre d'images, choisissez Autre registre.

7. Dans le champ URL du registre externe, suivez la AWS Mainframe Modernization conteneur section.

8. Sous Rôle de service, choisissez Rôle de service existant, puis dans le champ ARN du rôle, choisissez le rôle de service que vous avez créé précédemment (par exemple,IAMRoleTaskExecutionRoleForCodeBuild).

9. Développez la section Configuration supplémentaire, procédez comme suit :

   1. VPC : configurez si nécessaire en fonction de votre configuration.

   2. Délai d'attente : réglé sur 60 minutes.

   3. Délai d'attente : réglé sur 480 minutes.

   4. Chiffrement : choisissez les paramètres de cryptage appropriés (la valeur par défaut convient).

   5. Dans la section Variables d'environnement, ajoutez les éléments suivants un par un :

      • Nom : PROJECT_BUCKET. Valeur :codebuild-regionId-accountId- bucket. Type : texte en clair

      • Nom : PROJECT_DIR. Valeur :prj_codebuild_01. Type : texte en clair

      • Nom : AWSM2CCM_ACTION. Valeur :define_project. Type : texte en clair

      • Nom : AWSM2CCM_LOGGING_BUCKET. Valeur :s3:// codebuild-regionId-accountId-bucket. Type : texte en clair

10. Dans la section Buildspec, choisissez Insérer des commandes de génération, puis Passez à l'éditeur.

11. Remplacez les valeurs actuelles par les valeurs suivantes :

    version: 0.2 
    phases: 
        build: 
            commands: 
                - . /app/awsm2ccm_prod/bin/setup_env.sh 
                - run_awsm2ccm.sh $PROJECT_DIR 
    artifacts: 
        files: 
            - '**/*' 
        discard-paths: no 
        base-directory: $PROJECT_DIR

    où PROJECT_DIR sont des variables d'environnement disponibles dans. CodeBuild Pour plus d'informations, consultez la section Variables d'environnement dans les environnements de génération.

12. Dans la section Artefacts, procédez comme suit :

    • sous Type, choisissez Amazon S3, puis choisissez votre compartiment de sortie, par exemplecodebuild-regionId-accountId-bucket.

    • pour Path, laissez ce champ vide.

    • pour Nom, entrezprj_codebuild_01.

    • pour l'emballage des artefacts, sélectionnez Aucun.

    • pour Remplacer le nom de l'artefact, décochez cette option.

    • pour le chiffrement, laissez-le dans les paramètres par défaut.

13. Pour la section Journaux, procédez comme suit :

    • CloudWatch journaux : Désactivé

    • Journaux S3 : Activé

    • Compartiment: codebuild-regionId-account-bucket

    • Chemin du journal : CODEBUILD-LOGS

14. Choisissez Créer un projet de génération.

Pour créer le projet d'analyse de code

1. Connectez-vous à la CodeBuild console et choisissez Create build project.

2. Dans la section Configuration du projet, donnez un nom au projet, par exemple2-awsm2ccm-analysis.

3. Dans la section Source, pour Fournisseur source, choisissez Amazon S3, puis choisissez le compartiment d'entrée que vous avez créé précédemment (par exemple,codebuild-regionId-accountId-bucket).

4. Dans le champ Clé d'objet S3 ou dossier S3, entrezprj_codebuild_01.

5. Dans la section Environnement, choisissez Image personnalisée.

6. Dans le champ Type d'environnement, choisissez Linux.

7. Sous Registre d'images, choisissez Autre registre.

8. Dans le champ URL du registre externe, suivez la AWS Mainframe Modernization conteneur section.

9. Sous Rôle de service, choisissez Rôle de service existant, puis dans le champ ARN du rôle, choisissez le rôle de service que vous avez créé précédemment (par exemple,IAMRoleTaskExecutionRoleForCodeBuild).

10. Développez la section Configuration supplémentaire, procédez comme suit :

    1. VPC : configurez si nécessaire en fonction de votre configuration.

    2. Délai d'attente : réglé sur 60 minutes.

    3. Délai d'attente : réglé sur 480 minutes.

    4. Chiffrement : choisissez les paramètres de cryptage appropriés (la valeur par défaut convient).

    5. Dans la section Variables d'environnement, ajoutez les éléments suivants un par un :

       • Nom : PROJECT_BUCKET. Valeur :codebuild-regionId-accountId-bucket. Type : texte en clair

       • Nom : PROJECT_DIR. Valeur :prj_codebuild_01. Type : texte en clair

       • Nom : AWSM2CCM_ACTION. Valeur :analysis. Type : texte en clair

       • Nom : AWSM2CCM_LOGGING_BUCKET. Valeur :s3:// codebuild-regionId-accountId-bucket. Type : texte en clair

11. Dans la section Buildspec, choisissez Insérer des commandes de génération, puis Passez à l'éditeur.

12. Remplacez les valeurs actuelles par les valeurs suivantes :

    version: 0.2 
    phases: 
        build: 
            commands: 
                - ln -s $CODEBUILD_SRC_DIR $PROJECT_DIR 
                - . /app/awsm2ccm_prod/bin/setup_env.sh 
                - run_awsm2ccm.sh $PROJECT_DIR
    artifacts: 
        files: 
            - '*.log' 
            - '_Converted/*/*' 
            - '_Reports/*' 
        secondary-artifacts: 
            reports: 
                files: 
                    - '_Reports/AWSM2CCM*' 
        discard-paths: no 
        base-directory: $PROJECT_DIR

    où PROJECT_DIR sont des variables d'environnement disponibles dans. CodeBuild Pour plus d'informations, consultez la section Variables d'environnement dans les environnements de génération.

13. Dans la section Artefacts, procédez comme suit :

    • sous Type, choisissez Amazon S3, puis choisissez votre compartiment de sortie (par exemple,codebuild-regionId-accountId-bucket).

    • pour Path, saisissez ARTIFACTS.

    • pour Nom, entrezprj_codebuild_01.

    • pour l'emballage des artefacts, sélectionnez Aucun.

    • pour Remplacer le nom de l'artefact, décochez cette option.

    • pour le chiffrement, laissez-le dans les paramètres par défaut.

14. Pour la section Journaux, procédez comme suit :

    • CloudWatch journaux : Désactivé

    • Journaux S3 : Activé

    • Compartiment: codebuild-regionId-account-bucket

    • Chemin du journal : CODEBUILD-LOGS

15. Choisissez Créer un projet de génération.

Pour créer le projet de conversion de code

1. Connectez-vous à la CodeBuild console et choisissez Créer un projet de construction.

2. Dans la section Configuration du projet, donnez un nom au projet (par exemple,3-awsm2ccm-convert).

3. Dans la section Source, pour Fournisseur source, choisissez Amazon S3, puis choisissez le compartiment d'entrée que vous avez créé précédemment (par exemple,codebuild-regionId-accountId-bucket).

4. Dans le champ Clé d'objet S3 ou dossier S3, entrezprj_codebuild_01.

5. Dans la section Environnement, choisissez Image personnalisée.

6. Dans le champ Type d'environnement, choisissez Linux.

7. Sous Registre d'images, choisissez Autre registre.

8. Dans le champ URL du registre externe, suivez la AWS Mainframe Modernization conteneur section.

9. Sous Rôle de service, choisissez Rôle de service existant, puis dans le champ ARN du rôle, choisissez le rôle de service que vous avez créé précédemment ; par exemple,IAMRoleTaskExecutionRoleForCodeBuild.

10. Développez la section Configuration supplémentaire, procédez comme suit :

    1. VPC : configurez si nécessaire en fonction de votre configuration.

    2. Délai d'attente : réglé sur 60 minutes.

    3. Délai d'attente : réglé sur 480 minutes.

    4. Chiffrement : choisissez les paramètres de cryptage appropriés (la valeur par défaut convient).

    5. Dans la section Variables d'environnement, ajoutez les éléments suivants un par un :

       • Nom : PROJECT_BUCKET. Valeur :codebuild-regionId-accountId-bucket. Type : texte en clair

       • Nom : PROJECT_DIR. Valeur :prj_codebuild_01. Type : texte en clair

       • Nom : AWSM2CCM_ACTION. Valeur :conversion. Type : texte en clair

       • Nom : AWSM2CCM_LOGGING_BUCKET. Valeur :s3:// codebuild-regionId-accountId-bucket. Type : texte en clair

11. Dans la section Buildspec, choisissez Insérer des commandes de génération, puis Passez à l'éditeur.

12. Remplacez les valeurs actuelles par les valeurs suivantes :

    version: 0.2 
    phases: 
        build: 
            commands: 
                - export AWSM2CCM_PUSH_RUNTIME_COPYBOOKS=y 
                - ln -s $CODEBUILD_SRC_DIR $PROJECT_DIR 
                - . /app/awsm2ccm_prod/bin/setup_env.sh
                - run_awsm2ccm.sh $PROJECT_DIR
    artifacts: 
        files: 
            - '*.log' 
            - '_Converted/*/*' 
            - '_Reports/*'  
        discard-paths: no 
        base-directory: $PROJECT_DIR

    où PROJECT_DIR sont des variables d'environnement disponibles dans. CodeBuild Pour plus d'informations, consultez la section Variables d'environnement dans les environnements de génération.

13. Dans la section Artefacts, procédez comme suit :

    • sous Type, choisissez Amazon S3, puis choisissez votre compartiment de sortie (par exemple,codebuild-regionId-accountId-bucket).

    • pour Path, saisissez ARTIFACTS.

    • pour Nom, entrezprj_codebuild_01.

    • pour l'emballage des artefacts, sélectionnez Aucun.

    • pour Remplacer le nom de l'artefact, décochez cette option.

    • pour le chiffrement, laissez-le dans les paramètres par défaut.

14. Pour la section Journaux, procédez comme suit :

    • CloudWatch journaux : Désactivé

    • Journaux S3 : Activé

    • Compartiment: codebuild-regionId-account-bucket

    • Chemin du journal : CODEBUILD-LOGS

15. Choisissez Créer un projet de génération.

1. Connectez-vous à la AWS CodeBuild console.

2. Dans le volet de navigation de gauche, choisissez Créer des projets.

3. Sélectionnez le projet créé précédemment (1-awsm2ccm-define-project) à créer

4. Choisissez Démarrer la construction, puis Démarrer maintenant pour définir le projet. Une fois la construction démarrée, le statut passe à En cours.

5. Choisissez Détails de la phase pour voir la progression de chaque étape orchestrée par le AWS CodeBuild projet.

6. Attendez que le statut ait changé pour réussir pour toutes les étapes.

7. Accédez à la console Amazon S3.

8. Localisez et cliquez sur le compartiment Amazon S3 nommé codebuild-regionId-accountId-bucket

   • CODEBUILD-LOGS/le dossier contient les AWS CodeBuild journaux des AWS CodeBuild projets en cours d'exécution.

   • prj_codebuild_01/dossier contenant la structure du projet. Il est utilisé lors des étapes d'analyse, d'expand_macros et de conversion. Vous pouvez choisir prj_codebuild_01/ d'explorer les détails

   • cobol_reserved.rswfichier de configuration (liste de mots COBOL) réservé au convertisseur. Il est utilisé lors de l'étape de conversion.

   • Macro_Expansion/le dossier contient des macros à développer dans les programmes Assembleur. Il est utilisé lors de l'étape expand_macros.

   • macro_settings.jsonle fichier de configuration contient un remplacement de macro personnalisé. Il est utilisé lors de l'étape expand_macros.

   • macrolib/le dossier contient les macros Assembler à convertir. Il est utilisé lors de l'analyse et de l'étape de conversion.

     1. Sélectionnez macrolib/.

     2. Par défaut, une macro Assembleur nommée MACRO1.mac est fournie en tant que fichier d'exemple. Supprimez ce fichier car il n'est pas nécessaire pour l'analyse.

     3. Téléchargez vos macros dans ce répertoire.

   • project_settings_aux.jsonle fichier de configuration contient les paramètres relatifs à la page de code. Il est utilisé lors de l'étape de conversion.

   • project_settings.jsonle fichier de configuration contient les paramètres du convertisseur. Il est utilisé lors de l'étape de conversion.

   • srclib/le dossier contient les programmes Assembler à convertir. Il est utilisé lors de l'analyse et de l'étape de conversion.

     1. Sélectionnez srclib/.

     2. Par défaut, deux programmes Assembler sont nommés SQtest01.asm et SQtest02.asm sont fournis en tant qu'exemples. Supprimez ces fichiers car ils ne sont pas nécessaires à votre analyse et à votre conversion.

     3. Téléchargez vos programmes Assembler dans ce répertoire.

9. Vérifiez le statut de l'1-awsm2ccm-define-projectétape. Cela aurait dû réussir sous l'onglet État de la dernière version.

1. Dans le volet de navigation de gauche, choisissez Créer des projets.

2. Choisissez le projet que vous avez créé à l'étape 6.2 pour créer :2-awsm2ccm-analysis.

3. Choisissez Start build, puis Start now pour générer des rapports d'analyse. Cela lancera la construction et passera au statut En cours.

4. Choisissez les détails de la phase où vous pourrez voir la progression de chaque étape orchestrée par le AWS CodeBuild projet. Attendez que le statut change pour réussir pour toutes les étapes.

5. À partir de Console de gestion AWS, accédez à la console de service Amazon S3.

6. Localisez le compartiment Amazon S3 et cliquez dessus : codebuild-regionId-accountId-bucket

   1. ARTIFACTS/le dossier contient les résultats des étapes d'analyse et de conversion.

   2. Sélectionnez ARTIFACTS/prj_codebuild_01/_Reports/.

   3. Les rapports suivants seront disponibles :

      • AWSM2CCM-Analysis-Report-<timestamp>.pdfest un rapport exécutif qui fournit la facturation et la portée de la conversion du AWS Mainframe Modernization code, améliorant la conversion, le résumé des conversions et les statistiques de conversion détaillées. Il résume également le nombre de codes et le nombre de codes facturables au niveau du projet et fournit des mesures et des listes de membres référencés pour chaque composant. Il est essentiel d'exécuter et d'examiner ce rapport avant d'exécuter la conversion proprement dite.

      • Conversion_Detailed_Statistics.txtfournit la fréquence et le résultat de conversion attendu (indiqué par « État de conversion ») pour chaque instruction trouvée dans chaque composant. Cela permet d'identifier rapidement si les instructions que le convertisseur ne prend pas en charge sont claires. Les résultats possibles de l'état de conversion sont les suivants :

        • Totalement converti  : l'instruction sera convertie avec précision en COBOL.

        • Partiellement convertie  : l'instruction est prise en charge mais utilise un paramètre ou une expression non pris en charge. Des ajustements manuels sont probablement nécessaires après la conversion.

        • Non converti  : l'instruction n'est pas prise en charge par le convertisseur.

        • Pre-compile instructions à vérifier  : elles sont normalement incluses dans les macros et font référence à ce que l'on appelle probablement aussi les instructions du langage d'assemblage conditionnel (par exemple, AIF, AGO) sur le mainframe. Ils sont gérés par le pré-compilateur qui est piloté par de telles instructions ou directives qui sélectionne et produit du code clean/static ASM. Ces instructions dépendent des valeurs réelles des paramètres de macro qui sont compilés. Ainsi, la même macro peut générer différents morceaux de code ASM, en fonction des valeurs des paramètres transmis. Cela est dû à la présence de telles instructions de pré-compilation. Dans ce cas, envisagez d'étendre ou de réorganiser la macro.

      • Conversion_Global_Statistics.txtfournit un résumé de l'état de conversion au niveau du composant.

      • CrossReference_PgmToCpyMacro.txtrapports sur les dépendances du programme Assembler vis-à-vis des macros. Il fournit un moyen rapide de déterminer s'il manque des macros dans le code téléchargé.

      • CrossReference_PgmToPgm.txtrapports sur les dépendances du programme Assembler par rapport à d'autres programmes Assembleur. Il fournit un moyen rapide de déterminer si des programmes Assembler sont absents du code téléchargé.

7. Retournez à la console AWS CodeBuild de service.

8. Vérifiez l'état de l'étape d'analyse 2-awsm2ccm. Cela aurait dû réussir sous l'onglet État de la dernière version.

1. À partir de Console de gestion AWS, accédez au service Amazon S3.

2. Localisez et cliquez sur le compartiment Amazon S3 :codebuild-regionId-accountId-bucket.

   1. Accédez à prj_codebuild_01/.

   2. Sélectionnezproject_settings.json, puis choisissez Télécharger.

   3. Ouvrez le project_settings.json fichier pour voir la structure JSON suivante :

      { 
      "Source programs directory":"srclib", 
      "Source copybooks/macros directory":"macrolib", 
      "Copybook/Macros Conversion":"Called_only", 
      "Do not regenerate the Copy/Macro if already exists":"false", 
      "Target Compiler":"IBM", 
      "Endianess":"Big", 
      "Converted programs extension":"", 
      "Converted CICS programs extension":"", 
      "Converted copies/macros extension":"", 
      "Trace Level":"STANDARD", 
      "Trace file open mode":"append", 
      "Data definition level":5, 
      "Start picture column":40, 
      "Generate Sync FILLER with name":"FILL-SYNC", 
      "Use SYNC clause":"yes", 
      "Decimal Point Comma":"true", 
      "Original Source Placement":"RIGHT" 
      }

      Où :

      • Répertoire du programme source  : contient les programmes Assembler nécessaires à la conversion.

      • copybooks/MacrosRépertoire source  : contient les macros Assembleur et les cahiers nécessaires à la conversion.

      • Copybooks/Macros la conversion peut être soit :

        • Tout  : ce bouton radio indique que la conversion complète convertira tout ce qui est copybook/Macros disponible dans le répertoire, que celui-ci soit utilisé par les programmes ou non.

        • Called_only: Ce bouton radio indique que la conversion complète ne convertira copybook/Macros que celle réellement utilisée par les programmes.

      • Important

        Vous n'avez pas besoin de le régénérer Copy/Macro s'il existe déjà.

        Lorsque cela est vrai, l'outil ne le convertira pas copybook/Macro à nouveau, s'il est déjà converti (existe dans le dossier de sortie).

      • Cible  : La conversion des programmes (code généré) dépend du compilateur COBOL cible. Les options suivantes sont prises en charge :

        • « IBM » pour mainframe IBM

        • « MF » pour Micro Focus COBOL

        • « VERYANT » pour Veryant ISCOBOL

        • « NTT » pour NTT DATA Enterprise COBOL (Unikix)

      • Endianess et Bitness  : La conversion des programmes (code généré) dépend de la plateforme cible (). bit/endianess Cette combinaison permet de sélectionner les options prises en charge suivantes :

        • Endianess : Grand (pour Big-Endian) /Petit (Little-Endian). Par exemple, le z/OS mainframe IBM est Big-Endian, Windows l'est Little-Endian, Linux varie selon la distribution (par exemple, Amazon Linux 2 sur EC2 l'est Little-Endian).

        • Nombre de bits : 32/64 (s'il n'est pas indiqué, la valeur par défaut sera 32). Le réglage recommandé est de 32 bits.

      • Extension du programme converti  : il s'agit de définir l'extension de fichier pour les programmes COBOL générés. Vide (« ») : aucune extension. Pour les cibles COBOL de Rocket Software (anciennement Micro Focus), le CBL est recommandé pour permettre à Rocket Enterprise Developer de reconnaître correctement les fichiers.

      • Extension de programme CICS convertie  : il s'agit de définir l'extension de fichier pour les programmes CICS COBOL générés. Vide (« ») : aucune extension. Pour les cibles COBOL de Rocket Software, le CBL est recommandé pour permettre à Rocket Enterprise Developer de reconnaître correctement les fichiers.

      • copybooks/MacrosExtension convertie  : il s'agit de définir l'extension de fichier pour les classeurs COBOL générés. Vide (« ») : aucune extension. Pour les cibles COBOL de Rocket Software, le CPY est recommandé pour permettre à Rocket Enterprise Developer de reconnaître correctement les fichiers.

      • Niveau de trace  : la trace est l'information qui est enregistrée CodeBuild lors de la conversion. L'utilisateur peut sélectionner le niveau de détail en sélectionnant l'une des options proposées.

        • ERREUR = ERREUR DE TRACE : seules les erreurs de conversion sont affichées.

        • STANDARD = TRACE STANDARD : les erreurs de conversion et les informations standard sont affichées. Il s'agit du réglage recommandé.

        • TOUT = TRACE TOUT : niveau de traçage maximal

      • Mode d'ouverture du fichier de trace  : non utilisé. Le réglage par défaut de l'ajout est recommandé.

      • Niveau de définition des données  : il indique le niveau initial des sous-champs (après le niveau « 01 ») définis dans la section Working-storage and linkage. Ça doit être un chiffre.

      • Colonne d'image de départ  : il s'agit du format du code COBOL généré et indique la colonne dans laquelle la clause PIC est placée (après les noms des champs). Ça doit être un chiffre.

      • Emplacement de la source d'origine : Cela indique la position où les commentaires sont placés dans le programme. Il dispose de deux options :

        • DROITE  : Cette option placera le commentaire ou les informations supplémentaires au bon endroit après la soixante-treizième (73) colonne. En COBOL, le code est écrit dans les soixante-douze premières (1-72) colonnes et tout ce qui se trouve dans la soixante-treizième (>= 73) colonne sera traité comme un commentaire.

        • CI-DESSUS  : Cette option placera le commentaire au-dessus du contenu traduit.

      • Générer Sync FILLER avec un nom  : Cette option est liée à l'alignement en mémoire des champs binaires (types de données Assembleur « H », « F », « D », qui sont convertis en type de données COBOL « COMP »). Afin de garantir la bonne limite d'alignement, des champs de remplissage explicites seront ajoutés lors de la conversion. Il s'agit d'une option basée sur du texte, la valeur doit être une chaîne (similaire FILL-SYNC).

      • Clause Use SYNC  : cette option fait référence à l'alignement en mémoire des champs binaires. Oui = tous les champs ont été convertis en COBOL. « COMP » sera défini par la clause « SYNC » (par exemple, 05 WRKFLD PIC S9 (09) COMP SYNC).

      • Virgule décimale  : Lorsque cela est vrai, la clause DECIMAL-POINT IS COMMA sera ajoutée au paragraphe COBOL « SPECIAL-NAMES ».

   4. En fonction de vos besoins, modifiez les paramètres appropriés, puis enregistrez leproject_settings.json.

   5. Supprimez le project_settings.json fichier existant du prj_codebuild_01/ compartiment Amazon S3, puis chargez la nouvelle version.

3. Retournez au AWS CodeBuild service.

4. Sélectionnez le projet à construire que vous avez créé précédemment : 3-awsm2ccm-convert

   1. Choisissez Démarrer la compilation, puis Démarrer maintenant pour convertir les programmes Assembleur et les macros en programmes COBOL et en cahiers.

   2. Attendez que l'état de construction passe à Succeeded pour ce projet. Il se trouvera sous l'onglet État de la dernière version.

1. À partir de Console de gestion AWS, accédez au service Amazon S3.

2. Localisez et cliquez sur le compartiment Amazon S3 :codebuild-regionId-accountId-bucket.

3. Naviguez vers awsm2ccm-do-not-delete . AWS Mainframe Modernization La conversion de code crée des fichiers binaires codés pour chaque module Assembleur ou Macro au cours du processus de conversion. Ces fichiers sont essentiels pour éviter la facturation en double aux clients et également pour suivre la quantité de code Assembler fourni qui a été analysée et convertie. Les fichiers sont stockés à l'emplacement suivant :codebuild-regionId-accountId- bucket/awsm2ccm-do-not-delete/<your_AWS_account_id>/Hash. Les fichiers codés ne contiennent aucun code Assembleur et il n'est pas non plus possible d'extraire le code client de ces fichiers.

   Important

   Vous ne pouvez ni modifier manuellement ces fichiers ni les supprimer. La modification ou la suppression de ces fichiers peut entraîner des facturations multiples pour les mêmes composants.

   Traitez le awsm2ccm-do-not-delete/ dossier comme un répertoire géré par le système. Consultez Support avant d'apporter des modifications à ce répertoire ou à son contenu.

4. Cliquez codebuild-regionId-accountId-bucket pour revenir au compartiment.

5. Choisissez ARTIFACTS/prj_codebuild_01/. Le dossier _Converted/ contient les sorties COBOL générées à la suite de l'étape de conversion de code. Il contiendra les sous-répertoires suivants :

   • Le dossier copybooks/ contient les cahiers COBOL générés.

   • le dossier programs/ contient les programmes COBOL générés.

   • Le dossier runtime_lib/ contient des programmes COBOL et des cahiers supplémentaires fournis par la solution.

6. Si les rapports d'analyse et les autres rapports indiquent que la conversion a été réussie et que le AWS CodeBuild projet 3-awsm2ccm-convert est marqué comme réussi, téléchargez le code COBOL et les cahiers depuis le répertoire _Converted/.

1. À partir de Console de gestion AWS, accédez au service Amazon S3.

2. Localisez et cliquez sur le compartiment Amazon S3 :codebuild-regionId-accountId-bucket.

3. Accédez à l'emplacement : ARTIFACTS/prj_codebuild_01/_Converted/.

4. Téléchargez le code COBOL converti depuis tous les sous-répertoires sous _Converted/. Vous pouvez également utiliser la commande CLI suivante pour les télécharger immédiatement :

   aws s3 cp s3://codebuild-regionId-accountId- 
   bucket/ARTIFACTS/prj_codebuild_01/_Converted/ . --recursive

5. Analysez et compilez le COBOL converti dans l'environnement COBOL cible.