Tutorial: Code von Assembler nach COBOL konvertieren in AWS Mainframe Modernization

1. Öffnen Sie die AWS Mainframe Modernization Konsole unter https://console.aws.amazon.com/m2/.

2. Wählen Sie in der linken Navigationsleiste Tools aus.

3. Wählen Sie in der Codekonvertierung von AWS Mainframe Modernization with mLogica die Option Share assets with my aus. AWS-Konto

1. Um den Projekt-Bucket zu erstellen, melden Sie sich bei der Amazon S3-Konsole an und wählen Sie Create bucket.

2. Geben Sie unter Allgemeine Konfiguration einen Namen für den Bucket an und geben Sie an AWS-Region , wo Sie den Bucket erstellen möchten. Ein Beispielname istcodebuild-regionId-accountId-bucket, wobei:

   • regionIdist der AWS-Region des Eimers.

   • accountIdist dein AWS-Konto Ausweis.

   Anmerkung

   Wenn Sie den Bucket in einem anderen AWS-Region Land als USA East (Nord-Virginia) erstellen, geben Sie den LocationConstraint Parameter an. Weitere Informationen finden Sie unter Bucket erstellen in der Amazon Simple Storage Service API-Referenz.

3. Behalten Sie alle anderen Einstellungen bei und wählen Sie Create Bucket.

So erstellen Sie eine Richtlinie

1. Melden Sie sich bei der IAM-Konsole an und wählen Sie im linken Navigationsbereich Policies aus.

2. Wählen Sie Richtlinie erstellen aus.

3. Kopieren Sie die folgende JSON-Richtlinie und fügen Sie sie in den Richtlinieneditor ein.

   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. Sie können der Richtlinie optional Tags hinzufügen. Tags sind Schlüssel-Wert-Paare, die Ihnen helfen können, den Zugriff auf die Richtlinie zu organisieren, zu verfolgen oder zu kontrollieren.

5. Wählen Sie Next:Review.

6. Geben Sie einen Namen für die Richtlinie ein, z. B. CodeBuildAWSM2CCMPolicy

7. Sie können optional eine Beschreibung für die Richtlinie eingeben und die Zusammenfassung der Richtlinie überprüfen, um sicherzustellen, dass sie korrekt ist.

8. Wählen Sie Richtlinie erstellen aus.

1. Melden Sie sich bei der IAM-Konsole an und wählen Sie im linken Navigationsbereich Roles aus.

2. Wählen Sie Rolle erstellen aus.

3. Wählen Sie unter Vertrauenswürdiger Entitätstyp die Option AWS-Service aus.

4. Wählen Sie unter Anwendungsfälle für andere AWS-Services die Option aus CodeBuild, und wählen Sie dann CodeBuild erneut.

5. Wählen Sie Weiter aus.

6. Wählen Sie auf der Seite Add permissions (Berechtigungen hinzufügen) die Option Next (Weiter) aus. Sie weisen der Rolle später eine Richtlinie zu.

7. Geben Sie unter Rollendetails einen Namen für die Rolle ein, IAMRoleTaskExecutionRoleForCodeBuild z. B.

8. Vergewissern Sie sich, dass das Richtliniendokument unter Vertrauenswürdige Entitäten auswählen wie folgt aussieht:

   JSON

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

9. Wählen Sie Rolle erstellen aus.

1. Melden Sie sich bei der IAM-Konsole an und wählen Sie im linken Navigationsbereich Rollen aus.

2. Wählen Sie unter Rollen die Rolle aus, die Sie zuvor erstellt haben, IAMRoleTaskExecutionRoleForCodeBuild z. B.

3. Wählen Sie unter Berechtigungsrichtlinien die Option Berechtigungen hinzufügen und dann Richtlinien anhängen aus.

4. Wählen Sie unter Andere Berechtigungsrichtlinien die Richtlinien aus, die Sie zuvor erstellt haben, CodeBuildAWSM2CCMPolicy z. B.

5. Wählen Sie Richtlinien anfügen.

Um das Define-Projekt zu erstellen

1. Melden Sie sich bei der CodeBuild Konsole an und wählen Sie Create build project.

2. Geben Sie im Abschnitt Projektkonfiguration einen Namen für das Projekt ein, 1-awsm2ccm-define-project z. B.

3. Belassen Sie im Abschnitt Quelle für Quellanbieter die Standardauswahl.

4. Wählen Sie im Abschnitt Umgebung die Option Benutzerdefiniertes Bild aus.

5. Wählen Sie im Feld Umgebungstyp die Option Linux aus.

6. Wählen Sie unter Image-Registrierung die Option Andere Registrierung aus.

7. Folgen Sie im Feld Externe Registrierungs-URL dem AWS Mainframe Modernization Container Abschnitt.

8. Wählen Sie unter Servicerolle die Option Existierende Servicerolle aus, und wählen Sie im Feld Rollen-ARN die Servicerolle aus, die Sie zuvor erstellt haben (z. B.IAMRoleTaskExecutionRoleForCodeBuild).

9. Erweitern Sie den Abschnitt Zusätzliche Konfiguration und gehen Sie wie folgt vor:

   1. VPC: Konfigurieren Sie, falls erforderlich, basierend auf Ihrem Setup.

   2. Timeout: Auf 60 Minuten eingestellt.

   3. Timeout in der Warteschlange: Auf 480 Minuten festgelegt.

   4. Verschlüsselung: Wählen Sie die entsprechenden Verschlüsselungseinstellungen (die Standardeinstellung ist in Ordnung).

   5. Fügen Sie im Abschnitt Umgebungsvariablen nacheinander Folgendes hinzu:

      • Name: PROJECT_BUCKET. Wert:. codebuild-regionId-accountId- bucket Typ: Klartext

      • Name: PROJECT_DIR. Wert:. prj_codebuild_01 Typ: Klartext

      • Name: AWSM2CCM_ACTION. define_projectWert:. Typ: Klartext

      • Name: AWSM2CCM_LOGGING_BUCKET. s3:// codebuild-regionId-accountId-bucketWert:. Typ: Klartext

10. Wählen Sie im Abschnitt Buildspec die Option Build-Befehle einfügen und dann Zum Editor wechseln.

11. Ersetzen Sie die aktuellen Werte durch diese:

    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

    wobei PROJECT_DIR Umgebungsvariablen sind, die darin verfügbar sind. CodeBuild Weitere Informationen finden Sie unter Umgebungsvariablen in Build-Umgebungen.

12. Gehen Sie im Abschnitt Artefakte wie folgt vor:

    • Wählen Sie unter Typ die Option Amazon S3 aus, und wählen Sie dann Ihren Ausgabe-Bucket aus, codebuild-regionId-accountId-bucket z. B.

    • Lassen Sie dieses Feld für Path leer.

    • geben Sie für Name einprj_codebuild_01.

    • Wählen Sie für Artefaktverpackung die Option Keine aus.

    • Deaktivieren Sie diese Option für Artefaktnamen überschreiben.

    • Belassen Sie für Verschlüsselung die Standardeinstellungen.

13. Gehen Sie für den Abschnitt „Protokolle“ wie folgt vor:

    • CloudWatch Protokolle: Deaktiviert

    • S3-Protokolle: Aktiviert

    • Bucket: codebuild-regionId-account-bucket

    • Protokollpfad: CODEBUILD-LOGS

14. Wählen Sie Create build project (Build-Projekt erstellen) aus.

Um das Codeanalyse-Projekt zu erstellen

1. Melden Sie sich bei der CodeBuild Konsole an und wählen Sie Build-Projekt erstellen.

2. Geben Sie im Abschnitt Projektkonfiguration einen Namen für das Projekt ein, 2-awsm2ccm-analysis z. B.

3. Wählen Sie im Abschnitt Source für Source provider die Option Amazon S3 aus , und wählen Sie dann den Eingabe-Bucket aus, den Sie zuvor erstellt haben (z. B.codebuild-regionId-accountId-bucket).

4. Geben Sie in das Feld S3-Objektschlüssel oder S3-Ordner einprj_codebuild_01.

5. Wählen Sie im Abschnitt Umgebung die Option Benutzerdefiniertes Bild aus.

6. Wählen Sie im Feld Umgebungstyp die Option Linux aus.

7. Wählen Sie unter Image-Registrierung die Option Andere Registrierung aus.

8. Folgen Sie im Feld Externe Registrierungs-URL dem AWS Mainframe Modernization Container Abschnitt.

9. Wählen Sie unter Servicerolle die Option Existierende Servicerolle aus, und wählen Sie im Feld Rollen-ARN die Servicerolle aus, die Sie zuvor erstellt haben (z. B.IAMRoleTaskExecutionRoleForCodeBuild).

10. Erweitern Sie den Abschnitt Zusätzliche Konfiguration und gehen Sie wie folgt vor:

    1. VPC: Konfigurieren Sie, falls erforderlich, basierend auf Ihrem Setup.

    2. Timeout: Auf 60 Minuten eingestellt.

    3. Timeout in der Warteschlange: Auf 480 Minuten festgelegt.

    4. Verschlüsselung: Wählen Sie die entsprechenden Verschlüsselungseinstellungen (die Standardeinstellung ist in Ordnung).

    5. Fügen Sie im Abschnitt Umgebungsvariablen nacheinander Folgendes hinzu:

       • Name: PROJECT_BUCKET. Wert:. codebuild-regionId-accountId-bucket Typ: Klartext

       • Name: PROJECT_DIR. Wert:. prj_codebuild_01 Typ: Klartext

       • Name: AWSM2CCM_ACTION. analysisWert:. Typ: Klartext

       • Name: AWSM2CCM_LOGGING_BUCKET. s3:// codebuild-regionId-accountId-bucketWert:. Typ: Klartext

11. Wählen Sie im Abschnitt Buildspec die Option Build-Befehle einfügen und dann Zum Editor wechseln.

12. Ersetzen Sie die aktuellen Werte durch Folgendes:

    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

    wobei PROJECT_DIR Umgebungsvariablen sind, die darin verfügbar sind. CodeBuild Weitere Informationen finden Sie unter Umgebungsvariablen in Build-Umgebungen.

13. Gehen Sie im Abschnitt Artefakte wie folgt vor:

    • Wählen Sie unter Typ die Option Amazon S3 aus, und wählen Sie dann Ihren Ausgabe-Bucket aus (z. B.codebuild-regionId-accountId-bucket).

    • Geben Sie ARTIFACTS als Pfad ein.

    • geben Sie für Name den Wert einprj_codebuild_01.

    • Wählen Sie für Artefaktverpackung die Option Keine aus.

    • Deaktivieren Sie diese Option für Artefaktnamen überschreiben.

    • Belassen Sie für Verschlüsselung die Standardeinstellungen.

14. Gehen Sie für den Abschnitt „Protokolle“ wie folgt vor:

    • CloudWatch Protokolle: Deaktiviert

    • S3-Protokolle: Aktiviert

    • Bucket: codebuild-regionId-account-bucket

    • Protokollpfad: CODEBUILD-LOGS

15. Wählen Sie Create build project (Build-Projekt erstellen) aus.

Um das Codekonvertierungsprojekt zu erstellen

1. Melden Sie sich bei der CodeBuild Konsole an und wählen Sie Build-Projekt erstellen.

2. Geben Sie im Abschnitt Projektkonfiguration einen Namen für das Projekt ein (z. B.3-awsm2ccm-convert).

3. Wählen Sie im Abschnitt Source für Source provider die Option Amazon S3 aus und wählen Sie dann den Eingabe-Bucket aus, den Sie zuvor erstellt haben (z. B.codebuild-regionId-accountId-bucket).

4. Geben Sie in das Feld S3-Objektschlüssel oder S3-Ordner einprj_codebuild_01.

5. Wählen Sie im Abschnitt Umgebung die Option Benutzerdefiniertes Bild aus.

6. Wählen Sie im Feld Umgebungstyp die Option Linux aus.

7. Wählen Sie unter Image-Registrierung die Option Andere Registrierung aus.

8. Folgen Sie im Feld Externe Registrierungs-URL dem AWS Mainframe Modernization Container Abschnitt.

9. Wählen Sie unter Servicerolle die Option Existierende Servicerolle aus, und wählen Sie im Feld Rollen-ARN die Servicerolle aus, die Sie zuvor erstellt haben, IAMRoleTaskExecutionRoleForCodeBuild z. B.

10. Erweitern Sie den Abschnitt Zusätzliche Konfiguration und gehen Sie wie folgt vor:

    1. VPC: Konfigurieren Sie, falls erforderlich, basierend auf Ihrem Setup.

    2. Timeout: Auf 60 Minuten eingestellt.

    3. Timeout in der Warteschlange: Auf 480 Minuten festgelegt.

    4. Verschlüsselung: Wählen Sie die entsprechenden Verschlüsselungseinstellungen (die Standardeinstellung ist in Ordnung).

    5. Fügen Sie im Abschnitt Umgebungsvariablen nacheinander Folgendes hinzu:

       • Name: PROJECT_BUCKET. Wert:. codebuild-regionId-accountId-bucket Typ: Klartext

       • Name: PROJECT_DIR. Wert:. prj_codebuild_01 Typ: Klartext

       • Name: AWSM2CCM_ACTION. conversionWert:. Typ: Klartext

       • Name: AWSM2CCM_LOGGING_BUCKET. s3:// codebuild-regionId-accountId-bucketWert:. Typ: Klartext

11. Wählen Sie im Abschnitt Buildspec die Option Build-Befehle einfügen und dann Zum Editor wechseln.

12. Ersetzen Sie die aktuellen Werte durch diese:

    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

    wobei PROJECT_DIR Umgebungsvariablen sind, die darin verfügbar sind. CodeBuild Weitere Informationen finden Sie unter Umgebungsvariablen in Build-Umgebungen.

13. Gehen Sie im Abschnitt Artefakte wie folgt vor:

    • Wählen Sie unter Typ die Option Amazon S3 aus, und wählen Sie dann Ihren Ausgabe-Bucket aus (z. B.codebuild-regionId-accountId-bucket).

    • Geben Sie ARTIFACTS als Pfad ein.

    • geben Sie für Name den Wert einprj_codebuild_01.

    • Wählen Sie für Artefaktverpackung die Option Keine aus.

    • Deaktivieren Sie diese Option für Artefaktnamen überschreiben.

    • Belassen Sie für Verschlüsselung die Standardeinstellungen.

14. Gehen Sie für den Abschnitt „Protokolle“ wie folgt vor:

    • CloudWatch Protokolle: Deaktiviert

    • S3-Protokolle: Aktiviert

    • Bucket: codebuild-regionId-account-bucket

    • Protokollpfad: CODEBUILD-LOGS

15. Wählen Sie Create build project (Build-Projekt erstellen) aus.

1. Loggen Sie sich in die AWS CodeBuild Konsole ein.

2. Wählen Sie im linken Navigationsbereich die Option Projekte erstellen aus.

3. Wählen Sie das zuvor erstellte Projekt (1-awsm2ccm-define-project) aus, um es zu erstellen

4. Wählen Sie Build starten und dann Jetzt starten, um das Projekt zu definieren. Sobald der Build gestartet wird, ändert sich der Status in „In Bearbeitung“.

5. Wählen Sie „Phasendetails“, um den Fortschritt der einzelnen Schritte zu sehen, die vom AWS CodeBuild Projekt orchestriert werden.

6. Warten Sie, bis sich der Status für alle Schritte in „Erfolgreich“ geändert hat.

7. Gehen Sie zur Amazon S3-Konsole.

8. Suchen Sie den Amazon S3-Bucket mit dem Namen und klicken Sie darauf codebuild-regionId-accountId-bucket

   • CODEBUILD-LOGS/Der Ordner enthält die AWS CodeBuild Protokolle für die laufenden AWS CodeBuild Projekte.

   • prj_codebuild_01/Ordner, der die Projektstruktur enthält. Er wird während der Analyse-, expand_macros- und konvertierungsschritte verwendet. Sie können wählenprj_codebuild_01/, ob Sie Details erkunden möchten

   • cobol_reserved.rswKonfigurationsdatei (Liste der COBOL-Wörter), die für den Konverter reserviert ist. Sie wird während des Konvertierungsschritts verwendet.

   • Macro_Expansion/Der Ordner enthält Makros, die in Assembler-Programme erweitert werden können. Er wird während des Schritts expand_macros verwendet.

   • macro_settings.jsonDie Konfigurationsdatei enthält eine benutzerdefinierte Makroersetzung. Sie wird während des Schritts expand_macros verwendet.

   • macrolib/Der Ordner enthält die zu konvertierenden Assembler-Makros. Es wird während des Analyse- und Konvertierungsschritts verwendet.

     1. Wählen Sie macrolib/.

     2. Standardmäßig wird ein Assembler-Makro mit dem Namen MACRO1.mac als Beispieldatei bereitgestellt. Löschen Sie diese Datei, da sie für die Analyse nicht benötigt wird.

     3. Laden Sie Ihre Makros in dieses Verzeichnis hoch.

   • project_settings_aux.jsonDie Konfigurationsdatei enthält Einstellungen zur Codepage. Sie wird während des Konvertierungsschritts verwendet.

   • project_settings.jsonDie Konfigurationsdatei enthält Einstellungen für den Konverter. Sie wird während des Konvertierungsschritts verwendet.

   • srclib/Der Ordner enthält die zu konvertierenden Assembler-Programme. Es wird während des Analyse- und Konvertierungsschritts verwendet.

     1. Wählen Sie srclib/.

     2. Standardmäßig werden zwei Assembler-Programme benannt SQtest01.asm und als SQtest02.asm Beispiele bereitgestellt. Löschen Sie diese Dateien, da sie für Ihre Analyse und Konvertierung nicht benötigt werden.

     3. Laden Sie Ihre Assembler-Programme in dieses Verzeichnis hoch.

9. Überprüfen Sie den Status für 1-awsm2ccm-define-project Schritt. Auf der Registerkarte „Aktueller Build-Status“ sollte der Vorgang erfolgreich gewesen sein.

1. Wählen Sie im linken Navigationsbereich die Option Projekte erstellen aus.

2. Wählen Sie das Projekt aus, das Sie in Schritt 6.2 erstellt haben, um Folgendes zu erstellen:2-awsm2ccm-analysis.

3. Wählen Sie Build starten und dann Jetzt starten, um Analyseberichte zu generieren. Dadurch wird der Build gestartet und der Status in „In Bearbeitung“ geändert.

4. Wählen Sie „Phasendetails“ aus, in denen Sie den Fortschritt der einzelnen vom AWS CodeBuild Projekt orchestrierten Schritte sehen können. Warten Sie, bis sich der Status für alle Schritte in „Erfolgreich“ ändert.

5. Gehen Sie von AWS-Managementkonsole dort zur Amazon S3-Servicekonsole.

6. Suchen Sie den Amazon S3-Bucket und klicken Sie darauf: codebuild-regionId-accountId-bucket

   1. ARTIFACTS/Der Ordner enthält die Ausgaben der Analyse - und Konvertierungsschritte.

   2. Wählen Sie ARTIFACTS/prj_codebuild_01/_Reports/.

   3. Die folgenden Berichte werden verfügbar sein:

      • AWSM2CCM-Analysis-Report-<timestamp>.pdfist ein ausführlicher Bericht, der die Abrechnung und den Umfang der AWS Mainframe Modernization Code-Konvertierung enthält. Er verbessert die Konvertierung, die Zusammenfassung der Konversionen und die detaillierten Konversionsstatistiken. Er fasst auch die Anzahl der Codes und der fakturierbaren Codes auf Projektebene zusammen und enthält Kennzahlen und Listen der Mitglieder, auf die verwiesen wird, für jede Komponente. Es ist wichtig, diesen Bericht vor der eigentlichen Konvertierung auszuführen und zu überprüfen.

      • Conversion_Detailed_Statistics.txtgibt die Häufigkeit und das erwartete Konvertierungsergebnis (angezeigt als „Konvertierungsstatus“) für jede Anweisung in den einzelnen Komponenten an. Auf diese Weise können Sie schnell feststellen, ob Anweisungen eindeutig sind, die der Konverter nicht unterstützt. Mögliche Ergebnisse zum Konvertierungsstatus sind:

        • Vollständig konvertiert: Die Anweisung wird korrekt in COBOL konvertiert.

        • Teilweise konvertiert: Die Anweisung wird unterstützt, verwendet jedoch einen Parameter oder Ausdruck, der nicht unterstützt wird. Nach der Konvertierung sind wahrscheinlich manuelle Anpassungen erforderlich.

        • Nicht konvertiert: Die Anweisung wird vom Konverter nicht unterstützt.

        • Pre-compile Anweisungen zur Überprüfung: Diese sind normalerweise in den Makros enthalten und beziehen sich auf Anweisungen, die wahrscheinlich auch als Conditional Assembly Language (z. B. AIF, AGO) auf dem Mainframe bekannt sind. Diese werden vom Pre-Compiler verarbeitet, der von solchen Anweisungen oder Direktiven gesteuert wird, ASM-Code auswählt und erzeugt. clean/static Diese Anweisungen hängen von den tatsächlichen Werten der Macro-Parameter ab, die kompiliert werden. Das gleiche Makro kann also, abhängig von den Werten der übergebenen Parameter, verschiedene Teile von ASM-Code generieren. Dies liegt an dem Vorhandensein solcher Anweisungen vor der Kompilierung. In diesem Fall sollten Sie erwägen, das Makro zu erweitern oder neu zu entwickeln.

      • Conversion_Global_Statistics.txtbietet eine Zusammenfassung des Konvertierungsstatus auf Komponentenebene.

      • CrossReference_PgmToCpyMacro.txtberichtet über Assembler-Programmabhängigkeiten von Makros. Es bietet eine schnelle Möglichkeit, festzustellen, ob Makros im hochgeladenen Code fehlen.

      • CrossReference_PgmToPgm.txtberichtet über Abhängigkeiten von Assembler-Programmen von anderen Assembler-Programmen. Es bietet eine schnelle Möglichkeit, festzustellen, ob Assembler-Programme im hochgeladenen Code fehlen.

7. Kehren Sie zur AWS CodeBuild Servicekonsole zurück.

8. Überprüfen Sie den Status für den 2-awsm2ccm-Analyseschritt. Auf der Registerkarte „Aktueller Build-Status“ sollte dies erfolgreich gewesen sein.

1. Gehen Sie von dort zum Amazon S3-Dienst. AWS-Managementkonsole

2. Suchen Sie den Amazon S3-Bucket und klicken Sie darauf:codebuild-regionId-accountId-bucket.

   1. Wechseln Sie zu prj_codebuild_01/.

   2. Wählen Sieproject_settings.json, und wählen Sie Herunterladen.

   3. Öffnen Sie die project_settings.json Datei, um die folgende JSON-Struktur zu sehen:

      { 
      "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" 
      }

      wobei

      • Quellprogrammverzeichnis: enthält die Assembler-Programme, die für die Konvertierung benötigt werden.

      • copybooks/MacrosQuellverzeichnis: enthält die Assembler-Makros und Copybooks, die für die Konvertierung benötigt werden.

      • Copybooks/Macros Die Konvertierung kann entweder sein:

        • Alle: Dieses Optionsfeld gibt an, dass bei der vollständigen Konvertierung alle im Verzeichnis copybook/Macros verfügbaren Dateien konvertiert werden, unabhängig davon, ob das Verzeichnis von den Programmen verwendet wird oder nicht.

        • Called_only: Dieses Optionsfeld bedeutet, dass bei der vollständigen Konvertierung nur das konvertiert wird, was tatsächlich von den copybook/Macros Programmen verwendet wird.

      • Wichtig

        Sie müssen das nicht erneut generieren, Copy/Macro falls es bereits existiert.

        Wenn dies zutrifft, konvertiert das Tool es nicht copybook/Macro erneut, wenn es bereits konvertiert ist (im Ausgabeordner vorhanden).

      • Ziel: Die Konvertierung der Programme (generierter Code) hängt vom Ziel-COBOL-Compiler ab. Die folgenden Optionen werden unterstützt:

        • „IBM“ für IBM-Mainframe

        • „MF“ für Micro Focus COBOL

        • „VERYANT“ für Veryant ist COBOL

        • „NTT“ für NTT DATA Enterprise COBOL (Unikix)

      • Endianess und Bitness: Die Konvertierung der Programme (generierter Code) hängt von der Zielplattform ab (). bit/endianess Diese Kombination ermöglicht die Auswahl der folgenden unterstützten Optionen:

        • Endianess: Groß (für Big-Endian)/Klein (Little-Endian). Zum Beispiel ist IBM z/OS Mainframe Big-Endian, Windows ist Little-Endian, Linux variiert je nach Distribution (z. B. Amazon Linux 2 auf EC2). Little-Endian

        • Bitanzahl: 32/64 (wenn nicht angegeben, ist die Standardeinstellung 32). Die empfohlene Einstellung ist 32 Bit.

      • Konvertierte Programmerweiterung: Damit wird die Dateierweiterung für die generierten COBOL-Programme festgelegt. Leer („“): keine Erweiterung. Für COBOL-Ziele von Rocket Software (ehemals Micro Focus) wird CBL empfohlen, damit Rocket Enterprise Developer die Dateien korrekt erkennen kann.

      • Konvertierte CICS-Programmerweiterung: Damit wird die Dateierweiterung für die generierten CICS-COBOL-Programme festgelegt. Leer („“): keine Erweiterung. Für COBOL-Ziele von Rocket Software wird CBL empfohlen, damit Rocket Enterprise Developer die Dateien korrekt erkennen kann.

      • Konvertierte copybooks/Macros Erweiterung: Damit wird die Dateierweiterung für die generierten COBOL-Copybooks festgelegt. Leer („“): keine Erweiterung. Für COBOL-Ziele von Rocket Software wird CPY empfohlen, damit Rocket Enterprise Developer die Dateien korrekt erkennen kann.

      • Trace-Level: Trace ist die Information, die CodeBuild während der Konvertierung protokolliert wird. Der Benutzer kann den Detaillierungsgrad auswählen, indem er eine der bereitgestellten Optionen auswählt.

        • ERROR = TRACE ERROR: Es werden nur Konvertierungsfehler angezeigt.

        • STANDARD = TRACE STANDARD: Konvertierungsfehler und Standardinformationen werden angezeigt. Dies ist die empfohlene Einstellung.

        • ALL = TRACE ALL: maximale Protokollierungsstufe

      • Modus zum Öffnen der Trace-Datei: Wird nicht verwendet. Die Standardeinstellung „Anhängen“ wird empfohlen.

      • Datendefinitionsebene: Dies gibt die Anfangsebene der Unterfelder (nach Ebene „01“) an, die im Workstorage- und Linkage-Abschnitt definiert sind. Muss eine Zahl sein.

      • Spalte mit Startbild: Hier geht es um das Format des generierten COBOL-Codes und gibt die Spalte an, in der die PIC-Klausel platziert ist (nach den Feldnamen). Muss eine Zahl sein.

      • Platzierung der Originalquelle: Dies gibt die Position an, an der die Kommentare im Programm platziert werden. Es gibt zwei Optionen:

        • RECHTS: Mit dieser Option werden der Kommentar oder die zusätzlichen Informationen an der richtigen Stelle nach der dreiundsiebzigsten (73) Spalte platziert. In COBOL wird der Code in die ersten zweiundsiebzig (1-72) Spalten geschrieben und alles aus der dreiundsiebzigsten (>= 73) Spalte wird als Kommentar behandelt.

        • OBEN: Bei dieser Option wird der Kommentar über dem übersetzten Inhalt platziert.

      • Sync-FILLER mit Namen generieren: Diese Option bezieht sich auf die Ausrichtung von Binärfeldern (Assembler-Datentypen „H“, „F“, „D“, „D“, die in den COBOL-Datentyp „COMP“ konvertiert werden). Um die korrekte Alignment-Grenze zu gewährleisten, werden bei der Konvertierung explizite Füllfelder hinzugefügt. Dies ist eine textbasierte Option, der Wert muss eine Zeichenfolge (like FILL-SYNC) sein.

      • SYNC-Klausel verwenden: Diese Option bezieht sich auf die Ausrichtung von Binärfeldern im Speicher. Ja = alle Felder wurden in COBOL konvertiert. „COMP“ wird mit der Klausel „SYNC“ definiert (z. B. 05 WRKFLD PIC S9 (09) COMP SYNC).

      • Dezimalkomma: Wenn dies zutrifft, wird die DECIMAL-POINT IS COMMA-Klausel zum COBOL-Absatz "" hinzugefügt. SPECIAL-NAMES

   4. Ändern Sie entsprechend Ihren Anforderungen die entsprechenden Parameter, und speichern Sie dann den. project_settings.json

   5. Entfernen Sie die vorhandene project_settings.json Datei aus prj_codebuild_01/ dem Amazon S3-Bucket und laden Sie dann die neue Version hoch.

3. Gehen Sie zurück zum AWS CodeBuild Service.

4. Wählen Sie das zu erstellende Projekt aus, das Sie zuvor erstellt haben: 3-awsm2ccm-convert

   1. Wählen Sie Build starten und dann Jetzt starten, um Assembler-Programme und Makros in COBOL-Programme und Copybooks zu konvertieren.

   2. Warten Sie, bis sich der Build-Status für dieses Projekt auf Erfolgreich geändert hat. Es wird auf der Registerkarte „Aktueller Build-Status“ angezeigt.

1. Gehen Sie von dort zum Amazon S3-Service. AWS-Managementkonsole

2. Suchen Sie den Amazon S3-Bucket und klicken Sie darauf:codebuild-regionId-accountId-bucket.

3. Navigiere zu awsm2ccm-do-not-delete . AWS Mainframe Modernization Bei der Codekonvertierung werden während des Konvertierungsvorgangs kodierte Binärdateien für jedes Assembler- oder Makromodul erstellt. Diese Dateien sind unerlässlich, um doppelte Rechnungen an die Kunden zu vermeiden und um nachzuverfolgen, wie viel des bereitgestellten Assembler-Codes analysiert und konvertiert wurde. Die Dateien werden am folgenden Ort gespeichert:codebuild-regionId-accountId- bucket/awsm2ccm-do-not-delete/<your_AWS_account_id>/Hash. Die kodierten Dateien enthalten keinen Assembler-Code und es ist auch nicht möglich, Kundencode aus diesen Dateien zu extrahieren.

   Wichtig

   Bearbeiten Sie diese Dateien weder manuell noch löschen Sie diese Dateien. Das Bearbeiten oder Löschen dieser Dateien kann zu mehreren Abrechnungen für dieselben Komponenten führen.

   Behandeln Sie den awsm2ccm-do-not-delete/ Ordner als vom System verwaltetes Verzeichnis. Konsultieren Sie, Support bevor Sie Änderungen an diesem Verzeichnis oder seinem Inhalt vornehmen.

4. Klicken Sie hiercodebuild-regionId-accountId-bucket, um zum Bucket zurückzukehren.

5. Wähle ARTIFACTS/prj_codebuild_01/. Der Ordner _Converted/ enthält die generierten COBOL-Ausgaben als Ergebnis des Code-Konvertierungsschritts. Er wird die folgenden Unterverzeichnisse haben:

   • Der Ordner copybooks/ enthält die generierten COBOL-Copybooks.

   • Der Ordner programs/ enthält die generierten COBOL-Programme.

   • Der Ordner runtime_lib/ enthält zusätzliche COBOL-Programme und Copybooks, die von der Lösung bereitgestellt werden.

6. Wenn aus den Analyseberichten und anderen Berichten hervorgeht, dass die Konvertierung erfolgreich war, und das AWS CodeBuild Projekt als Erfolgreich gekennzeichnet 3-awsm2ccm-convert ist, laden Sie den COBOL-Code und die Copybooks aus dem Verzeichnis _Converted/ herunter.

1. Gehen Sie von dort zum Amazon AWS-Managementkonsole S3-Service.

2. Suchen Sie den Amazon S3-Bucket und klicken Sie darauf:codebuild-regionId-accountId-bucket.

3. Navigieren Sie zum Standort: ARTIFACTS/prj_codebuild_01/_Converted/.

4. Laden Sie den konvertierten COBOL-Code aus allen Unterverzeichnissen unter _Converted/ herunter. Sie können sie auch mit dem folgenden CLI-Befehl auf einmal herunterladen:

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

5. Analysieren und kompilieren Sie das konvertierte COBOL in der COBOL-Zielumgebung.