AWS Der Mainframe Modernization Service (Managed Runtime Environment Experience) steht Neukunden nicht mehr zur Verfügung. Funktionen, die dem AWS Mainframe Modernization Service (Managed Runtime Environment-Erfahrung) ähneln, finden Sie unter AWS Mainframe Modernization Service (Self-Managed Experience). Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter Änderung der Verfügbarkeit von [AWS Mainframe Modernization](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html). Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Tutorial: Code von Assembler nach COBOL konvertieren in AWS Mainframe Modernization Sie können dieses Dokument als step-by-step Leitfaden verwenden, um zu verstehen, wie der Assembler-Code für die Mainframe-Modernisierung nach COBOL konvertiert wird. Darüber hinaus finden Sie im [Workshop Automatisierte Codekonvertierung von Assembler zu COBOL](https://catalog.workshops.aws/awsm2ccm-assembler-cobol/en-US) weitere Informationen über den Konvertierungsprozess. **Contents** + [Voraussetzungen](#tutorial-assembler-conversion-prerequisites) + [Schritt 1: Teilen Sie die Build-Assets mit AWS-Konto](#tutorial-assembler-conversion-share-assets) + [Schritt 2: Amazon S3 S3-Buckets erstellen](#tutorial-assembler-conversion-create-bucket) + [Schritt 3: IAM-Richtlinie erstellen](#tutorial-assembler-conversion-IAM-policy) + [Schritt 4: Erstellen Sie eine IAM-Rolle](#tutorial-assembler-conversion-IAM-role) + [Schritt 5: Hängen Sie die IAM-Richtlinie an die IAM-Rolle an](#tutorial-assembler-conversion-attach) + [Schritt 6: Erstellen Sie das CodeBuild Projekt](#tutorial-assembler-conversion-create-project) + [Schritt 6.1: Erstellen Sie das Define-Projekt](#tutorial-conversion-define-project) + [Schritt 6.2: Erstellen Sie das Codeanalyse-Projekt](#tutorial-conversion-analysis-project) + [Schritt 6.3: Erstellen Sie das Code-Konvertierungsprojekt](#tutorial-conversion-code-project) + [Schritt 7: Definieren Sie das Projekt und laden Sie den Quellcode hoch](#tutorial-assembler-conversion-define-upload) + [Schritt 8: Führen Sie die Analyse durch und verstehen Sie die Berichte](#tutorial-assembler-conversion-run-analysis) + [Schritt 9: Führen Sie die Codekonvertierung aus](#tutorial-assembler-conversion-run-code) + [Schritt 10: Überprüfen Sie die Codekonvertierung](#tutorial-assembler-conversion-verify) + [Schritt 11: Laden Sie den konvertierten Code herunter](#tutorial-assembler-conversion-download) + [Bereinigen von Ressourcen](#tutorial-assembler-conversion-clean-resources) ## Voraussetzungen Lesen Sie den [Verstehen Sie die Abrechnung der Codekonvertierung für die Assembler-Konvertierung](assembler-conversion-billing.md) Abschnitt, um zu erfahren, wie die Assembler-Codekonvertierung Gebühren (Abrechnungsberichte) für Sie AWS Account Management generiert und wie die Abrechnung funktioniert. ## Schritt 1: Teilen Sie die Build-Assets mit AWS-Konto Stellen Sie in diesem Schritt sicher, dass Sie die Build-Assets mit Ihnen teilen AWS-Konto, insbesondere in der Region, in der die Assets verwendet werden. 1. Öffnen Sie die AWS Mainframe Modernization Konsole unter [https://console.aws.amazon.com/m2/](https://us-west-2.console.aws.amazon.com/m2/home?region=us-west-2#/). 1. Wählen Sie in der linken Navigationsleiste **Tools** aus. 1. Wählen Sie in **AWS Mainframe Modernization Code Conversion with mLogica** die Option **Share assets with my**. AWS-Konto **Wichtig** Sie müssen diesen Schritt in jeder AWS Region, in der Sie Builds durchführen möchten, einmal ausführen. ## Schritt 2: Amazon S3 S3-Buckets erstellen In diesem Schritt erstellen Sie Amazon S3 S3-Buckets. Der erste Bucket ist der Projekt-Bucket AWS CodeBuild , in dem der Quellcode gespeichert wird, und dann wird der Ausgabe-Bucket verschoben, um die AWS CodeBuild Ausgabe (konvertierten Code) aufzunehmen. Weitere Informationen finden Sie unter [Erstellen, Konfigurieren und Arbeiten mit Amazon S3 S3-Buckets](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html) im *Amazon S3 S3-Benutzerhandbuch*. 1. Um den Projekt-Bucket zu erstellen, melden Sie sich bei der Amazon S3 S3-Konsole an und wählen Sie **Create Bucket** aus. 1. Geben Sie in der **allgemeinen Konfiguration** einen Namen für den Bucket ein und geben Sie an AWS-Region , wo Sie den Bucket erstellen möchten. Ein Beispielname ist`codebuild-regionId-accountId-bucket`, wobei: + `regionId`ist der AWS-Region des Buckets. + `accountId`ist deine AWS-Konto ID. **Anmerkung** Wenn Sie den Bucket in einer anderen Region als USA AWS-Region Ost (Nord-Virginia) erstellen, geben Sie den `LocationConstraint` Parameter an. Weitere Informationen finden Sie unter [Create Bucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html) in der *Amazon Simple Storage Service API-Referenz*. 1. Behalten Sie alle anderen Einstellungen bei und wählen Sie **Create Bucket**. Welche Namen Sie auch immer für diese Buckets wählen, achten Sie darauf, sie in diesem Tutorial zu verwenden. ## Schritt 3: IAM-Richtlinie erstellen In diesem Schritt erstellen Sie eine [IAM-Richtlinie](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html). Die bereitgestellte IAM-Richtlinie gewährt spezifische Berechtigungen AWS CodeBuild für die Interaktion mit Amazon S3, Amazon Elastic Container Registry, CodeBuild generierten [ CloudWatch Amazon-Protokollen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/WhatIsCloudWatchLogs.html) und Amazon Elastic Compute Cloud Ressourcen für die Codekonvertierung. Diese Richtlinie ist nicht auf Kunden zugeschnitten. Die Richtlinie gewährt Berechtigungen zur Interaktion und AWS Mainframe Modernization zum Abrufen der Statistiken zur Code-Konvertierung, um dem Kunden eine angemessene Rechnung zu stellen. Weitere Informationen zum Erstellen einer IAM-Richtlinie finden Sie unter [Erstellen von IAM-Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) im *IAM-Benutzerhandbuch*. **So erstellen Sie eine Richtlinie** 1. Melden Sie sich bei der IAM-Konsole an und wählen Sie im linken Navigationsbereich **Richtlinien** aus. 1. Wählen Sie **Richtlinie erstellen** aus. 1. Kopieren Sie die folgende JSON-Richtlinie und fügen Sie sie in den Richtlinien-Editor 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" } ] } ``` ------ 1. 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, nachzuverfolgen oder zu kontrollieren. 1. Klicken Sie auf **Next:Review** (Weiter: Prüfen). 1. Geben Sie einen Namen für die Richtlinie ein, z. B. `CodeBuildAWSM2CCMPolicy` 1. Sie können optional eine Beschreibung für die Richtlinie eingeben und die Richtlinienübersicht überprüfen, um sicherzustellen, dass sie korrekt ist. 1. Wählen Sie **Richtlinie erstellen** aus. ## Schritt 4: Erstellen Sie eine IAM-Rolle In diesem Schritt erstellen Sie eine neue [IAM-Rolle](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html), mit der Sie für Sie mit AWS Ressourcen interagieren können CodeBuild , nachdem Sie die zuvor erstellten IAM-Richtlinien mit dieser neuen IAM-Rolle verknüpft haben. *Informationen zum Erstellen einer Servicerolle finden Sie unter [Creating a Role to Delegate Permissions to an AWS Service im IAM-Benutzerhandbuch](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html).* 1. Melden Sie sich bei der IAM-Konsole an und wählen Sie im linken **Navigationsbereich Rollen** aus. 1. Wählen Sie **Rolle erstellen** aus. 1. Wählen Sie unter **Vertrauenswürdiger Entitätstyp** die Option **AWS-Service** aus. 1. Wählen **Sie unter Anwendungsfälle für andere AWS-Services** die Option aus **CodeBuild**, und wählen Sie dann **CodeBuild**erneut. 1. Wählen Sie **Weiter** aus. 1. 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. 1. Geben Sie unter **Rollendetails** einen Namen für die Rolle ein, `IAMRoleTaskExecutionRoleForCodeBuild` z. B. 1. Stellen **Sie unter Vertrauenswürdige Entitäten auswählen** sicher, dass das Richtliniendokument wie folgt aussieht: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "codebuild.amazonaws.com" }, "Action": "sts:AssumeRole" } ] } ``` ------ 1. Wählen Sie **Rolle erstellen** aus. ## Schritt 5: Hängen Sie die IAM-Richtlinie an die IAM-Rolle an In diesem Schritt fügen Sie die IAM-Richtlinie, die Sie zuvor erstellt haben, der `IAMRoleTaskExecutionRoleForCodeBuild` IAM-Rolle hinzu. 1. Melden Sie sich bei der IAM-Konsole an und wählen Sie im linken **Navigationsbereich Rollen** aus. 1. Wählen Sie **unter Rollen** die Rolle aus, die Sie zuvor erstellt haben, `IAMRoleTaskExecutionRoleForCodeBuild` z. B. 1. Wählen Sie unter **Berechtigungsrichtlinien die** Option **Berechtigungen hinzufügen** und dann **Richtlinien anhängen** aus. 1. Wählen Sie **unter Andere Berechtigungsrichtlinien** die Richtlinien aus, die Sie zuvor erstellt haben, `CodeBuildAWSM2CCMPolicy` z. B. 1. Wählen Sie **Richtlinien anfügen**. ## Schritt 6: Erstellen Sie das CodeBuild Projekt In diesem Schritt erstellen Sie drei verschiedene CodeBuild Projekte auf der Grundlage der oben genannten `buildspec.yml` Datei. ### Schritt 6.1: Erstellen Sie das Define-Projekt **Um das Define-Projekt zu erstellen** 1. Melden Sie sich bei der CodeBuild Konsole an und wählen Sie **Create build project** aus. 1. Geben Sie im Abschnitt **Projektkonfiguration** einen Namen für das Projekt ein, `1-awsm2ccm-define-project` z. B. 1. Behalten Sie im Abschnitt **Quelle** **für Quellanbieter** die Standardauswahl bei. 1. Wählen Sie im Abschnitt **Umgebung** die Option **Benutzerdefiniertes Bild** aus. 1. Wählen Sie im Feld **Umgebungstyp** die Option **Linux** aus. 1. Wählen Sie unter **Image-Registrierung** die Option **Andere Registrierung** aus. 1. Folgen Sie im Feld **Externe Registrierungs-URL** dem [AWS Mainframe Modernization Container](assembler-conversion-components-process.md#assembler-conversion-components-container) Abschnitt. 1. Wählen Sie unter **Servicerolle** die Option **Bestehende Servicerolle** aus und wählen Sie im Feld **Rollen-ARN** die Servicerolle aus, die Sie zuvor erstellt haben (z. B.`IAMRoleTaskExecutionRoleForCodeBuild`). 1. Erweitern Sie den Abschnitt **Zusätzliche Konfiguration** und gehen Sie wie folgt vor: 1. VPC: Konfigurieren Sie bei Bedarf basierend auf Ihrem Setup. 1. Timeout: Auf **60** Minuten eingestellt. 1. **Timeout in der Warteschlange: Auf 480 Minuten eingestellt.** 1. Verschlüsselung: Wählen Sie die entsprechenden Verschlüsselungseinstellungen (Standard ist in Ordnung). 1. 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**. Wert:. `define_project` Typ: **Klartext** + Name: **AWSM2CCM\_LOGGING\_BUCKET**. `s3:// codebuild-regionId-accountId-bucket`Wert:. Typ: **Klartext** 1. **Wählen Sie im Abschnitt **Buildspec** die Option **Build-Befehle einfügen** und dann Zum Editor wechseln aus.** 1. Ersetzen Sie die aktuellen Werte durch Folgendes: ``` 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 innerhalb verfügbar sind. CodeBuild Weitere Informationen finden Sie unter [Umgebungsvariablen in Build-Umgebungen](https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-env-vars.html). 1. Gehen Sie im Abschnitt **Artefakte** wie folgt vor: + Wählen Sie unter **Typ** die Option **Amazon S3** und dann Ihren Ausgabe-Bucket aus, zum Beispiel`codebuild-regionId-accountId-bucket`. + Lassen Sie dieses Feld für **Pfad** leer. + Geben Sie für **Name** ein`prj_codebuild_01`. + Wählen Sie für **Artefaktverpackungen** die Option **Keine** aus. + deaktivieren Sie **diese Option für „Artefaktname überschreiben**“. + Belassen Sie für **Verschlüsselung** die Standardeinstellungen. 1. Gehen Sie für den Abschnitt **Protokolle** wie folgt vor: + CloudWatch Protokolle: **Deaktiviert** + S3-Protokolle: **Aktiviert** + Bucket: `codebuild-regionId-account-bucket` + Protokollpfad: `CODEBUILD-LOGS` 1. Wählen Sie **Create build project (Build-Projekt erstellen)** aus. ### Schritt 6.2: Erstellen Sie das Codeanalyse-Projekt **Um das Codeanalyse-Projekt zu erstellen** 1. Melden Sie sich bei der CodeBuild Konsole an und wählen Sie **Build-Projekt erstellen** aus. 1. Geben Sie im Abschnitt **Projektkonfiguration** einen Namen für das Projekt ein, `2-awsm2ccm-analysis` z. B. 1. Wählen Sie im Abschnitt **Quelle** für **Quellanbieter** **Amazon S3** und dann den Eingabe-Bucket aus, den Sie zuvor erstellt haben (z. B.`codebuild-regionId-accountId-bucket`). 1. Geben Sie im Feld **S3-Objektschlüssel** oder **S3-Ordner** Folgendes ein`prj_codebuild_01`. 1. Wählen Sie im Bereich **Umgebung** die Option **Benutzerdefiniertes Bild** aus. 1. Wählen Sie im Feld **Umgebungstyp** die Option **Linux** aus. 1. Wählen Sie unter **Image-Registrierung** die Option **Andere Registrierung** aus. 1. Folgen Sie im Feld **Externe Registrierungs-URL** dem [AWS Mainframe Modernization Container](assembler-conversion-components-process.md#assembler-conversion-components-container) Abschnitt. 1. Wählen Sie unter **Servicerolle** die Option **Bestehende Servicerolle** aus und wählen Sie im Feld **Rollen-ARN** die Servicerolle aus, die Sie zuvor erstellt haben (z. B.`IAMRoleTaskExecutionRoleForCodeBuild`). 1. Erweitern Sie den Abschnitt **Zusätzliche Konfiguration** und gehen Sie wie folgt vor: 1. VPC: Konfigurieren Sie bei Bedarf basierend auf Ihrem Setup. 1. Timeout: Auf **60** Minuten eingestellt. 1. **Timeout in der Warteschlange: Auf 480 Minuten eingestellt.** 1. Verschlüsselung: Wählen Sie die entsprechenden Verschlüsselungseinstellungen (Standard ist in Ordnung). 1. 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**. Wert:. `analysis` Typ: **Klartext** + Name: **AWSM2CCM\_LOGGING\_BUCKET**. `s3:// codebuild-regionId-accountId-bucket`Wert:. Typ: **Klartext** 1. **Wählen Sie im Abschnitt **Buildspec** die Option **Build-Befehle einfügen** und dann Zum Editor wechseln aus.** 1. 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 innerhalb verfügbar sind. CodeBuild Weitere Informationen finden Sie unter [Umgebungsvariablen in Build-Umgebungen](https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-env-vars.html). 1. Gehen Sie im Abschnitt **Artefakte** wie folgt vor: + Wählen Sie unter **Typ** die Option **Amazon S3** und dann Ihren Ausgabe-Bucket aus (z. B.`codebuild-regionId-accountId-bucket`). + Geben Sie als **Pfad** **ARTIFACTS** ein. + Geben Sie als **Namen** ein`prj_codebuild_01`. + Wählen Sie für **Artefaktverpackungen** die Option **Keine** aus. + deaktivieren Sie **diese Option für „Artefaktname überschreiben**“. + Belassen Sie für **Verschlüsselung** die Standardeinstellungen. 1. Gehen Sie für den Abschnitt **Protokolle** wie folgt vor: + CloudWatch Protokolle: **Deaktiviert** + S3-Protokolle: **Aktiviert** + Bucket: `codebuild-regionId-account-bucket` + Protokollpfad: `CODEBUILD-LOGS` 1. Wählen Sie **Create build project (Build-Projekt erstellen)** aus. ### Schritt 6.3: Erstellen Sie das Code-Konvertierungsprojekt **Um das Code-Konvertierungsprojekt zu erstellen** 1. Melden Sie sich bei der CodeBuild Konsole an und wählen Sie **Build-Projekt erstellen** aus. 1. Geben Sie im Abschnitt **Projektkonfiguration** einen Namen für das Projekt ein (z. B.`3-awsm2ccm-convert`). 1. Wählen Sie im Abschnitt **Quelle** für **Quellanbieter** **Amazon S3** und dann den Eingabe-Bucket aus, den Sie zuvor erstellt haben (z. B.`codebuild-regionId-accountId-bucket`). 1. Geben Sie im Feld **S3-Objektschlüssel** oder **S3-Ordner** Folgendes ein`prj_codebuild_01`. 1. Wählen Sie im Bereich **Umgebung** die Option **Benutzerdefiniertes Bild** aus. 1. Wählen Sie im Feld **Umgebungstyp** die Option **Linux** aus. 1. Wählen Sie unter **Image-Registrierung** die Option **Andere Registrierung** aus. 1. Folgen Sie im Feld **Externe Registrierungs-URL** dem [AWS Mainframe Modernization Container](assembler-conversion-components-process.md#assembler-conversion-components-container) Abschnitt. 1. Wählen Sie unter **Servicerolle** die Option **Bestehende Servicerolle** und wählen Sie im Feld **Rollen-ARN** die Servicerolle aus, die Sie zuvor erstellt haben, z. B.`IAMRoleTaskExecutionRoleForCodeBuild`. 1. Erweitern Sie den Abschnitt **Zusätzliche Konfiguration** und gehen Sie wie folgt vor: 1. VPC: Konfigurieren Sie bei Bedarf basierend auf Ihrem Setup. 1. Timeout: Auf **60** Minuten eingestellt. 1. **Timeout in der Warteschlange: Auf 480 Minuten eingestellt.** 1. Verschlüsselung: Wählen Sie die entsprechenden Verschlüsselungseinstellungen (Standard ist in Ordnung). 1. 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**. Wert:. `conversion` Typ: **Klartext** + Name: **AWSM2CCM\_LOGGING\_BUCKET**. `s3:// codebuild-regionId-accountId-bucket`Wert:. Typ: **Klartext** 1. **Wählen Sie im Abschnitt **Buildspec** die Option **Build-Befehle einfügen** und dann Zum Editor wechseln aus.** 1. Ersetzen Sie die aktuellen Werte durch Folgendes: ``` 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 innerhalb verfügbar sind. CodeBuild Weitere Informationen finden Sie unter [Umgebungsvariablen in Build-Umgebungen](https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-env-vars.html). 1. Gehen Sie im Abschnitt **Artefakte** wie folgt vor: + Wählen Sie unter **Typ** die Option **Amazon S3** und dann Ihren Ausgabe-Bucket aus (z. B.`codebuild-regionId-accountId-bucket`). + Geben Sie als **Pfad** **ARTIFACTS** ein. + Geben Sie als **Namen** ein`prj_codebuild_01`. + Wählen Sie für **Artefaktverpackungen** die Option **Keine** aus. + deaktivieren Sie **diese Option für „Artefaktname überschreiben**“. + Belassen Sie für **Verschlüsselung** die Standardeinstellungen. 1. Gehen Sie für den Abschnitt **Protokolle** wie folgt vor: + CloudWatch Protokolle: **Deaktiviert** + S3-Protokolle: **Aktiviert** + Bucket: `codebuild-regionId-account-bucket` + Protokollpfad: `CODEBUILD-LOGS` 1. Wählen Sie **Create build project (Build-Projekt erstellen)** aus. ## Schritt 7: Definieren Sie das Projekt und laden Sie den Quellcode hoch Das Define Project richtet den Projektordner und die Konfigurationsdateien ein, die mit Standardkonfigurationen initialisiert wurden. In diesem Schritt starten Sie den Build. So gehen Sie vor: 1. Loggen Sie sich in die AWS CodeBuild Konsole ein. 1. Wählen Sie im linken Navigationsbereich **Projekte erstellen** aus. 1. Wählen Sie das zuvor erstellte Projekt (`1-awsm2ccm-define-project`) zum Erstellen aus 1. 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*. 1. Wählen Sie „**Phasendetails**“, um den Fortschritt der einzelnen Schritte zu sehen, die vom AWS CodeBuild Projekt orchestriert werden. 1. Warten Sie, bis sich der Status für alle Schritte auf **erfolgreich** geändert hat. 1. Gehen Sie zur Amazon S3 S3-Konsole. 1. Suchen Sie den Amazon S3 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 in den Schritten Analyse, expand\_macros und Convert verwendet. Sie können wählen`prj_codebuild_01/`, ob Sie Details untersuchen möchten + **`cobol_reserved.rsw`**Konfigurationsdatei (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.json`**Die Konfigurationsdatei enthält eine benutzerdefinierte Makro-Ersetzung. Sie wird während des Schritts expand\_macros verwendet. + **`macrolib/`**Der Ordner enthält die zu konvertierenden Assembler-Makros. Er wird während des Analyse- und Konvertierungsschritts verwendet. 1. Wählen Sie `macrolib/`. 1. 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. 1. Laden Sie Ihre Makros in dieses Verzeichnis hoch. + **`project_settings_aux.json`**Die Konfigurationsdatei enthält Einstellungen, die sich auf die Codepage beziehen. Sie wird während des Konvertierungsschritts verwendet. + **`project_settings.json`**Die 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. Er wird während des Analyse- und Konvertierungsschritts verwendet. 1. Wählen Sie `srclib/`. 1. Standardmäßig sind zwei Assembler-Programme benannt `SQtest01.asm` und `SQtest02.asm` werden als Beispiele bereitgestellt. Löschen Sie diese Dateien, da sie für Ihre Analyse und Konvertierung nicht benötigt werden. 1. Laden Sie Ihre Assembler-Programme in dieses Verzeichnis hoch. 1. Überprüfen Sie den Status für `1-awsm2ccm-define-project` Schritt. Der Vorgang sollte auf der Registerkarte **Neuester Build-Status** erfolgreich gewesen sein. Sie sind bereit für den nächsten Schritt: die **Codeanalyse**. ## Schritt 8: Führen Sie die Analyse durch und verstehen Sie die Berichte **Anmerkung** AWS Mainframe Modernization Der Schritt *zur Analyse* der Codekonvertierung ist kostenlos. In diesem Schritt starten Sie einen weiteren Build: 1. **Wählen Sie im linken Navigationsbereich die Option Projekte erstellen aus.** 1. Wählen Sie das Projekt aus, das Sie in Schritt 6.2 erstellt haben, um Folgendes zu erstellen:`2-awsm2ccm-analysis`. 1. Wählen Sie **Build starten** und dann **Jetzt starten** aus, um Analyseberichte zu generieren. Dadurch wird der Build gestartet und der Status wird auf *In Bearbeitung* geändert. 1. 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 auf *erfolgreich* ändert. 1. Gehen Sie von der AWS-Managementkonsole zur Amazon S3 S3-Servicekonsole. 1. Suchen Sie den Amazon S3 S3-Bucket und klicken Sie darauf: `codebuild-regionId-accountId-bucket` 1. **`ARTIFACTS/`**Der Ordner enthält die Ergebnisse der *Analyse* - und *Konvertierungsschritte*. 1. Wählen Sie `ARTIFACTS/prj_codebuild_01/_Reports/`. 1. Die folgenden Berichte werden verfügbar sein: + `AWSM2CCM-Analysis-Report-.pdf`ist ein Bericht für Führungskräfte, der Aufschluss über die Abrechnung und den Umfang der AWS Mainframe Modernization Code-Konvertierung gibt. Außerdem verbessert er die Konversionsrate, die Konversionsübersicht und die detaillierten Konversionsstatistiken. Er fasst auch die Anzahl der Codes und die Anzahl der abrechnungsfähigen Codes auf Projektebene zusammen und enthält Kennzahlen und Listen der referenzierten Mitglieder für jede Komponente. Es ist wichtig, diesen Bericht vor der eigentlichen Konvertierung auszuführen und zu prüfen. + `Conversion_Detailed_Statistics.txt`enthält die Häufigkeit und das erwartete Konvertierungsergebnis (angezeigt als „Konvertierungsstatus“) für jede Anweisung, die in jeder Komponente gefunden wurde. Auf diese Weise kann schnell festgestellt werden, 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. + **Anweisungen zur Überprüfung vor der Kompilierung**: Diese sind normalerweise in den Makros enthalten und beziehen sich auf Befehle, 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 Instruktionen oder Direktiven gesteuert wird, sauberen/statischen ASM-Code auswählt und erzeugt.* Diese Anweisungen hängen von den tatsächlichen Werten der Makroparameter ab, die kompiliert werden. Daher kann dasselbe Makro je nach den Werten der übergebenen Parameter unterschiedliche 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.txt`bietet eine Zusammenfassung des *Konvertierungsstatus* auf Komponentenebene. + `CrossReference_PgmToCpyMacro.txt`berichtet über die Abhängigkeiten von Assembler-Programmen von Makros. Es bietet eine schnelle Methode, um festzustellen, ob Makros im hochgeladenen Code fehlen. + `CrossReference_PgmToPgm.txt`berichtet über Abhängigkeiten von Assembler-Programmen von anderen Assembler-Programmen. Es bietet eine schnelle Methode, um festzustellen, ob Assembler-Programme im hochgeladenen Code fehlen. 1. Kehren Sie zur AWS CodeBuild Servicekonsole zurück. 1. Überprüfen Sie den Status für den **2-awsm2ccm-Analyseschritt**. **Der Vorgang sollte auf der Registerkarte Neuester **Build-Status erfolgreich** gewesen sein.** Sie sind bereit für den nächsten Schritt: **Codekonvertierung**. ## Schritt 9: Führen Sie die Codekonvertierung aus **Wichtig** AWS Mainframe Modernization Der Schritt zur *Code-Konvertierung* wird je nach Nutzung in Rechnung gestellt. Weitere Informationen zur Fakturierung finden Sie unter [Verstehen Sie die Abrechnung der Codekonvertierung für die Assembler-Konvertierung](assembler-conversion-billing.md). In diesem Schritt konfigurieren Sie den Konvertierungsprozess und starten dann den Build. 1. Gehen Sie von der AWS-Managementkonsole zum Amazon S3 S3-Service. 1. Suchen Sie den Amazon S3 S3-Bucket und klicken Sie darauf:`codebuild-regionId-accountId-bucket`. 1. Wechseln Sie zu `prj_codebuild_01/`. 1. Wählen Sie `project_settings.json` und wählen Sie **Herunterladen**. 1. Ö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. + **Quellverzeichnis CopyBooks/Macros: enthält die Assembler-Makros** und Copybooks, die für die Konvertierung benötigt werden. + Die Konvertierung von **Copybooks/Macros** kann entweder erfolgen: + **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 gibt an, 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 neu generieren, wenn es bereits vorhanden ist Copy/Macro . Wenn dies zutrifft, konvertiert das Tool das CopyBook/das Makro nicht erneut, wenn es bereits konvertiert wurde (im Ausgabeordner vorhanden ist). + **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: *Big* (für Big-Endian)/Little (Little-Endian). Zum Beispiel ist IBM z/OS Mainframe Big-Endian, Windows ist Little-Endian, Linux ist je nach Distribution unterschiedlich (z. B. Amazon Linux 2 auf EC2 ist Little-Endian). + Bitanzahl: 32/64 (wenn nicht angegeben, ist der Standardwert 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 erkennt. + **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. + Erweiterung „**Konvertierte Copybooks/Macros“: 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 Ablaufverfolgungsstufe + **Modus zum Öffnen der Trace-Datei**: Wird nicht verwendet. Die Standardeinstellung „*Append*“ wird empfohlen. + **Datendefinitionsebene**: Dies gibt die Anfangsebene der Unterfelder (nach der Ebene „01“) an, die im Bereich Working-Storage und Linkage definiert sind. Muss eine Zahl sein. + **Spalte mit dem Startbild**: Hier geht es um das Format des generierten COBOL-Codes und gibt die Spalte an, in der die *PIC-Klausel* steht (nach den Feldnamen). Muss eine Zahl sein. + **Platzierung der ursprünglichen Quelle:** Dies gibt die Position an, an der die Kommentare im Programm platziert wurden. Es gibt zwei Optionen: + **RECHTS**: Diese Option platziert den Kommentar oder die zusätzlichen Informationen an der richtigen Position nach der dreiundsiebzigsten (73) Spalte. 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**: Mit 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 im Speicher (Assembler-Datentypen „H“, „F“, „D“, die in den COBOL-Datentyp „COMP“ konvertiert werden). Um die korrekte *Ausrichtungsgrenze* zu gewährleisten, werden während der Konvertierung explizite *Füllfelder* hinzugefügt. Dies ist eine textbasierte Option, der Wert muss eine Zeichenfolge sein (wie FILL-SYNC). + **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 „SPECIAL-NAMES*“ hinzugefügt. 1. Ändern Sie entsprechend Ihren Anforderungen die entsprechenden Parameter und speichern Sie dann die. `project_settings.json` 1. Entfernen Sie die vorhandene `project_settings.json` Datei aus `prj_codebuild_01/` dem Amazon S3 S3-Bucket und laden Sie dann die neue Version hoch. 1. Gehen Sie zurück zum AWS CodeBuild Service. 1. Wählen Sie das 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. 1. Warten Sie, bis sich der Build-Status für dieses Projekt auf **Erfolgreich** geändert hat. Es wird auf der Registerkarte **Neuester Build-Status** angezeigt. ## Schritt 10: Überprüfen Sie die Codekonvertierung 1. Gehen Sie vom AWS-Managementkonsole zum Amazon S3 S3-Service. 1. Suchen Sie den Amazon S3 S3-Bucket und klicken Sie darauf:`codebuild-regionId-accountId-bucket`. 1. Navigieren Sie zu **`awsm2ccm-do-not-delete `**. AWS Mainframe Modernization Bei der Codekonvertierung werden während des Konvertierungsvorgangs kodierte Binärdateien für jedes Assembler- oder Macro-Modul erstellt. Diese Dateien sind wichtig, um doppelte Rechnungen an die Kunden zu vermeiden und um nachzuverfolgen, wie viel des bereitgestellten Assembler-Codes analysiert und konvertiert wurde. Dateien werden am folgenden Ort gespeichert:`codebuild-regionId-accountId- bucket/awsm2ccm-do-not-delete//Hash`. Die codierten Dateien enthalten keinen Assembler-Code und es ist auch nicht möglich, Kundencode aus diesen Dateien zu extrahieren. **Wichtig** Sie können diese Dateien auch nicht manuell bearbeiten oder löschen. Das Bearbeiten oder Löschen dieser Dateien kann zu mehreren Fakturierungen für dieselben Komponenten führen. Behandeln Sie den **`awsm2ccm-do-not-delete/`**Ordner wie ein vom System verwaltetes Verzeichnis. Konsultieren Sie, Support bevor Sie Änderungen an diesem Verzeichnis oder seinem Inhalt vornehmen. 1. Klicken Sie hier`codebuild-regionId-accountId-bucket`, um zum Bucket zurückzukehren. 1. Wähle **`ARTIFACTS/prj_codebuild_01/`**. Der Ordner **\_Converted/** enthält die als Ergebnis des Codekonvertierungsschritts generierten COBOL-Ausgaben. 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. 1. **Wenn aus den *Analyseberichten und anderen Berichten* hervorgeht, dass die Konvertierung erfolgreich war und das AWS CodeBuild Projekt als Erfolgreich markiert `3-awsm2ccm-convert` ist, laden Sie den COBOL-Code und die **Copybooks** aus dem Verzeichnis \_Converted/ herunter.** ## Schritt 11: Laden Sie den konvertierten Code herunter Laden Sie in diesem Schritt den COBOL-Code und die Copybooks aus dem Verzeichnis **\_Converted/** herunter und kompilieren Sie sie in der COBOL-Zielumgebung. 1. Gehen Sie vom AWS-Managementkonsole zum Amazon S3 S3-Service. 1. Suchen Sie den Amazon S3 S3-Bucket und klicken Sie darauf:`codebuild-regionId-accountId-bucket`. 1. Navigieren Sie zum Standort:` ARTIFACTS/prj_codebuild_01/_Converted/`. 1. **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 ``` 1. Analysieren und kompilieren Sie das konvertierte COBOL in der COBOL-Zielumgebung. ## Bereinigen von Ressourcen Wenn Sie die Ressourcen, die Sie für dieses Tutorial erstellt haben, nicht mehr benötigen, löschen Sie sie, um zusätzliche Kosten zu vermeiden. Führen Sie dazu die folgenden Schritte aus: + Löschen Sie die S3-Buckets, die Sie für dieses Tutorial erstellt haben. Weitere Informationen finden Sie unter [Löschen eines Buckets](https://docs.aws.amazon.com/AmazonS3/latest/userguide/delete-bucket.html) im *Amazon Simple Storage Service-Benutzerhandbuch*. + Löschen Sie die IAM-Richtlinien, die Sie für dieses Tutorial erstellt haben. Weitere Informationen finden Sie unter [Löschen von IAM-Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-delete.html) im *IAM-Benutzerhandbuch*. + Löschen Sie die IAM-Rolle, die Sie für dieses Tutorial erstellt haben. Weitere Informationen finden Sie unter [Löschen von Rollen oder Instanzprofilen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_delete.html) im *IAM-Benutzerhandbuch*. + Löschen Sie das CodeBuild Projekt, das Sie für dieses Tutorial erstellt haben. Weitere Informationen finden Sie [ CodeBuildim *AWS CodeBuild Benutzerhandbuch* unter Löschen eines Build-Projekts](https://docs.aws.amazon.com/codebuild/latest/userguide/delete-project.html).