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.

# Umplattformierung von Anwendungen mit Rocket Software (ehemals Micro Focus)
<a name="replatforming-m2"></a>

Dieses Handbuch behandelt den end-to-end Prozess der Plattformumgestaltung von Mainframe-Anwendungen mithilfe von AWS Mainframe-Modernisierungslösungen auf. AWS Es beschreibt alle Aufgaben und enthält Informationen zur Konfiguration und zum Betrieb der AWS Mainframe Modernization Runtime auf Amazon EC2, von der Ersteinrichtung und Analyse bis hin zum Erstellen, Testen und Bereitstellen Ihrer modernisierten Anwendungen auf. AWS Es behandelt auch fortgeschrittene Themen wie die Arbeit mit älteren Datenstrukturen, die Verwendung von Vorlagen und vordefinierten Projekten und die Einrichtung der Automatisierung für Streaming-Sitzungen. 

**Topics**
+ [Rocket Software (ehemals Micro Focus) einrichten (auf Amazon EC2)](mf-runtime-setup.md)
+ [Richten Sie die Automatisierung für Rocket Enterprise Analyzer (ehemals Micro Focus) und Rocket Enterprise Developer Streaming-Sitzungen ein](set-up-automation-m2.md)
+ [Datensätze in Rocket Enterprise Developer (ehemals Micro Focus Enterprise Developer) als Tabellen und Spalten anzeigen](view-datasets-tables-m2.md)
+ [Bearbeiten Sie Datensätze mit den Datendatei-Tools von Rocket Software (ehemals Micro Focus) in Enterprise Developer](edit-datasets-m2.md)
+ [Tutorials für Rocket Software (ehemals Micro Focus)](tutorials-mf.md)
+ [Verfügbare Batch-Dienstprogramme in AWS Mainframe Modernization](utilities-m2.md)

# Rocket Software (ehemals Micro Focus) einrichten (auf Amazon EC2)
<a name="mf-runtime-setup"></a>

AWS Mainframe Modernization bietet mehrere Amazon Machine Images (AMIs), die von Rocket Software (ehemals Micro Focus) lizenzierte Produkte enthalten. Mit diesen AMIs können Sie schnell Amazon Elastic Compute Cloud (Amazon EC2) -Instances bereitstellen, um Rocket Software-Umgebungen zu unterstützen, die Sie kontrollieren und verwalten. Dieses Thema enthält die Schritte, die erforderlich sind, um auf diese AMIs zuzugreifen und sie zu starten. Ihre Verwendung AMIs ist völlig optional und sie sind nicht erforderlich, um die Tutorials in diesem Benutzerhandbuch abzuschließen.

**Topics**
+ [Voraussetzungen für die Einrichtung von Rocket Software (ehemals Micro Focus) (auf Amazon EC2)](mf-runtime-setup-prereq.md)
+ [Erstellen Sie den Amazon VPC-Endpunkt für Amazon S3](mf-runtime-setup-vpc.md)
+ [Fordern Sie die Aktualisierung der Zulassungsliste für das Konto an](mf-runtime-setup-allowlist.md)
+ [Erstellen Sie die AWS Identity and Access Management Rolle](mf-runtime-setup-iam-role.md)
+ [Gewähren Sie License Manager die erforderlichen Berechtigungen](mf-runtime-setup-lic.md)
+ [Abonnieren Sie die Amazon Machine Images](mf-runtime-setup-ami.md)
+ [Starten Sie eine AWS Mainframe Modernization Instanz von Rocket Software (ehemals Micro Focus)](mf-runtime-setup-mf-instance.md)
+ [Subnetz oder VPC ohne Internetzugang](mf-runtime-setup-no-access.md)

# Voraussetzungen für die Einrichtung von Rocket Software (ehemals Micro Focus) (auf Amazon EC2)
<a name="mf-runtime-setup-prereq"></a>

Wenn Sie Rocket Software (auf Amazon EC2) einrichten, stellen Sie sicher, dass Sie die folgenden Voraussetzungen erfüllen.
+ Administratorzugriff auf das Konto, in dem die Amazon EC2 EC2-Instances erstellt werden.
+ Identifizieren Sie den AWS-Region Ort, an dem die Amazon EC2 EC2-Instances erstellt werden, und überprüfen Sie, ob der AWS Mainframe Modernization Service verfügbar ist. Weitere Informationen finden Sie unter [AWS Services nach Regionen.](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/) Stellen Sie sicher, dass Sie eine Region auswählen, in der der Service verfügbar ist.
+ Identifizieren Sie die Amazon Virtual Private Cloud (Amazon VPC), in der die Amazon EC2 EC2-Instances erstellt werden.

# Erstellen Sie den Amazon VPC-Endpunkt für Amazon S3
<a name="mf-runtime-setup-vpc"></a>

In diesem Abschnitt erstellen Sie einen Amazon VPC-Endpunkt, den Amazon S3 verwenden kann. Die Einrichtung dieses Endpunkts hilft Ihnen später bei der Einrichtung des Internetzugangs für VPC. 

1. Navigieren Sie zu Amazon VPC in der AWS-Managementkonsole.

1. Wählen Sie im Navigationsbereich **Endpunkte** aus.

1. Wählen Sie **Endpunkt erstellen** aus.  
![\[VPC-Endpoints mit aktivem Create Endpoint.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-create-s3-endpoint_1.jpg)

1. Geben Sie ein aussagekräftiges Namensschild ein, zum Beispiel: „Micro-Focus-License-S3“.

1. Wählen Sie **AWS-Services** als Servicekategorie.  
![\[Endpunkteinstellungen mit eingegebenem Beispiel-Namens-Tag.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-create-s3-endpoint_2.png)

1. Suchen Sie unter **Services** nach dem Amazon S3 Gateway-Service: **com.amazonaws. [Region] .s3**.

   Denn `us-west-1` das wäre:`com.amazonaws.us-west-1.s3`.

1. Wählen Sie den **Gateway-Service**.  
![\[Dienste mit ausgewähltem Amazon S3 Gateway-Service.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-create-s3-endpoint_3.png)

1. Wählen Sie für VPC die VPC aus, die Sie verwenden werden.  
![\[VPC mit eingegebener VPC.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-create-s3-endpoint_4.png)

1. Wählen Sie alle Routentabellen für die VPC aus.  
![\[Routentabellen mit allen ausgewählten Routentabellen.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-create-s3-endpoint_5.png)

1. Wählen Sie unter **Richtlinie die** Option **Vollzugriff** aus.  
![\[Richtlinie mit Vollzugriff ausgewählt.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-create-s3-endpoint_6.png)
**Anmerkung**  
Wenn Sie sich entscheiden, eine benutzerdefinierte Richtlinie zu erstellen, stellen Sie sicher, dass diese Zugriff auf den Amazon S3 S3-Bucket hat`s3://aws-supernova-marketplace-<region>-prod`.

1. Klicken Sie auf **Endpunkt erstellen**.

# Fordern Sie die Aktualisierung der Zulassungsliste für das Konto an
<a name="mf-runtime-setup-allowlist"></a>

Arbeiten Sie mit Ihrem AWS Vertreter zusammen, um Ihr Konto auf die Zulassungsliste für das zu setzen. AWS Mainframe Modernization AMIs Bitte geben Sie die folgenden Informationen an:
+ Die AWS-Konto ID.
+ Der AWS-Region Ort, an dem der Amazon VPC-Endpunkt erstellt wurde.
+ Die Amazon VPC Amazon S3 S3-Endpunkt-ID, die in [Erstellen Sie den Amazon VPC-Endpunkt für Amazon S3](mf-runtime-setup-vpc.md) erstellt wurde. Dies ist die `vpce-xxxxxxxxxxxxxxxxx` ID für die Datei **com.amazonaws. [Region] .s3-Gateway-Endpunkt**.
+ Die Anzahl der erforderlichen Lizenzen für alle Rocket Software Enterprise Suite AMI Amazon EC2 EC2-Instances.

  Eine Lizenz ist pro CPU-Kern erforderlich (pro 2 vCPUs für die meisten Amazon EC2 EC2-Instances).

  Weitere Informationen finden Sie unter CPU-Optionen [optimieren](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-optimize-cpu.html#cpu-options-compute-optimized).

  Die angeforderte Nummer kann in future von angepasst werden AWS.

**Anmerkung**  
Wenden Sie sich an Ihren AWS Vertreter oder an den Mitarbeiter AWS Support , der in Ihrem Namen das Support-Ticket für die Allowlist-Anfrage öffnet. Es kann nicht direkt von Ihnen angefordert werden und es kann mehrere Tage dauern, bis die Anfrage bearbeitet ist.

# Erstellen Sie die AWS Identity and Access Management Rolle
<a name="mf-runtime-setup-iam-role"></a>

Erstellen Sie eine AWS Identity and Access Management Richtlinie und Rolle, die von den AWS Mainframe Modernization Amazon EC2 EC2-Instances verwendet werden sollen. Wenn Sie die Rolle über die IAM-Konsole erstellen, wird ein zugeordnetes Instance-Profil mit demselben Namen erstellt. Durch die Zuweisung dieses Instance-Profils zu den Amazon EC2 EC2-Instances können Rocket-Softwarelizenzen zugewiesen werden. Weitere Informationen zu Instance-Profilen finden Sie unter [Verwenden einer IAM-Rolle, um Berechtigungen für Anwendungen zu gewähren, die auf Amazon EC2 EC2-Instances ausgeführt](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-ec2.html) werden.

## Eine IAM-Richtlinie erstellen
<a name="mf-runtime-setup-iam-role-policy"></a>

Eine IAM-Richtlinie wird zuerst erstellt und dann an die Rolle angehängt.

1. Navigieren Sie zu AWS Identity and Access Management in der AWS-Managementkonsole.

1. Wählen Sie **Richtlinien** und dann **Richtlinie erstellen** aus.  
![\[Richtlinienseite ohne angewendete Filter.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-create-iam-policy_1.png)

1. Wählen Sie den Tab **JSON**.  
![\[JSON-Tab ohne Inhalt\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-create-iam-policy_2.png)

1. Ersetzen Sie `us-west-1` in der folgenden JSON-Datei die AWS-Region Stelle, an der der Amazon S3 S3-Endpunkt definiert wurde, und kopieren Sie dann die JSON-Datei und fügen Sie sie in den Richtlinien-Editor ein.

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Sid": "S3WriteObject",
               "Effect": "Allow",
               "Action": [
                   "s3:PutObject"
               ],
               "Resource": [
                   "arn:aws:s3:::aws-supernova-marketplace-us-west-1-prod/*"
               ]
           },
           {
               "Sid": "OtherRequiredActions",
               "Effect": "Allow",
               "Action": [
                   "sts:GetCallerIdentity",
                   "ec2:DescribeInstances",
                   "license-manager:ListReceivedLicenses"
               ],
               "Resource": [
                   "*"
               ]
           }
       ]
   }
   ```

------
**Anmerkung**  
Die Aktionen unter der Sid unterstützen `OtherRequiredActions` keine Berechtigungen auf Ressourcenebene und müssen `*` im Ressourcenelement angegeben werden.  
![\[JSON-Tab mit eingegebener Richtlinie und hervorgehobenem us-west-1.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-create-iam-policy_3.png)

1. Wählen Sie **Weiter: Tags** aus.  
![\[Tags, für die keine Daten eingegeben wurden.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-create-iam-policy_4.png)

1. Geben Sie optional beliebige Tags ein und wählen Sie dann **Weiter: Überprüfen**.

1. Geben Sie einen Namen für die Richtlinie ein, zum Beispiel „Micro-Focus-Licensing-Policy“. Geben Sie optional eine Beschreibung ein, zum Beispiel „Eine Rolle, die diese Richtlinie enthält, muss jeder AWS Mainframe Modernization Amazon EC2 EC2-Instance zugewiesen werden.“  
![\[Überprüfen Sie die Richtlinie mit dem eingegebenen Namen und der Beschreibung.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-create-iam-policy_5.png)

1. Wählen Sie **Richtlinie erstellen** aus.

## Erstellen Sie die IAM-Rolle
<a name="mf-runtime-setup-iam-role-create"></a>

Nachdem Sie eine IAM-Richtlinie erstellt haben, erstellen Sie eine IAM-Rolle und fügen sie der Richtlinie hinzu. 

1. Navigieren Sie zu IAM in der. AWS-Managementkonsole

1. Wählen Sie **Rollen** und dann **Rolle erstellen** aus.  
![\[Rollen ohne angewendeten Filter.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-create-iam-role_1.png)

1. Belassen Sie den **Entitätstyp Vertrauenswürdig** als **AWS Dienst** und wählen Sie den allgemeinen **EC2-Anwendungsfall**.  
![\[Wählen Sie vertrauenswürdige Entität aus, bei der AWS Dienst und EC2 ausgewählt sind\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-create-iam-role_2.png)

1. Wählen Sie **Weiter** aus.

1. Geben Sie „Micro“ in den Filter ein und drücken Sie die Eingabetaste, um den Filter anzuwenden.

1. Wählen Sie die Richtlinie, die gerade erstellt wurde, zum Beispiel die „Micro-Focus-Licensing-Policy“. 

1. Wählen Sie **Weiter** aus.  
![\[Fügen Sie Berechtigungen hinzu, wenn die Micro Focus-Richtlinie ausgewählt ist.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-create-iam-role_3.png)

1. Geben Sie den Rollennamen ein, zum Beispiel „Micro-Focus-Licensing-Role“. 

1. Ersetzen Sie die Beschreibung durch eine eigene, zum Beispiel „Erlaubt Amazon EC2 EC2-Instances mit dieser Rolle, Micro Focus-Lizenzen zu erhalten“.   
![\[Rollendetails mit eingegebenem Namen und Beschreibung.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-create-iam-role_4.png)

1. Überprüfen Sie unter **Schritt 1: Vertrauenswürdige Entitäten auswählen** den JSON-Code und stellen Sie sicher, dass er die folgenden Werte hat:

------
#### [ JSON ]

****  

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

------
**Anmerkung**  
Die Reihenfolge von „Effekt“, „Aktion“ und „Prinzipal“ ist nicht signifikant.

1. Vergewissern Sie sich, dass in **Schritt 2: Berechtigungen hinzufügen** Ihre Lizenzierungsrichtlinie angezeigt wird.  
![\[Schritt 2: Fügen Sie Berechtigungen hinzu, wenn die Lizenzrichtlinie ausgewählt ist.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-create-iam-role_6.png)

1. Wählen Sie **Rolle erstellen** aus.

Wenn die Anfrage für die Zulassungsliste abgeschlossen ist, fahren Sie mit den folgenden Schritten fort.

# Gewähren Sie License Manager die erforderlichen Berechtigungen
<a name="mf-runtime-setup-lic"></a>

Sie müssen Ihnen Berechtigungen AWS License Manager zur Einrichtung der Rocket Software Runtime Engine (auf Amazon EC2) erteilen.

1. Navigieren Sie zu AWS License Manager in der AWS-Managementkonsole.  
![\[AWS License Manager Startseite.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-license-manager_1.png)

1. Wählen Sie **Mit AWS License Manager beginnen** aus.

1. Wenn Sie das folgende Pop-up sehen, sehen Sie sich die Details an, aktivieren Sie dann das Kontrollkästchen und klicken Sie auf **Berechtigungen gewähren**.  
![\[Einmalige Einrichtung von IAM-Berechtigungen\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-license-manager_2.png)

# Abonnieren Sie die Amazon Machine Images
<a name="mf-runtime-setup-ami"></a>

Nachdem Sie ein AWS Marketplace Produkt abonniert haben, können Sie eine Instance über das AMI des Produkts starten. Sie können Ihre abonnierten AMIs auch verwalten, wenn Sie die Runtime-Engine von Rocket Software (ehemals Micro Focus) (auf Amazon EC2) einrichten.

1. Navigieren Sie zu AWS Marketplace Abonnements in der. AWS-Managementkonsole

1. Wählen Sie **Manage subscriptions (Abonnements verwalten)**.  
![\[AWS Marketplace Startseite.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-ami-subscription_1.png)

1. Kopieren Sie einen der folgenden Links und fügen Sie ihn in die Adressleiste des Browsers ein.
**Anmerkung**  
Wählen Sie nur einen Link für eines der Produkte, zu deren Verwendung Sie autorisiert wurden.
Stellen Sie sicher, dass Ihr Konto auf der Zulassungsliste steht, indem Sie der [Fordern Sie die Aktualisierung der Zulassungsliste für das Konto an](mf-runtime-setup-allowlist.md) Seite folgen, um diese Links zu verwenden.
   + [Unternehmensserver: https://aws.amazon.com/marketplace/ pp/prodview-g5emev63l7blc](https://aws.amazon.com/marketplace/pp/prodview-g5emev63l7blc)
   + [Unternehmensserver für Windows: pp/prodview-lwybsiyikbhc2 https://aws.amazon.com/marketplace/](https://aws.amazon.com/marketplace/pp/prodview-lwybsiyikbhc2)
   + [Unternehmensentwickler: pp/prodview-77qmpr42yzxwk https://aws.amazon.com/marketplace/](https://aws.amazon.com/marketplace/pp/prodview-77qmpr42yzxwk)
   + [Unternehmensentwickler mit Visual Studio 2022: pp/prodview-m4l3lqiszo6cm https://aws.amazon.com/marketplace/](https://aws.amazon.com/marketplace/pp/prodview-m4l3lqiszo6cm)
   + Unternehmensanalysator [https://aws.amazon.com/marketplace/:](https://aws.amazon.com/marketplace/pp/prodview-tttheylcmcihm) pp/prodview-tttheylcmcihm
   + [Enterprise Build-Tools für Windows: pp/prodview-2rw35bbt6uozi https://aws.amazon.com/marketplace/](https://aws.amazon.com/marketplace/pp/prodview-2rw35bbt6uozi)
   + Gespeicherte [https://aws.amazon.com/marketplace/Enterprise-Prozeduren](https://aws.amazon.com/marketplace/pp/prodview-zoeyqnsdsj6ha): pp/prodview-zoeyqnsdsj6ha
   + [Gespeicherte Unternehmensprozeduren mit SQL Server 2019: pp/prodview-ynfklquwubnz4 https://aws.amazon.com/marketplace/](https://aws.amazon.com/marketplace/pp/prodview-ynfklquwubnz4)

1. Wählen Sie **Continue to Subscribe (Weiter abonnieren)** aus.  
![\[Enterprise AWS Marketplace Server-Angebot in.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-ami-subscription_2.png)

1. Wenn die Allgemeinen Geschäftsbedingungen akzeptabel sind, wählen Sie **Bedingungen akzeptieren**.  
![\[Allgemeine Geschäftsbedingungen für das Abonnement.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-ami-subscription_3.png)

1. Die Bearbeitung des Abonnements kann einige Minuten dauern.  
![\[Nachricht mit ausstehendem Abonnement.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-ami-subscription_4.png)

1. Nachdem die Dankesnachricht angezeigt wird, kopieren Sie den nächsten Link aus Schritt 3 und fügen Sie ihn ein, um weitere Abonnements hinzuzufügen.  
![\[Dankeschön-Nachricht für das Abonnement.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-ami-subscription_5.png)

1. Beenden **Sie, wenn unter Abonnements verwalten** alle Ihre Abonnenten angezeigt werden. AMIs
**Anmerkung**  
Die Panel-Einstellungen (Zahnradsymbol) sind so eingestellt, dass die Ansicht als Tabelle angezeigt wird.  

![\[Verwalte deine Abonnements mit der Liste der Abonnenten. AMIs\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-ami-subscription_6.png)


# Starten Sie eine AWS Mainframe Modernization Instanz von Rocket Software (ehemals Micro Focus)
<a name="mf-runtime-setup-mf-instance"></a>

Nachdem Sie die Endpoints, die IAM-Richtlinie und die IAM-Rolle erstellt und das Abonnement abgeschlossen haben, sind Sie bereit AMIs, eine AWS Mainframe Modernization Rocket Software (Micro Focus) -Instanz in der zu starten. AWS-Managementkonsole

1. Navigieren Sie zu Abonnements in der. AWS Marketplace AWS-Managementkonsole

1. Suchen Sie das AMI, das gestartet werden soll, und wählen Sie **Launch New Instance** aus.  
![\[Verwalten Sie Abonnements mit Enterprise Server und Enterprise Analyzer, die startbereit sind.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-launch-instance_1.png)

1. Stellen Sie im Dialogfeld „Neue Instanz starten“ sicher, dass die Region auf der Zulassungsliste ausgewählt ist.

1. Drücken Sie auf **Weiter, um über EC2 zu starten**.
**Anmerkung**  
Das folgende Beispiel zeigt den Start eines Enterprise Developer AMI, aber der Prozess ist für alle identisch AWS Mainframe Modernization AMIs.  

![\[Starten Sie eine neue Instanz.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-launch-instance_2.png)


1. Geben Sie einen Namen für den Server ein.

1. Wählen Sie einen Instance-Type.

   Der gewählte Instanztyp sollte sich nach den Leistungs- und Kostenanforderungen des Projekts richten. Es werden folgende Ausgangspunkte vorgeschlagen:
   + Für Enterprise Analyzer ein r6i.xlarge
   + Für Enterprise Developer ein r6i.large
   + Für eine eigenständige Instanz von Enterprise Server ein r6i.xlarge
   + Für Rocket Software Performance Availability Cluster (PAC) mit Scale-Out ein r6i.large
**Anmerkung**  
Der Bereich Anwendungs- und Betriebssystem-Images wurde für den Screenshot ausgeblendet.  
![\[Startet eine Instanz mit eingegebenem Namen und Instanztyp.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-launch-instance_3.png)

1. Wählen oder erstellen (und speichern) Sie ein Schlüsselpaar (nicht angezeigt).

   Weitere Informationen zu Schlüsselpaaren für Linux-Instances finden Sie unter [Amazon EC2 EC2-Schlüsselpaare und Linux-Instances](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html).

   Weitere Informationen zu Schlüsselpaaren für Windows-Instances finden Sie unter [Amazon EC2 EC2-Schlüsselpaare und Windows-Instances](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ec2-key-pairs.html).

1. Bearbeiten Sie die Netzwerkeinstellungen und **wählen Sie die zugelassene VPC** und das entsprechende Subnetz aus.

1. **Wählen oder erstellen Sie eine Sicherheitsgruppe**. Wenn es sich um eine Enterprise Server EC2-Instance handelt, ist es üblich, TCP-Verkehr zu den Ports 86 und 10086 zuzulassen, um die Rocket-Software-Konfiguration zu verwalten.

1. Konfigurieren Sie optional den Speicher für die Amazon EC2 EC2-Instance.

1. Wichtig — Erweitern Sie Erweiterte Details und wählen Sie unter IAM-Instance-Profil die zuvor erstellte Lizenzierungsrolle aus, zum Beispiel „Micro-Focus-Licensing-Role“.
**Anmerkung**  
Wenn dieser Schritt versäumt wird, können Sie nach der Erstellung der Instance die IAM-Rolle über die Option Sicherheit des Aktionsmenüs für die EC2-Instance ändern.  
![\[Erweiterte Details mit eingegebenem IAM-Instanzprofil.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-launch-instance_4.png)

1. Sehen Sie sich die Zusammenfassung an und **starten Sie die Instance** per Push.  
![\[Zusammenfassung mit ausgewählten Optionen.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-launch-instance_5.png)

1. Der Instanzstart schlägt fehl, wenn ein ungültiger virtueller Servertyp ausgewählt wird.

   Wählen Sie in diesem Fall die Option **Instanzkonfiguration bearbeiten** und ändern Sie den Instanztyp.  
![\[Fortschrittsmeldung beim Starten der Instance.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-launch-instance_6.png)

1. Sobald die Erfolgsmeldung angezeigt wird, wählen Sie **Mit Instanz verbinden**, um Verbindungsdetails zu erhalten.  
![\[Erfolgsmeldung beim Start der Instance.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-launch-instance_7.png)

1. Navigieren Sie alternativ zu **EC2** in der AWS-Managementkonsole.

1. Wählen Sie **Instances**, um den Status der neuen Instance zu sehen.  
![\[Liste der Instanzen mit Status.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-launch-instance_8.png)

# Subnetz oder VPC ohne Internetzugang
<a name="mf-runtime-setup-no-access"></a>

Nehmen Sie diese zusätzlichen Änderungen vor, wenn das Subnetz oder die VPC keinen ausgehenden Internetzugang hat.

Der Lizenzmanager benötigt Zugriff auf die folgenden AWS-Services:
+ com.amazonaws. *region*. 3
+ com.amazonaws. *region*.ec2
+ com.amazonaws. *region*.lizenzmanager
+ com.amazonaws. *region*.sts

In den vorherigen Schritten wurde die Datei com.amazonaws definiert. *region*.s3-Dienst als Gateway-Endpunkt. Dieser Endpunkt benötigt einen Routing-Tabelleneintrag für alle Subnetze ohne Internetzugang.

Die zusätzlichen drei Dienste werden als Schnittstellen-Endpunkte definiert.

**Topics**
+ [Fügen Sie den Routen-Tabelleneintrag für den Amazon S3 S3-Endpunkt hinzu](#mf-runtime-setup-no-access-route-table)
+ [Definieren Sie die erforderliche Sicherheitsgruppe](#mf-runtime-setup-no-access-security-group)
+ [Erstellen Sie die Dienstendpunkte](#mf-runtime-setup-no-access-endpoints)

## Fügen Sie den Routen-Tabelleneintrag für den Amazon S3 S3-Endpunkt hinzu
<a name="mf-runtime-setup-no-access-route-table"></a>

1. Navigieren Sie zu **VPC** in AWS-Managementkonsole und wählen Sie **Subnetze** aus.

1. Wählen Sie das Subnetz aus, in dem die Amazon EC2 EC2-Instances erstellt werden sollen, und wählen Sie die Registerkarte Route Table.

1. Notieren Sie sich einige nachstehende Ziffern der Route-Tabellen-ID. Zum Beispiel die 6b39 in der Abbildung unten.  
![\[Details zur Routentabelle.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-no-internet_1.png)

1. Wählen Sie im Navigationsbereich **Endpoints** aus.

1. Wählen Sie den zuvor erstellten Endpunkt und anschließend **Routentabellen verwalten** aus, entweder auf der Registerkarte Routentabellen für den Endpunkt oder in der Dropdownliste Aktionen.

1. Wählen Sie die Routentabelle anhand der zuvor identifizierten Ziffern aus und klicken Sie auf Routentabellen ändern.  
![\[Die Routentabelle wurde ausgewählt.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-no-internet_2.png)

## Definieren Sie die erforderliche Sicherheitsgruppe
<a name="mf-runtime-setup-no-access-security-group"></a>

Die Amazon EC2- AWS STS, und License Manager Manager-Dienste kommunizieren über HTTPS über Port 443. Diese Kommunikation ist bidirektional und erfordert Regeln für eingehenden und ausgehenden Datenverkehr, damit die Instance mit den Services kommunizieren kann.

1. Navigieren Sie zu Amazon VPC in der AWS-Managementkonsole.

1. Suchen Sie in der Navigationsleiste nach **Sicherheitsgruppen** und wählen Sie **Sicherheitsgruppe erstellen** aus.

1. Geben Sie einen Namen und eine Beschreibung der Sicherheitsgruppe ein, zum Beispiel „Eingehend/Ausgehendes HTTPS“.

1. Drücken Sie das X im VPC-Auswahlbereich, um **die Standard-VPC zu entfernen, und wählen Sie die VPC** aus, die den S3-Endpunkt enthält.

1. Fügen Sie eine Regel für eingehenden Datenverkehr hinzu, die **TCP-Verkehr auf Port 443 von überall aus zulässt**.
**Anmerkung**  
Die Regeln für eingehenden (und ausgehenden Datenverkehr) können weiter eingeschränkt werden, indem die Quelle eingeschränkt wird. Weitere Informationen finden Sie unter [Steuern des Datenverkehrs zu Ihren AWS Ressourcen mithilfe von Sicherheitsgruppen](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-security-groups.html) im *Amazon VPC-Benutzerhandbuch*.  

![\[Grundlegende Details mit eingegebener Regel für eingehenden Datenverkehr.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-no-internet_3.png)


1. Drücken Sie auf **Sicherheitsgruppe erstellen**.

## Erstellen Sie die Dienstendpunkte
<a name="mf-runtime-setup-no-access-endpoints"></a>

Wiederholen Sie diesen Vorgang dreimal — einmal für jeden Dienst.

1. Navigieren Sie im zu Amazon VPC AWS-Managementkonsole und wählen Sie **Endpoints** aus.

1. Drücken Sie auf Endpunkt **erstellen**.

1. Geben Sie einen Namen ein, zum Beispiel „Micro-Focus-License-EC2“, „Micro-Focus-License-STS“ oder „Micro-Focus-License-Manager“.

1. Wählen Sie die **AWS-Servicekategorie** aus.  
![\[Endpunkteinstellungen mit ausgewählten AWS Diensten.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-no-internet_4.png)

1. Suchen Sie unter Dienste nach dem passenden Interface-Dienst, bei dem es sich um einen der folgenden handelt:
   + „com.amazonaws. *region*.ec2“
   + „com.amazonaws. *region*.sts“
   + „com.amazonaws. *region*.lizenzmanager“

   Beispiel:
   + „com.amazonaws.us-west-1.ec2“
   + „com.amazonaws.us-west-1.sts“
   + „com.amazonaws.us-west-1.lizenzmanager“

1. Wählen Sie den passenden Interface-Dienst aus.

   **com.amazonaws. *region*.ec2:**  
![\[Dienste mit ausgewähltem Amazon EC2 EC2-Schnittstellenservice.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-no-internet_5.png)

   **com.amazonaws. *region*.sts:**  
![\[Dienste mit ausgewähltem AWS STS Schnittstellendienst.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-no-internet_6.png)

   **com.amazonaws. *region*.lizenzmanager:**  
![\[Dienste mit ausgewähltem License Manager Manager-Schnittstellendienst.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-no-internet_7.png)

1. Wählen Sie für VPC die VPC für die Instance aus.  
![\[VPC mit der ausgewählten VPC für die Instance.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-no-internet_8.png)

1. Wählen Sie die **Availability Zone** und die **Subnetze** für die VPC aus.  
![\[Subnetze mit Availability Zone und Subnetz für die gewählte VPC.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-no-internet_9.png)

1. Wählen Sie die zuvor erstellte Sicherheitsgruppe aus.  
![\[Sicherheitsgruppen mit ausgewählter Sicherheitsgruppe.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-no-internet_10.png)

1. Wählen Sie unter Richtlinie die Option **Vollzugriff** aus.  
![\[Richtlinie mit Vollzugriff ausgewählt.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/mf-no-internet_11.png)

1. Klicken Sie auf **Endpunkt erstellen**.

1. Wiederholen Sie diesen Vorgang für die übrigen Schnittstellen.

# Richten Sie die Automatisierung für Rocket Enterprise Analyzer (ehemals Micro Focus) und Rocket Enterprise Developer Streaming-Sitzungen ein
<a name="set-up-automation-m2"></a>

Sie können beim Start und Ende der Sitzung automatisch ein Skript ausführen, um eine Automatisierung zu ermöglichen, die auf Ihren Kundenkontext zugeschnitten ist. Weitere Informationen zu dieser WorkSpaces Anwendungsfunktion finden Sie unter [Verwenden von Sitzungsskripten zur Verwaltung des Streaming-Erlebnisses Ihrer AppStream 2.0-Benutzer](https://docs.aws.amazon.com/appstream2/latest/developerguide/use-session-scripts.html) im *Amazon WorkSpaces Applications Administration Guide*.

Für diese Funktion benötigen Sie mindestens die folgenden Versionen der Enterprise Analyzer- und Enterprise Developer-Images:
+ `m2-enterprise-analyzer-v8.0.4.R1`
+ `m2-enterprise-developer-v8.0.4.R1`

**Topics**
+ [Richten Sie die Automatisierung beim Sitzungsstart ein](#set-up-automation-m2.start)
+ [Richten Sie die Automatisierung am Ende der Sitzung ein](#set-up-automation-m2.end)

## Richten Sie die Automatisierung beim Sitzungsstart ein
<a name="set-up-automation-m2.start"></a>

Wenn Sie ein Automatisierungsskript ausführen möchten, wenn Benutzer eine Verbindung zu WorkSpaces Anwendungen herstellen, erstellen Sie Ihr Skript und geben Sie ihm einen Namen`m2-user-setup.cmd`. Speichern Sie das Skript im Home-Ordner der WorkSpaces Anwendungen für den Benutzer. Die von AWS Mainframe Modernization bereitgestellten WorkSpaces Anwendungs-Images suchen an diesem Speicherort nach einem Skript mit diesem Namen und führen es aus, falls es existiert.

**Anmerkung**  
Die Skriptdauer darf das von WorkSpaces Applications festgelegte Limit, das derzeit 60 Sekunden beträgt, nicht überschreiten. Weitere Informationen finden Sie unter [Skripts ausführen, bevor Streaming-Sitzungen beginnen](https://docs.aws.amazon.com/appstream2/latest/developerguide/use-session-scripts.html#run-scripts-before-streaming-sessions-begin) im *Amazon WorkSpaces Applications Administration Guide*.

## Richten Sie die Automatisierung am Ende der Sitzung ein
<a name="set-up-automation-m2.end"></a>

Wenn Sie ein Automatisierungsskript ausführen möchten, wenn Benutzer die Verbindung zu WorkSpaces Anwendungen trennen, erstellen Sie Ihr Skript und geben Sie ihm einen Namen`m2-user-teardown.cmd`. Speichern Sie das Skript im Home-Ordner der WorkSpaces Anwendungen für den Benutzer. Die von AWS Mainframe Modernization bereitgestellten WorkSpaces Anwendungs-Images suchen an diesem Speicherort nach einem Skript mit diesem Namen und führen es aus, falls es existiert.

**Anmerkung**  
Die Skriptdauer darf das von WorkSpaces Applications festgelegte Limit, das derzeit 60 Sekunden beträgt, nicht überschreiten. Weitere Informationen finden Sie unter [Skripts nach dem Ende von Streaming-Sitzungen ausführen](https://docs.aws.amazon.com/appstream2/latest/developerguide/use-session-scripts.html#run-scripts-after-streaming-sessions-end) im *Amazon WorkSpaces Applications Administration Guide*.

# Datensätze in Rocket Enterprise Developer (ehemals Micro Focus Enterprise Developer) als Tabellen und Spalten anzeigen
<a name="view-datasets-tables-m2"></a>

Sie können mithilfe der Runtime von Rocket Software (ehemals Micro Focus) auf AWS Mainframe-Datensätze zugreifen, die im Rahmen von Mainframe Modernization bereitgestellt werden. Sie können die migrierten Datensätze als Tabellen und Spalten von einer Rocket Enterprise Developer-Instanz aus anzeigen. Wenn Sie Datensätze auf diese Weise betrachten, können Sie: 
+ Führen Sie `SQL SELECT` Operationen mit den migrierten Datendateien durch.
+ Machen Sie Daten außerhalb der migrierten Mainframe-Anwendung verfügbar, ohne die Anwendung zu ändern.
+ Filtern Sie Daten einfach und speichern Sie sie als CSV oder in anderen Dateiformaten.

**Anmerkung**  
Die Schritte 1 und 2 sind einmalige Aktivitäten. Wiederholen Sie die Schritte 3 und 4 für jeden Datensatz, um die Datenbankansichten zu erstellen.

**Topics**
+ [Voraussetzungen](#view-datasets-tables-m2.prereq)
+ [Schritt 1: ODBC-Verbindung zum Rocket Software-Datenspeicher (Amazon RDS-Datenbank) einrichten](#view-datasets-tables-m2.odbc)
+ [Schritt 2: Erstellen Sie die Datei MFDBFH.cfg](#view-datasets-tables-m2.config)
+ [Schritt 3: Erstellen Sie eine Strukturdatei (STR) für Ihr Copybook-Layout](#view-datasets-tables-m2.str)
+ [Schritt 4: Erstellen Sie eine Datenbankansicht mithilfe der Strukturdatei (STR)](#view-datasets-tables-m2.dbview)
+ [Schritt 5: Datensätze von Rocket Software (ehemals Micro Focus) als Tabellen und Spalten anzeigen](#view-datasets-tables-m2.cols)

## Voraussetzungen
<a name="view-datasets-tables-m2.prereq"></a>
+ Sie müssen über WorkSpaces Anwendungen Zugriff auf Rocket Enterprise Developer Desktop haben.
+ Sie müssen eine Anwendung im Rahmen der AWS Mainframe-Modernisierung mithilfe der Runtime-Engine von Rocket Software bereitgestellt und ausgeführt haben.
+ Sie speichern Ihre Anwendungsdaten in der Aurora PostgreSQL-kompatiblen Edition.

## Schritt 1: ODBC-Verbindung zum Rocket Software-Datenspeicher (Amazon RDS-Datenbank) einrichten
<a name="view-datasets-tables-m2.odbc"></a>

In diesem Schritt richten Sie eine ODBC-Verbindung zu der Datenbank ein, die die Daten enthält, die Sie als Tabellen und Spalten anzeigen möchten. Dieser Schritt ist nur einmalig.

1. Melden Sie sich mit der WorkSpaces Anwendungs-Streaming-URL bei Rocket Enterprise Developer Desktop an.

1. **Öffnen Sie den **ODBC-Datenquellenadministrator**, wählen Sie **Benutzer-DSN** und dann Hinzufügen.**

1. **Wählen **Sie unter Neue Datenquelle erstellen** die Option **PostgreSQL ANSI** und dann Fertig stellen aus.**

1. Erstellen Sie eine Datenquelle für, `PG.POSTGRES` indem Sie die erforderlichen Datenbankinformationen wie folgt angeben:

   ```
   Data Source : PG.POSTGRES
   Database    : postgres
   Server      : rds_endpoint.rds.amazonaws.com
   Port        : 5432
   User Name   : user_name
   Password    : user_password
   ```  
![\[Einrichtung der Postgres-ODBC-Verbindung in Enterprise Developer.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/view-data-tables-odbc.png)

1. Wählen Sie **Test**, um sicherzustellen, dass die Verbindung funktioniert. Sie sollten die Meldung sehen, `Connection successful` ob der Test erfolgreich war.

   Wenn der Test nicht erfolgreich ist, überprüfen Sie die folgenden Informationen.
   + [Fehlerbehebung für Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Troubleshooting.html)
   + [Wie löse ich Probleme beim Herstellen einer Verbindung zu meiner Amazon RDS-DB-Instance?](https://repost.aws/knowledge-center/rds-cannot-connect)

1. Speichern Sie die Datenquelle.

1. Erstellen Sie eine Datenquelle für`PG.VSAM`, testen Sie die Verbindung und speichern Sie die Datenquelle. Geben Sie die folgenden Datenbankinformationen an:

   ```
   Data Source : PG.VSAM
   Database    : MicroFocus$SEE$Files$VSAM
   Server      : rds_endpoint.rds.amazonaws.com
   Port        : 5432
   User Name   : user_name
   Password    : user_password
   ```  
![\[Einrichtung der ODBC-Datenquelle PG.VSAM in Enterprise Developer.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/view-data-tables-pg-vsam.png)

## Schritt 2: Erstellen Sie die Datei MFDBFH.cfg
<a name="view-datasets-tables-m2.config"></a>

In diesem Schritt erstellen Sie eine Konfigurationsdatei, die den Micro Focus-Datenspeicher beschreibt. Dies ist ein einmaliger Konfigurationsschritt.

1. Erstellen Sie in Ihrem Home-Ordner, z. B. in`D:\PhotonUser\My Files\Home Folder\MFED\cfg\MFDBFH.cfg`, die Datei MFDBFH.cfg mit dem folgenden Inhalt.

   ```
   <datastores>
          <server name="ESPACDatabase" type="postgresql" access="odbc">
           <dsn name="PG.POSTGRES" type="database" dbname="postgres"/>
           <dsn name="PG.VSAM" type="datastore" dsname="VSAM"/>
          </server>
         </datastores>
   ```

1. Überprüfen Sie die MFDBFH-Konfiguration, indem Sie die folgenden Befehle ausführen, um den Micro Focus-Datenspeicher abzufragen:

   ```
   *##*
   *## Test the connection by running the following commands*
   *##*
         
   set MFDBFH_CONFIG="D:\PhotonUser\My Files\Home Folder\MFED\cfg\MFDBFH.cfg"
         
   dbfhdeploy list sql://ESPACDatabase/VSAM?folder=/DATA
   ```

## Schritt 3: Erstellen Sie eine Strukturdatei (STR) für Ihr Copybook-Layout
<a name="view-datasets-tables-m2.str"></a>

In diesem Schritt erstellen Sie eine Strukturdatei für Ihr Copybook-Layout, sodass Sie sie später verwenden können, um Datenbankansichten aus den Datensätzen zu erstellen.

1. Kompilieren Sie das Programm, das Ihrem Copybook zugeordnet ist. Wenn kein Programm das Copybook verwendet, erstellen und kompilieren Sie ein einfaches Programm wie das folgende mit einer COPY-Anweisung für Ihr Copybook.

   ```
   IDENTIFICATION DIVISION.
         PROGRAM-ID. TESTPGM1.
         
         ENVIRONMENT DIVISION.
         CONFIGURATION SECTION.
         
         DATA DIVISION.
         WORKING-STORAGE SECTION.
         
         COPY CVTRA05Y.
         
         PROCEDURE DIVISION.
         
         GOBACK.
   ```

1. Klicken Sie nach erfolgreicher Kompilierung mit der rechten Maustaste auf das Programm und wählen Sie **Create Record Layout File**. Dadurch werden die Micro Focus Data File Tools mit der während der Kompilierung generierten IDY-Datei geöffnet.  
![\[Speicherort des Befehls „Datensatz-Layout-Datei erstellen“ in Enterprise Developer.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/view-data-tables-idy-file.png)

1. Klicken Sie mit der rechten Maustaste auf die Datensatzstruktur und wählen Sie je nach **Layout Standardlayout** **erstellen (einzelne Struktur) oder Bedingtes** Layout erstellen (mehrere Strukturen).

   Weitere Informationen finden Sie unter [Strukturdateien und Layouts erstellen](https://www.microfocus.com/documentation/enterprise-developer/ed60/ES-WIN/GUID-6EDDA4C3-F09E-4CEC-9CF8-281D9D7453C3.html) in der Micro Focus-Dokumentation.  
![\[Position der Layoutbefehle in den Micro Focus-Datendateitools.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/view-data-tables-mf-data-file-tools.png)

1. Nachdem Sie das Layout erstellt haben, wählen Sie im Menü **Datei** und dann **Speichern unter**. Suchen und speichern Sie die Datei in Ihrem Home-Ordner mit demselben Dateinamen wie Ihr Copybook. Sie können wählen, ob Sie einen Ordner mit dem Namen erstellen `str` und alle Ihre Strukturdateien dort speichern möchten.  
![\[Speichern der STR-Datei in Enterprise Developer.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/view-data-tables-save-str.png)

## Schritt 4: Erstellen Sie eine Datenbankansicht mithilfe der Strukturdatei (STR)
<a name="view-datasets-tables-m2.dbview"></a>

In diesem Schritt verwenden Sie die zuvor erstellte Strukturdatei, um eine Datenbankansicht für einen Datensatz zu erstellen.
+ Verwenden Sie den `dbfhview` Befehl, um eine Datenbankansicht für einen Datensatz zu erstellen, der sich bereits im Micro Focus-Datenspeicher befindet, wie im folgenden Beispiel gezeigt.

  ```
  ##
        ## The below command creates database view for VSAM file AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS 
        ## using the STR file CVTRA05Y.str
        ##
        
        dbfhview -create -struct:"D:\PhotonUser\My Files\Home Folder\MFED\str\CVTRA05Y.str" -name:V_AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS.DAT -file:sql://ESPACDatabase/VSAM/AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS.DAT?folder=/DATA
        
        ##
        ## Output:
        ##
        
        Micro Focus Database File Handler - View Generation Tool Version 8.0.00
        Copyright (C) 1984-2022 Micro Focus. All rights reserved.
        
        VGN0017I Using structure definition 'TRAN-RECORD-DEFAULT'
        VGN0022I View 'V_AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS.DAT' installed in datastore 'sql://espacdatabase/VSAM'
        VGN0002I The operation completed successfully
  ```

## Schritt 5: Datensätze von Rocket Software (ehemals Micro Focus) als Tabellen und Spalten anzeigen
<a name="view-datasets-tables-m2.cols"></a>

Stellen Sie in diesem Schritt eine Verbindung zur Datenbank her, `pgAdmin` sodass Sie Abfragen ausführen können, um die Datensätze wie Tabellen und Spalten anzuzeigen.
+ Stellen Sie `MicroFocus$SEE$Files$VSAM` mit pgAdmin Connect zur Datenbank her und fragen Sie die Datenbankansicht ab, die Sie in Schritt 4 erstellt haben.

  ```
  SELECT * FROM public."V_AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS.DAT";
  ```  
![\[Migrierter Datensatz mit Tabellen und Spalten in pgAdmin.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/view-data-tables-new-view-pgadmin.png)

# Bearbeiten Sie Datensätze mit den Datendatei-Tools von Rocket Software (ehemals Micro Focus) in Enterprise Developer
<a name="edit-datasets-m2"></a>

Sie können Datensätze in AWS Mainframe Modernization mithilfe der Rocket Software-Runtime für alle migrierten Datensätze anzeigen und bearbeiten.
 Die Schritte in diesem Dokument führen Sie durch den Prozess des Zugriffs auf Datensätze mithilfe von Data File Tools.
 Auf diese Weise können Sie die migrierten Datensätze nach Bedarf anzeigen und bearbeiten.


**Topics**
+ [Voraussetzungen](#edit-datasets-m2.prereq)
+ [Starten Sie die Data File Tools von Rocket Software (ehemals Micro Focus)](#edit-datasets-m2-launch)
+ [Bearbeiten Sie die in der MFDBFH-Datenbank gespeicherten VSAM-Datensätze](#edit-datasets-m2-vsam)
+ [Bearbeiten Sie Nicht-VSAM-Datensätze, die in der MFDBFH-Datenbank gespeichert sind](#edit-datasets-m2-nonvsam)
+ [Bearbeiten Sie im Dateisystem gespeicherte VSAM- und Nicht-VSAM-Datensätze (EFS/FSx)](#edit-datasets-m2-open)

## Voraussetzungen
<a name="edit-datasets-m2.prereq"></a>

Bevor Sie beginnen, müssen Sie eine Anwendung mit den Datensätzen bereitgestellt haben wurde im Rahmen des AWS Mainframe-Modernisierungsdienstes mithilfe der Rocket Software-Engine importiert.

Um mit der Bearbeitung der Datensätze fortzufahren, müssen Sie Schritt 1, Schritt 2 abschließen. und (optional) Schritt 3 von der [Datensätze in Rocket Enterprise Developer (ehemals Micro Focus Enterprise Developer) als Tabellen und Spalten anzeigen](view-datasets-tables-m2.md) Seite um die ODBC-Verbindung und den Micro Focus-Datenspeicher (das heißt,) zu konfigurieren. `MFDBFH`

**Wichtig**  
In diesem Handbuch wird davon ausgegangen, dass Sie Amazon Aurora Postgres als Micro Focus-Datenspeicher verwenden () `MFDBFH` um Ihre Anwendungsdaten zu speichern.

## Starten Sie die Data File Tools von Rocket Software (ehemals Micro Focus)
<a name="edit-datasets-m2-launch"></a>

Nachdem Sie die Voraussetzungen erfüllt haben, starten Sie die Micro Focus Data File Tools, indem Sie die `MFDBFH_CONFIG` Umgebungsvariable für den Zugriff auf die in der Datenbank gespeicherten Datensätze einrichten (`MFDBFH`). 

Um dies zu tun,

1. Melden Sie sich beim Micro Focus Enterprise Developer-Desktop an und starten Sie die **Enterprise Developer-Eingabeaufforderung (64-Bit)** im **Startmenü**.

1. Geben Sie der `MFDBFH_CONFIG` Umgebungsvariablen den vollständigen Pfad zu Ihrer `MFDBCH.cfg` Datei an.

   ```
   set MFDBFH_CONFIG="C:\MicroFocus\config\MFDBFH.cfg"
   ```

1. Starten Sie Micro Focus Data File Tools über die Enterprise Developer-Befehlszeile mit dem folgenden Befehl.

   ```
   mfdatatools2
   ```  
![\[Enterprise Developer-Befehlszeile.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/edit-mfdbfh-launch.png)

Dadurch werden die Micro Focus Data File Tools in einem separaten Fenster geöffnet.

## Bearbeiten Sie die in der MFDBFH-Datenbank gespeicherten VSAM-Datensätze
<a name="edit-datasets-m2-vsam"></a>

Sobald Sie die Micro Focus Data File Tools starten, öffnen Sie einen VSAM-Datensatz, der im Micro Focus-Datenspeicher gespeichert ist.

Um das zu tun,

1. Wählen **Sie im Fenster Micro Focus Data File Tools im Menü** Datei die Option **Data Explorer**.

1. Wählen Sie im Bereich Data Explorer die Option **Einstellungen** (Zahnradsymbol), um eine neue Verbindung zu konfigurieren. Dadurch wird ein Fenster mit **Datenquelleneinstellungen** geöffnet.  
![\[Das Micro Focus Data File Tools-Fenster mit dem Bereich Data Explorer.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/edit-mfdbfh-data-source.png)

1. Wählen Sie im Fenster Datenquelleneinstellungen die Registerkarte **MFDBFH** und geben Sie die folgenden Werte ein:
   + Server: `ESPACDatabase`
   + Datenspeicher: `VSAM`

   Wählen Sie **Anwenden**, um die Konfiguration zu speichern.  
![\[Datenquelleneinstellungen im Micro Focus Data File Tools-Fenster mit der Registerkarte MFDBFH.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/edit-mfdbfh-data-source-settings.png)

    Der Datenexplorer zeigt jetzt alle Datensätze an, die in gespeichert sind. `MFDBFH`  
![\[Das Micro Focus Data File Tools-Fenster mit dem Bereich Data Explorer, in dem alle Datensätze angezeigt werden.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/edit-mfdbfh-datasets.png)

1. Erweitern Sie den relativen Pfad `DATA` und doppelklicken Sie auf den VSAM-Datensatz, den Sie öffnen möchten. 

1. Wählen **Sie im Fenster Datendatei öffnen** die Option **Gemeinsam öffnen** oder **Exklusiv öffnen**, um den Datensatz zu öffnen.  
![\[Das Micro Focus Data File Tools-Fenster mit dem Bereich Data Explorer. Bereich „Datendatei öffnen“, um Datensätze zu öffnen.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/edit-mfdbfh-data-set.png)

Sie können den geöffneten Datensatz jetzt anzeigen oder bearbeiten.

## Bearbeiten Sie Nicht-VSAM-Datensätze, die in der MFDBFH-Datenbank gespeichert sind
<a name="edit-datasets-m2-nonvsam"></a>

Wenn Sie Nicht-VSAM-Datensätze bearbeiten möchten, öffnen Sie einen Nicht-VSAM-Datensatz, der im Micro Focus-Datenspeicher gespeichert ist.

Um das zu tun,

1. Führen Sie an der Enterprise Developer-Befehlszeile (64-Bit) den `dbfhdeploy data extract` Befehl aus, um den Nicht-VSAM-Datensatz in Ihr lokales Dateisystem herunterzuladen. 
**Anmerkung**  
Bevor Sie diesen Befehl ausführen, stellen Sie sicher, dass Sie der `MFDBFH_CONFIG` Umgebungsvariablen den vollständigen Pfad zu Ihrer `MFDBFH.cfg` Datei zugewiesen haben.  

   ```
   dbfhdeploy data extract sql://ESPACDatabase/VSAM/AWS.M2.CARDDEMO.TRANSACT.BKUP.G0001V00.DAT?folder=/DATA C:\MicroFocus\data\AWS.M2.CARDDEMO.TRANSACT.BKUP.G0001V00.DAT
   ```

1. Starten Sie die Micro Focus Data File Tools über das **Startmenü**.

1. Wählen Sie im Menü Datei der Micro Focus Data File Tools die Option **Öffnen** und dann **Datendatei**.

1. Durchsuchen Sie im Fenster „Datendatei öffnen“ den heruntergeladenen Datensatz in Ihrem lokalen Dateisystem. Bearbeiten Sie die **Dateidetails** nach Bedarf. Wählen Sie dann **Gemeinsam öffnen** oder **Exklusiv öffnen**, um den Datensatz zu öffnen.  
![\[Öffnen Sie das Fenster „Datendateien“, wobei die lokale Registerkarte zum Durchsuchen von Datensätzen ausgewählt ist.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/edit-mfdbfh-browse.png)

Sie können den geöffneten Datensatz jetzt anzeigen oder bearbeiten.

Die bearbeiteten oder aktualisierten Datensätze können mithilfe der Schritte unter [Importieren Sie Datensätze für AWS Mainframe Modernization Anwendungen](applications-m2-dataset.md) oder mithilfe des Befehlszeilendienstprogramms [dbfhdeploy wieder in den](https://www.microfocus.com/documentation/enterprise-developer/ed90/ED-Eclipse/GUID-2A16851F-E475-42C9-B024-37567006B86D.html) Micro Focus-Datenspeicher importiert werden.

## Bearbeiten Sie im Dateisystem gespeicherte VSAM- und Nicht-VSAM-Datensätze (EFS/FSx)
<a name="edit-datasets-m2-open"></a>

Sie können auch einen in einem Dateisystem gespeicherten Datensatz öffnen.

Um das zu tun,

1. Mounten Sie das EFS/FSx Dateisystem auf der Enterprise Developer EC2-Instanz.

1. Verwenden Sie die Micro Focus Data File Tools, um die Datensätze im Dateisystem zu durchsuchen und zu öffnen.

# Tutorials für Rocket Software (ehemals Micro Focus)
<a name="tutorials-mf"></a>

Die Tutorials in diesem Abschnitt helfen Ihnen beim Einstieg in die Einrichtung verschiedener Aufgaben in der Runtime-Engine von Rocket Software für den AWS Mainframe Modernization Service. Diese Tutorials dienen der Einrichtung einer Beispielanwendung, der Verwendung von Vorlagen mit Rocket Enterprise Developer und der Einrichtung von Enterprise Analyzer.

**Topics**
+ [Tutorial: Den Build von Rocket Software (ehemals Micro Focus) für die BankDemo Beispielanwendung einrichten](tutorial-build-mf.md)
+ [Tutorial: WorkSpaces Anwendungen für die Verwendung mit Rocket Enterprise Analyzer und Rocket Enterprise Developer einrichten](set-up-appstream-mf.md)
+ [Tutorial: Vorlagen mit Rocket Enterprise Developer (ehemals Micro Focus Enterprise Developer) verwenden](tutorial-templates-ed.md)
+ [Tutorial: Enterprise Analyzer für WorkSpaces Anwendungen einrichten](set-up-ea.md)
+ [Tutorial: Rocket Enterprise Developer für WorkSpaces Anwendungen einrichten](set-up-ed.md)

# Tutorial: Den Build von Rocket Software (ehemals Micro Focus) für die BankDemo Beispielanwendung einrichten
<a name="tutorial-build-mf"></a>

AWS Mainframe-Modernisierung bietet Ihnen die Möglichkeit, Builds und Continuous integration/continuous Delivery (CI/CD) -Pipelines für Ihre migrierten Anwendungen einzurichten. Diese Builds und Pipelines verwenden AWS CodeBuild, AWS CodeCommit und stellen diese Funktionen bereit. AWS CodePipeline CodeBuild ist ein vollständig verwalteter Build-Service, der Ihren Quellcode kompiliert, Komponententests durchführt und Artefakte erzeugt, die sofort einsatzbereit sind. CodeCommit ist ein Versionskontrolldienst, mit dem Sie Git-Repositorys privat in der Cloud speichern und verwalten können. AWS CodePipeline ist ein Dienst zur kontinuierlichen Bereitstellung, mit dem Sie die zur Veröffentlichung Ihrer Software erforderlichen Schritte modellieren, visualisieren und automatisieren können.

In diesem Tutorial wird gezeigt, wie Sie AWS CodeBuild den Quellcode der BankDemo Beispielanwendung aus Amazon S3 kompilieren und den kompilierten Code anschließend zurück nach Amazon S3 exportieren.

AWS CodeBuild ist ein vollständig verwalteter Continuous Integration-Service, der Quellcode kompiliert, Tests durchführt und Softwarepakete erstellt, die sofort einsatzbereit sind. Mit CodeBuild können Sie vorgefertigte Build-Umgebungen verwenden oder benutzerdefinierte Build-Umgebungen erstellen, die Ihre eigenen Build-Tools verwenden. In diesem Demo-Szenario wird die zweite Option verwendet. Es besteht aus einer CodeBuild Build-Umgebung, die ein vorgefertigtes Docker-Image verwendet.

**Wichtig**  
Bevor Sie mit Ihrem Mainframe-Modernisierungsprojekt beginnen, empfehlen wir Ihnen, sich über das [AWS Migration Acceleration Program (MAP) für Mainframe zu informieren oder sich an [AWS Mainframe-Spezialisten](mailto: mainframe@amazon.com)](https://aws.amazon.com/migration-acceleration-program/mainframe/) zu wenden, um mehr über die zur Modernisierung einer Mainframe-Anwendung erforderlichen Schritte zu erfahren.

**Topics**
+ [Voraussetzungen](#tutorial-build-mf-prerequisites)
+ [Schritt 1: Teilen Sie die Build-Assets mit AWS Ihrem Konto](#tutorial-build-mf-assets)
+ [Schritt 2: Amazon S3 S3-Buckets erstellen](#tutorial-build-mf-s3)
+ [Schritt 3: Erstellen Sie die Build-Spezifikationsdatei](#tutorial-build-mf-spec)
+ [Schritt 4: Laden Sie die Quelldateien hoch](#tutorial-build-mf-upload)
+ [Schritt 5: IAM-Richtlinien erstellen](#tutorial-build-mf-IAM-policy)
+ [Schritt 6: Erstellen Sie eine IAM-Rolle](#tutorial-build-mf-IAM-role)
+ [Schritt 7: Hängen Sie die IAM-Richtlinien an die IAM-Rolle an](#tutorial-build-mf-attach)
+ [Schritt 8: Erstellen Sie das CodeBuild Projekt](#tutorial-build-mf-create-project)
+ [Schritt 9: Starten Sie den Build](#tutorial-build-mf-start)
+ [Schritt 10: Laden Sie die Ausgabeartefakte herunter](#tutorial-build-mf-download-output)
+ [Bereinigen von Ressourcen](#tutorial-build-mf-clean)

## Voraussetzungen
<a name="tutorial-build-mf-prerequisites"></a>

Bevor Sie mit diesem Tutorial beginnen, müssen Sie die folgenden Voraussetzungen erfüllen.
+ Laden Sie die [BankDemo Beispielanwendung](https://d3lkpej5ajcpac.cloudfront.net/demo/mf/BANKDEMO-build.zip) herunter und entpacken Sie sie in einen Ordner. Der Quellordner enthält COBOL-Programme und Copybooks sowie Definitionen. Er enthält auch einen JCL-Ordner als Referenz, obwohl Sie JCL nicht erstellen müssen. Der Ordner enthält auch die für den Build erforderlichen Metadateien.
+ Wählen Sie in der AWS Mainframe Modernization Console die Option **Tools** aus. Wählen Sie unter **Analysis, Development and Build Assets** die Option **Assets mit meinem AWS-Konto teilen** aus.

## Schritt 1: Teilen Sie die Build-Assets mit AWS Ihrem Konto
<a name="tutorial-build-mf-assets"></a>

In diesem Schritt stellen Sie sicher, dass Sie die Build-Assets mit Ihrem AWS Konto teilen, insbesondere in der Region, in der die Assets verwendet werden.

1. Öffnen Sie die AWS Mainframe-Modernisierungskonsole 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 unter **Assets analysieren, entwickeln und erstellen** die Option **Assets mit meinem AWS Konto teilen** aus.

**Wichtig**  
Sie müssen diesen Schritt in jeder AWS Region, in der Sie Builds erstellen möchten, einmal ausführen.

## Schritt 2: Amazon S3 S3-Buckets erstellen
<a name="tutorial-build-mf-s3"></a>

In diesem Schritt erstellen Sie zwei Amazon S3 S3-Buckets. Der erste ist ein Eingabe-Bucket für den Quellcode und der andere ist ein Ausgabe-Bucket für die Build-Ausgabe. 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 Eingabe-Bucket zu erstellen, melden Sie sich bei der Amazon S3 S3-Konsole an und wählen Sie **Create Bucket**.

1. Geben Sie in der **allgemeinen Konfiguration** einen Namen für den Bucket an und geben Sie an AWS-Region , wo Sie den Bucket erstellen möchten. Ein Beispiel für den Namen ist `codebuild-regionId-accountId-input-bucket` Where `regionId` is the AWS-Region of the Bucket und `accountId` ist Ihre 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**.

1. Wiederholen Sie die Schritte 1—3, um den Ausgabe-Bucket zu erstellen. Ein Beispiel für den Namen ist `codebuild-regionId-accountId-output-bucket` where `regionId` is the AWS-Region of the Bucket und `accountId` ist Ihre AWS-Konto ID.

   Welche Namen Sie auch immer für diese Buckets wählen, achten Sie darauf, sie in diesem Tutorial zu verwenden.

## Schritt 3: Erstellen Sie die Build-Spezifikationsdatei
<a name="tutorial-build-mf-spec"></a>

In diesem Schritt erstellen Sie eine Build-Spezifikationsdatei,. Diese Datei enthält Build-Befehle und zugehörige Einstellungen im YAML-Format CodeBuild zum Ausführen des Builds. Weitere Informationen finden Sie unter [Referenz zur Build-Spezifikation für CodeBuild](https://docs.aws.amazon.com/codebuild/latest/userguide/build-spec-ref.html) im *AWS CodeBuild Benutzerhandbuch*.

1. Erstellen Sie als Voraussetzung eine Datei mit dem Namen `buildspec.yml` in dem Verzeichnis, das Sie entpackt haben.

1. Fügen Sie der Datei den folgenden Inhalt hinzu und speichern Sie sie. Für diese Datei sind keine Änderungen erforderlich.

   ```
   version: 0.2
   env:
     exported-variables:
       - CODEBUILD_BUILD_ID
       - CODEBUILD_BUILD_ARN
   phases:
     install:
       runtime-versions:
         python: 3.7
     pre_build:
       commands:
         - echo Installing source dependencies...
         - ls -lR $CODEBUILD_SRC_DIR/source
     build:
       commands:
         - echo Build started on `date`
         - /start-build.sh -Dbasedir=$CODEBUILD_SRC_DIR/source -Dloaddir=$CODEBUILD_SRC_DIR/target 
     post_build:
       commands:
         - ls -lR $CODEBUILD_SRC_DIR/target
         - echo Build completed on `date`
   artifacts:
     files:
       - $CODEBUILD_SRC_DIR/target/**
   ```

   Hier `$CODEBUILD_SRC_DIR/target` sind Umgebungsvariablen `CODEBUILD_BUILD_ID` `CODEBUILD_BUILD_ARN``$CODEBUILD_SRC_DIR/source`, und innerhalb verfügbar CodeBuild. Weitere Informationen finden Sie unter [Umgebungsvariablen in Build-Umgebungen](https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-env-vars.html).

   Zu diesem Zeitpunkt sollte Ihr Verzeichnis so aussehen.

   ```
   (root directory name)
       |-- build.xml
       |-- buildspec.yml
       |-- LICENSE.txt
       |-- source
            |... etc.
   ```

1. Komprimieren Sie den Inhalt des Ordners in eine Datei mit dem Namen`BankDemo.zip`.. Für dieses Tutorial können Sie den Ordner nicht komprimieren. Stattdessen komprimieren Sie den Inhalt des Ordners in die Datei`BankDemo.zip`.

## Schritt 4: Laden Sie die Quelldateien hoch
<a name="tutorial-build-mf-upload"></a>

In diesem Schritt laden Sie den Quellcode für die BankDemo Beispielanwendung in Ihren Amazon S3 S3-Eingabe-Bucket hoch.

1. Melden Sie sich bei der Amazon S3 S3-Konsole an und wählen Sie im linken Navigationsbereich **Buckets** aus. Wählen Sie dann den Eingabe-Bucket aus, den Sie zuvor erstellt haben.

1. Wählen Sie unter **Objekte** die Option **Hochladen** aus.

1. Wählen Sie im Bereich **Dateien und Ordner** die Option **Dateien hinzufügen** aus.

1. Navigieren Sie zu Ihrer `BankDemo.zip` Datei und wählen Sie sie aus.

1. Klicken Sie auf **Upload**.

## Schritt 5: IAM-Richtlinien erstellen
<a name="tutorial-build-mf-IAM-policy"></a>

In diesem Schritt erstellen Sie zwei [IAM-Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html). Eine Richtlinie gewährt AWS Mainframe Modernization die Erlaubnis, auf das Docker-Image zuzugreifen und es zu verwenden, das die Build-Tools von Rocket Software enthält. Diese Richtlinie ist nicht auf Kunden zugeschnitten. Die andere Richtlinie gewährt AWS Mainframe Modernization die Erlaubnis, mit den Eingabe- und Ausgabe-Buckets sowie mit den generierten [ CloudWatch Amazon-Protokollen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/WhatIsCloudWatchLogs.html) zu interagieren. CodeBuild 

*Weitere Informationen zum Erstellen einer IAM-Richtlinie finden Sie unter [Bearbeiten von IAM-Richtlinien im IAM-Benutzerhandbuch](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html).*

**So erstellen Sie eine Richtlinie für den Zugriff auf Docker-Images**

1. Kopieren Sie in der IAM-Konsole das folgende Richtliniendokument und fügen Sie es in den Richtlinien-Editor ein.

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
                   "ecr:GetAuthorizationToken"
               ],
               "Resource": "*"
           },
           {
               "Effect": "Allow",
               "Action": [
                   "ecr:BatchCheckLayerAvailability",
                   "ecr:GetDownloadUrlForLayer",
                   "ecr:BatchGetImage"
               ],
               "Resource": "arn:aws:ecr:*:673918848628:repository/m2-enterprise-build-tools"
           },
           {
               "Effect": "Allow",
               "Action": [
                   "s3:PutObject"
               ],
               "Resource": "arn:aws:s3:::aws-m2-repo-*-<region>-prod"
           }
       ]
   }
   ```

------

1. Geben Sie einen Namen für die Richtlinie ein, z. B. `m2CodeBuildPolicy`

**Um eine Richtlinie zu erstellen, die es AWS Mainframe Modernization ermöglicht, mit Buckets und Logs zu interagieren**

1. Kopieren Sie in der IAM-Konsole das folgende Richtliniendokument und fügen Sie es in den Policy-Editor ein. Stellen Sie sicher, dass Sie `regionId` auf die AWS-Region und `accountId` auf Ihre AWS-Konto aktualisieren.

1. Geben Sie einen Namen für die Richtlinie ein, `BankdemoCodeBuildRolePolicy` z. B.

## Schritt 6: Erstellen Sie eine IAM-Rolle
<a name="tutorial-build-mf-IAM-role"></a>

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](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html) im *IAM-Benutzerhandbuch*,.

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, `BankdemoCodeBuildServiceRole` 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 7: Hängen Sie die IAM-Richtlinien an die IAM-Rolle an
<a name="tutorial-build-mf-attach"></a>

In diesem Schritt fügen Sie die beiden IAM-Richtlinien, die Sie zuvor erstellt haben, der `BankdemoCodeBuildServiceRole` 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, `BankdemoCodeBuildServiceRole` 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, z. B. `m2CodeBuildPolicy` und`BankdemoCodeBuildRolePolicy`.

1. Wählen Sie **Richtlinien anfügen**.

## Schritt 8: Erstellen Sie das CodeBuild Projekt
<a name="tutorial-build-mf-create-project"></a>

In diesem Schritt erstellen Sie das CodeBuild Projekt.

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

1. Geben Sie im Abschnitt **Projektkonfiguration** einen Namen für das Projekt ein, `codebuild-bankdemo-project` 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, zum Beispiel`codebuild-regionId-accountId-input-bucket`.

1. Geben Sie im Feld **S3-Objektschlüssel oder S3-Ordner** den Namen der ZIP-Datei ein, die Sie in den S3-Bucket hochgeladen haben. In diesem Fall lautet der Dateiname`bankdemo.zip`.

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. Im Feld **Externe Registrierungs-URL** 
   + Für Rocket Software v9: Geben Sie ein`673918848628.dkr.ecr.us-west-1.amazonaws.com/m2-enterprise-build-tools:9.0.7.R1`. Wenn Sie eine andere AWS Region mit Rocket Software v9 verwenden, können Sie auch angeben` 673918848628.dkr.ecr.<m2-region>.amazonaws.com/m2-enterprise-build-tools:9.0.7.R1`, <m2-region>in welcher AWS Region der AWS Mainframe-Modernisierungsservice verfügbar ist (z. B.). `eu-west-3`
   + Für Rocket Software v8: Geben Sie ein `673918848628.dkr.ecr.us-west-2.amazonaws.com/m2-enterprise-build-tools:8.0.9.R1`
   + Für Rocket Software v7: Geben Sie ein `673918848628.dkr.ecr.us-west-2.amazonaws.com/m2-enterprise-build-tools:7.0.R10`

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, zum Beispiel`BankdemoCodeBuildServiceRole`.

1. Wählen Sie im Abschnitt **Buildspec** die Option Buildspec-Datei **verwenden** aus.

1. Wählen Sie im Abschnitt **Artifacts** unter **Type** **Amazon S3** und dann Ihren Output-Bucket aus, zum Beispiel`codebuild-regionId-accountId-output-bucket`.

1. Geben Sie im Feld **Name** den Namen eines Ordners im Bucket ein, der die Build-Ausgabeartefakte enthalten soll, `bankdemo-output.zip` z. B.

1. Wählen Sie unter **Verpackung von Artefakten** die Option **Zip** aus.

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

## Schritt 9: Starten Sie den Build
<a name="tutorial-build-mf-start"></a>

In diesem Schritt starten Sie den Build.

1. Loggen Sie sich in die CodeBuild Konsole ein.

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

1. Wählen Sie das Build-Projekt aus, das Sie zuvor erstellt haben, `codebuild-bankdemo-project` z. B.

1. Wählen Sie **Start build (Build starten)**.

Mit diesem Befehl wird der Build gestartet. Der Build wird asynchron ausgeführt. Die Ausgabe des Befehls ist eine JSON-Datei, die das Attribut id enthält. Diese Attribut-ID ist ein Verweis auf die CodeBuild Build-ID des Builds, den Sie gerade gestartet haben. Sie können den Status des Builds in der CodeBuild Konsole einsehen. Sie können auch detaillierte Protokolle zur Build-Ausführung in der Konsole einsehen. Weitere Informationen finden Sie im *AWS CodeBuild Benutzerhandbuch* unter [Anzeigen detaillierter Build-Informationen](https://docs.aws.amazon.com/codebuild/latest/userguide/getting-started-build-log-console.html).

Wenn die aktuelle Phase ABGESCHLOSSEN ist, bedeutet dies, dass Ihr Build erfolgreich abgeschlossen wurde und Ihre kompilierten Artefakte auf Amazon S3 bereit sind.

## Schritt 10: Laden Sie die Ausgabeartefakte herunter
<a name="tutorial-build-mf-download-output"></a>

In diesem Schritt laden Sie die Ausgabeartefakte von Amazon S3 herunter. Das Build-Tool von Rocket Software kann verschiedene Typen von ausführbaren Dateien erstellen. In diesem Tutorial generiert es gemeinsam genutzte Objekte.

1. Melden Sie sich bei der Amazon S3 S3-Konsole an.

1. Wählen Sie im Abschnitt **Buckets** role="bold"> den Namen Ihres Ausgabe-Buckets aus, zum Beispiel. `codebuild-regionId-accountId-output-bucket`

1. **Wählen Sie „Herunterladen“ role="bold">.**

1. Entpacken Sie die heruntergeladene -Datei. Navigieren Sie zum Zielordner, um die Build-Artefakte zu sehen. Dazu gehören die gemeinsam genutzten `.so` Linux-Objekte.

## Bereinigen von Ressourcen
<a name="tutorial-build-mf-clean"></a>

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 zum Löschen von Rollen finden Sie unter [Löschen von Rollen oder Instance-Profilen](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).

# Tutorial: WorkSpaces Anwendungen für die Verwendung mit Rocket Enterprise Analyzer und Rocket Enterprise Developer einrichten
<a name="set-up-appstream-mf"></a>

AWS Mainframe Modernization bietet mehrere Tools über Amazon WorkSpaces Applications. WorkSpaces Applications ist ein vollständig verwalteter, sicherer Anwendungs-Streaming-Dienst, mit dem Sie Desktop-Anwendungen an Benutzer streamen können, ohne Anwendungen neu schreiben zu müssen. WorkSpaces Applications bietet Benutzern sofortigen Zugriff auf die Anwendungen, die sie benötigen, und bietet eine reaktionsschnelle, flüssige Benutzererfahrung auf dem Gerät ihrer Wahl. Die Verwendung von WorkSpaces Anwendungen zum Hosten von Runtime Engine-spezifischen Tools gibt den Anwendungsteams von Kunden die Möglichkeit, die Tools direkt von ihren Webbrowsern aus zu verwenden und mit Anwendungsdateien zu interagieren, die entweder in Amazon S3 S3-Buckets oder Repositorys gespeichert sind. CodeCommit 

Informationen zur Browserunterstützung in WorkSpaces Anwendungen finden Sie unter [Systemanforderungen und Funktionsunterstützung (Webbrowser)](https://docs.aws.amazon.com/appstream2/latest/developerguide/requirements-and-features-web-browser-admin.html) im *Amazon WorkSpaces Applications Administration Guide*. Wenn Sie Probleme bei der Verwendung von WorkSpaces Anwendungen haben, finden Sie weitere Informationen unter [Troubleshooting AppStream 2.0-Benutzerprobleme](https://docs.aws.amazon.com/appstream2/latest/developerguide/troubleshooting-user-issues.html) im *Amazon WorkSpaces Applications Administration Guide*.

Dieses Dokument richtet sich an Mitglieder des Kundenserviceteams. Es beschreibt, wie Sie Flotten und Stacks von Amazon WorkSpaces Applications einrichten, um die Tools Rocket Enterprise Analyzer und Rocket Enterprise Developer zu hosten, die bei der AWS Mainframe-Modernisierung verwendet werden. Rocket Enterprise Analyzer wird normalerweise während der Assess-Phase und Rocket Enterprise Developer normalerweise während der Migrate- und Modernisierungsphase des Mainframe-Modernisierungsansatzes verwendet. AWS Wenn Sie sowohl Enterprise Analyzer als auch Enterprise Developer verwenden möchten, müssen Sie für jedes Tool separate Flotten und Stacks erstellen. Jedes Tool benötigt eine eigene Flotte und einen eigenen Stack, da die Lizenzbedingungen unterschiedlich sind.

**Wichtig**  
Die Schritte in diesem Tutorial basieren auf der herunterladbaren CloudFormation Vorlage [cfn-m2- appstream-fleet-ea-ed](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) .yml. 

**Topics**
+ [Voraussetzungen](#tutorial-aas-prerequisites)
+ [Schritt 1: Holen Sie sich die WorkSpaces Anwendungs-Images](#tutorial-aas-step1)
+ [Schritt 2: Erstellen Sie den Stapel mithilfe der CloudFormation Vorlage](#tutorial-aas-step2)
+ [Schritt 3: Erstellen Sie einen Benutzer in WorkSpaces Applications](#tutorial-aas-step3)
+ [Schritt 4: Melden Sie sich bei WorkSpaces Applications an](#tutorial-aas-step4)
+ [Schritt 5: Buckets in Amazon S3 verifizieren (optional)](#tutorial-aas-step5)
+ [Nächste Schritte](#tutorial-aas-next-steps)
+ [Bereinigen von Ressourcen](#tutorial-aas-cleanup)

## Voraussetzungen
<a name="tutorial-aas-prerequisites"></a>
+ [Laden Sie die Vorlage herunter: cfn-m2- .yml. appstream-fleet-ea-ed](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml)
+ Rufen Sie die ID Ihrer Standard-VPC und Sicherheitsgruppe ab. Weitere Informationen zur Standard-VPC finden Sie unter [Standard VPCs](https://docs.aws.amazon.com/vpc/latest/userguide/default-vpc.html) im *Amazon VPC-Benutzerhandbuch*. Weitere Informationen zur Standardsicherheitsgruppe finden Sie unter [Standard- und benutzerdefinierte Sicherheitsgruppen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/default-custom-security-groups.html) im *Amazon EC2 EC2-Benutzerhandbuch*. 
+ Stellen Sie sicher, dass Sie über die folgenden Berechtigungen verfügen:
  + Erstellen Sie Stacks, Flotten und Benutzer in WorkSpaces Anwendungen.
  + Erstellen Sie Stacks CloudFormation mithilfe einer Vorlage.
  + Erstellen Sie Buckets und laden Sie Dateien in Buckets in Amazon S3 hoch.
  + Anmeldeinformationen (`access_key_id`und`secret_access_key`) von IAM herunterladen.

## Schritt 1: Holen Sie sich die WorkSpaces Anwendungs-Images
<a name="tutorial-aas-step1"></a>

In diesem Schritt teilen Sie die WorkSpaces Anwendungs-Images für Enterprise Analyzer und Enterprise Developer mit Ihrem AWS Konto.

1. Öffnen Sie die AWS Mainframe Modernization Console 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 unter **Assets analysieren, entwickeln und erstellen** die Option **Assets mit meinem AWS Konto teilen** aus.

## Schritt 2: Erstellen Sie den Stapel mithilfe der CloudFormation Vorlage
<a name="tutorial-aas-step2"></a>

In diesem Schritt verwenden Sie die heruntergeladene CloudFormation Vorlage, um einen WorkSpaces Anwendungsstapel und eine Flotte für die Ausführung von Rocket Enterprise Analyzer zu erstellen. Sie können diesen Schritt später wiederholen, um einen weiteren WorkSpaces Anwendungsstapel und eine weitere Flotte für die Ausführung von Rocket Enterprise Developer zu erstellen, da jedes Tool eine eigene Flotte und einen eigenen Stack in WorkSpaces Applications benötigt. Weitere Informationen zu CloudFormation Stacks finden Sie unter [Arbeiten mit Stacks](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacks.html) im *AWS CloudFormation Benutzerhandbuch*.

**Anmerkung**  
AWS Die Mainframe-Modernisierung erhöht die Preise für WorkSpaces Standardanwendungen um eine zusätzliche Gebühr für die Nutzung von Enterprise Analyzer und Enterprise Developer. Weitere Informationen finden Sie unter Preise für die [AWS Mainframe-Modernisierung](https://aws.amazon.com/mainframe-modernization/pricing/).

1. Laden Sie bei Bedarf die [Vorlage cfn-m2- appstream-fleet-ea-ed .yml](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) herunter.

1. Öffnen Sie die CloudFormation Konsole und wählen Sie **Create Stack** and **with new resources** (Standard).

1. Wählen Sie **unter Voraussetzung — Vorlage vorbereiten** die Option **Vorlage ist bereit** aus.

1. Wählen **Sie unter Vorlage angeben** die Option **Vorlagendatei hochladen** aus.

1. Wählen Sie unter **Vorlagendatei hochladen** die Option **Datei auswählen aus** und laden Sie die Vorlage [cfn-m2- appstream-fleet-ea-ed .yml](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) hoch.

1. Wählen Sie **Weiter** aus.  
![\[Die Seite „Stack CloudFormation erstellen“ mit der ausgewählten Vorlage cfn-m2- .yml. appstream-fleet-ea-ed\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/cfn-create-stack.png)

1. **Geben Sie unter Stack-Details angeben** die folgenden Informationen ein:
   + Geben Sie im Feld **Stackname** einen Namen Ihrer Wahl ein. Beispiel, **m2-ea**.
   + In **AppStreamApplication**, wähle **ea** aus.
   + Wählen Sie in **AppStreamFleetSecurityGroup**die Standardsicherheitsgruppe Ihrer Standard-VPC aus.
   + Wählen Sie **AppStreamFleetVpcSubnet**unter ein Subnetz innerhalb Ihrer Standard-VPC aus.
   + Wählen Sie **AppStreamImageName**unter das Bild aus, das mit beginnt. `m2-enterprise-analyzer` Dieses Bild enthält die derzeit unterstützte Version des Rocket Enterprise Analyzer-Tools.
   + Akzeptieren Sie die Standardwerte für die anderen Felder und wählen Sie dann **Weiter**.  
![\[Die Seite „Stack-Details CloudFormation angeben“ mit den ausgefüllten Enterprise Analyzer-Optionen.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/cfn-specify-stack-details.png)

1. Akzeptieren Sie alle Standardwerte und wählen Sie dann erneut **Weiter**.

1. Stellen Sie bei der **Überprüfung** sicher, dass alle Parameter Ihren Vorstellungen entsprechen.

1. Scrollen Sie nach unten, wählen Sie **Ich bestätige, dass AWS IAM-Ressourcen mit benutzerdefinierten Namen erstellen CloudFormation könnte**, und wählen Sie **Create Stack** aus.

Es dauert zwischen 20 und 30 Minuten, bis der Stack und die Flotte erstellt sind. Sie können „**Aktualisieren**“ wählen, um die CloudFormation Ereignisse zu sehen, sobald sie eintreten. 

## Schritt 3: Erstellen Sie einen Benutzer in WorkSpaces Applications
<a name="tutorial-aas-step3"></a>

Während Sie darauf warten, CloudFormation dass die Erstellung des Stacks abgeschlossen ist, können Sie in WorkSpaces Applications einen oder mehrere Benutzer erstellen. Diese Benutzer sind diejenigen, die Enterprise Analyzer in WorkSpaces Applications verwenden werden. Sie müssen für jeden Benutzer eine E-Mail-Adresse angeben und sicherstellen, dass jeder Benutzer über ausreichende Berechtigungen verfügt, um Buckets in Amazon S3 zu erstellen, Dateien in einen Bucket hochzuladen und einen Link zu einem Bucket zu erstellen, um dessen Inhalt zuzuordnen.

1. Öffnen Sie die WorkSpaces Anwendungskonsole.

1. Wählen Sie in der linken Navigationsleiste **Benutzerpool** aus.

1. Wählen Sie **Create user** (Benutzer erstellen) aus.

1. Geben Sie eine E-Mail-Adresse, an die der Benutzer eine E-Mail-Einladung zur Nutzung von WorkSpaces Anwendungen erhalten kann, sowie einen Vor- und Nachnamen an und wählen Sie **Benutzer erstellen** aus.

1. Wiederholen Sie den Vorgang bei Bedarf, um weitere Benutzer zu erstellen. Die E-Mail-Adresse für jeden Benutzer muss eindeutig sein.

Weitere Informationen zum Erstellen von WorkSpaces Anwendungsbenutzern finden Sie unter [WorkSpaces Applications User Pools](https://docs.aws.amazon.com/appstream2/latest/developerguide/user-pool.html) im *Amazon WorkSpaces Applications Administration Guide*.

Wenn Sie mit der Erstellung des Stacks CloudFormation fertig sind, können Sie den Benutzer, den Sie erstellt haben, dem Stack wie folgt zuweisen:

1. Öffnen Sie die WorkSpaces Anwendungskonsole.

1. Wählen Sie den Benutzernamen.

1. Wählen Sie **Aktion** und dann **Stapel zuweisen**.

1. Wählen **Sie unter Stapel zuweisen** den Stapel aus, der mit beginnt`m2-appstream-stack-ea`.

1. Wählen Sie **Assign stack**.  
![\[Auf der Seite WorkSpaces Applications Assign Stack werden ein Benutzer und der Enterprise Analyzer-Stack angezeigt, der zugewiesen werden soll.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/aas-assign-stack.png)

Wenn Sie einem Stack einen Benutzer zuweisen, sendet WorkSpaces Applications eine E-Mail an den Benutzer an die von Ihnen angegebene Adresse. Diese E-Mail enthält einen Link zur Anmeldeseite WorkSpaces für Anwendungen.

## Schritt 4: Melden Sie sich bei WorkSpaces Applications an
<a name="tutorial-aas-step4"></a>

In diesem Schritt melden Sie sich über den Link in der E-Mail, die WorkSpaces Applications an den Benutzer gesendet hat, den Sie erstellt haben, bei WorkSpaces Applications an[Schritt 3: Erstellen Sie einen Benutzer in WorkSpaces Applications](#tutorial-aas-step3).

1. Melden Sie sich über den Link in der von WorkSpaces Applications gesendeten E-Mail bei WorkSpaces Applications an.

1. Ändern Sie Ihr Passwort, wenn Sie dazu aufgefordert werden. Der Bildschirm „ WorkSpaces Anwendungen“, der Ihnen angezeigt wird, ähnelt dem folgenden:  
![\[Ein Beispiel WorkSpaces für einen Anwendungs-Anmeldebildschirm mit dem Desktop-Symbol.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/aas-login-screen.png)

1. Wählen Sie **Desktop**.

1. Wählen Sie in der Taskleiste **Suchen** und geben Sie die Eingabetaste ein**D:**, um zum Home-Ordner zu navigieren.
**Anmerkung**  
Wenn Sie diesen Schritt überspringen, wird möglicherweise eine `Device not ready` Fehlermeldung angezeigt, wenn Sie versuchen, auf den Basisordner zuzugreifen.

Wenn Sie Probleme bei der Anmeldung bei WorkSpaces Anwendungen haben, können Sie Ihre WorkSpaces Anwendungsflotte jederzeit neu starten und versuchen, sich mithilfe der folgenden Schritte erneut anzumelden.

1. Öffnen Sie die WorkSpaces Anwendungskonsole.

1. Wählen Sie in der linken Navigationsleiste **Flotten** aus.

1. Wählen Sie die Flotte aus, die Sie verwenden möchten.

1. Wählen Sie „**Aktion“** und anschließend „**Stopp**“.

1. Warten Sie, bis die Flotte stoppt.

1. Wählen Sie „**Aktion“** und anschließend „**Start**“.

Dieser Vorgang kann etwa 10 Minuten dauern.

## Schritt 5: Buckets in Amazon S3 verifizieren (optional)
<a name="tutorial-aas-step5"></a>

Eine der Aufgaben, die durch die CloudFormation Vorlage, die Sie zur Erstellung des Stacks verwendet haben, erledigt wurde, bestand darin, zwei Buckets in Amazon S3 zu erstellen, die zum Speichern und Wiederherstellen von Benutzerdaten und Anwendungseinstellungen über Arbeitssitzungen hinweg erforderlich sind. Diese Buckets lauten wie folgt:
+ Der Name beginnt mit`appstream2-`. Dieser Bucket ordnet Daten Ihrem Home-Ordner in WorkSpaces Applications (`D:\PhotonUser\My Files\Home Folder`) zu.
**Anmerkung**  
Der Home-Ordner ist für eine bestimmte E-Mail-Adresse eindeutig und wird von allen Flotten und Stacks eines bestimmten AWS Kontos gemeinsam genutzt. Der Name des Home-Ordners ist ein SHA256 Hash der E-Mail-Adresse des Benutzers und wird in einem Pfad gespeichert, der auf diesem Hash basiert.
+ Der Name beginnt mit`appstream-app-settings-`. Dieser Bucket enthält Benutzersitzungsinformationen für WorkSpaces Anwendungen und umfasst Einstellungen wie Browser-Favoriten, IDE- und Anwendungsverbindungsprofile sowie Anpassungen der Benutzeroberfläche. Weitere Informationen finden Sie unter [How Application Settings Persistence Works](https://docs.aws.amazon.com/appstream2/latest/developerguide/how-it-works-app-settings-persistence.html) im *Amazon WorkSpaces Applications Administration Guide*.

Gehen Sie wie folgt vor, um zu überprüfen, ob die Buckets erstellt wurden:

1. Öffnen Sie die Amazon S3-Konsole.

1. Wählen Sie in der linken Navigationsleiste **Buckets** aus.

1. Geben **Sie im Feld Buckets nach Namen** suchen ein, um die **appstream** Liste zu filtern.

Wenn Sie die Buckets sehen, sind keine weiteren Maßnahmen erforderlich. Seien Sie sich nur bewusst, dass die Buckets existieren. Wenn Sie die Buckets nicht sehen, ist entweder die Ausführung der CloudFormation Vorlage noch nicht abgeschlossen, oder es ist ein Fehler aufgetreten. Gehen Sie zur CloudFormation Konsole und überprüfen Sie die Meldungen zur Stack-Erstellung.

## Nächste Schritte
<a name="tutorial-aas-next-steps"></a>

Nachdem die WorkSpaces Anwendungsinfrastruktur eingerichtet ist, können Sie Enterprise Analyzer einrichten und mit der Nutzung beginnen. Weitere Informationen finden Sie unter [Tutorial: Enterprise Analyzer für WorkSpaces Anwendungen einrichten](set-up-ea.md). Sie können Enterprise Developer auch einrichten. Weitere Informationen finden Sie unter [Tutorial: Rocket Enterprise Developer für WorkSpaces Anwendungen einrichten](set-up-ed.md).

## Bereinigen von Ressourcen
<a name="tutorial-aas-cleanup"></a>

Das Verfahren zum Bereinigen des erstellten Stacks und der erstellten Flotten ist unter [ WorkSpaces Anwendungsflotte und -stapel erstellen](https://docs.aws.amazon.com/appstream2/latest/developerguide/set-up-stacks-fleets.html) beschrieben.

Wenn die WorkSpaces Anwendungsobjekte gelöscht wurden, kann der Kontoadministrator gegebenenfalls auch die Amazon S3 S3-Buckets für Anwendungseinstellungen und Basisordner bereinigen.

**Anmerkung**  
Der Basisordner für einen bestimmten Benutzer ist für alle Flotten einzigartig. Daher müssen Sie ihn möglicherweise behalten, wenn andere WorkSpaces Anwendungsstapel in demselben Konto aktiv sind.

Und schließlich erlaubt WorkSpaces Applications derzeit nicht, Benutzer über die Konsole zu löschen. Stattdessen müssen Sie die Service-API mit der CLI verwenden. Weitere Informationen finden Sie unter [Benutzerpool-Administration](https://docs.aws.amazon.com/appstream2/latest/developerguide/user-pool-admin.html) im *Amazon WorkSpaces Applications Administration Guide*.

# Tutorial: Vorlagen mit Rocket Enterprise Developer (ehemals Micro Focus Enterprise Developer) verwenden
<a name="tutorial-templates-ed"></a>

Dieses Tutorial beschreibt, wie Sie Vorlagen und vordefinierte Projekte mit Rocket Enterprise Developer verwenden. Es deckt drei Anwendungsfälle ab. In allen Anwendungsfällen wird der im Beispiel enthaltene BankDemo Beispielcode verwendet. Um das Beispiel herunterzuladen, wählen Sie [https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip](https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip).

**Wichtig**  
Wenn Sie die Version von Enterprise Developer für Windows verwenden, können die vom Compiler generierten Binärdateien nur auf dem Enterprise Server ausgeführt werden, der im Lieferumfang von Enterprise Developer enthalten ist. Sie können sie nicht unter der AWS Mainframe Modernization Runtime ausführen, die auf Linux basiert.

**Topics**
+ [Anwendungsfall 1 — Verwendung der COBOL-Projektvorlage, die Quellkomponenten enthält](#tutorial-templates-ed-step1)
+ [Anwendungsfall 2 — Verwendung der COBOL-Projektvorlage ohne Quellkomponenten](#tutorial-templates-ed-step2)
+ [Anwendungsfall 3 — Verwendung des vordefinierten COBOL-Projekts, das auf die Quellordner verweist](#tutorial-templates-ed-step3)
+ [Verwenden der JSON-Vorlage für die Regionsdefinition](#tutorial-templates-ed-step4)

## Anwendungsfall 1 — Verwendung der COBOL-Projektvorlage, die Quellkomponenten enthält
<a name="tutorial-templates-ed-step1"></a>

Bei diesem Anwendungsfall müssen Sie die Quellkomponenten als Teil der Schritte vor der Einrichtung der Demo in die Verzeichnisstruktur des Templates kopieren. In der wurde [https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip](https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip)dies gegenüber der ursprünglichen `AWSTemplates.zip` Lieferung geändert, um zu vermeiden, dass zwei Kopien der Quelle vorhanden sind.

1. Starten Sie Enterprise Developer und geben Sie den ausgewählten Workspace an.  
![\[Der Eclipse-Launcher mit einem ausgewählten Workspace.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-uc1-step1.png)

1. Wählen Sie in der Ansicht des **Application Explorers** in der Strukturansicht des **Enterprise Development-Projekts** **im Kontextmenü die Option Neues Projekt aus Vorlage** aus.  
![\[Das Kontextmenü der Strukturansicht des Enterprise Development-Projekts.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-uc1-step2.png)

1. Geben Sie die Vorlagenparameter wie in der Abbildung gezeigt ein.
**Anmerkung**  
Der Vorlagenpfad bezieht sich darauf, wo die ZIP-Datei extrahiert wurde.  
![\[Das Feld Vorlagenparameter eingeben, in dem der Pfad und der Projektname ausgefüllt sind.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-uc1-step3.png)

1. Wenn Sie OK wählen, wird auf der Grundlage der bereitgestellten Vorlage ein lokales Eclipse-Entwicklungsprojekt mit einer vollständigen Quell- und Ausführungsumgebungsstruktur erstellt.  
![\[Das Eclipse-Projekt für die lokale Entwicklung zeigt seine Struktur.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-uc1-step4.png)

   Die `System` Struktur enthält eine vollständige Ressourcendefinitionsdatei mit den erforderlichen Einträgen für BANKDEMO, den erforderlichen Katalog mit hinzugefügten Einträgen und den entsprechenden ASCII-Datendateien.

   Da die Quellvorlagenstruktur alle Quellelemente enthält, werden diese Dateien in das lokale Projekt kopiert und daher automatisch in Enterprise Developer erstellt.

## Anwendungsfall 2 — Verwendung der COBOL-Projektvorlage ohne Quellkomponenten
<a name="tutorial-templates-ed-step2"></a>

Die Schritte 1 bis 3 sind identisch mit. [Anwendungsfall 1 — Verwendung der COBOL-Projektvorlage, die Quellkomponenten enthält](#tutorial-templates-ed-step1) 

Die `System` Struktur in diesem Anwendungsfall enthält auch eine vollständige Ressourcendefinitionsdatei mit den erforderlichen Einträgen für BankDemo, den erforderlichen Katalog mit hinzugefügten Einträgen und den entsprechenden ASCII-Datendateien.

Die Quellstruktur der Vorlage enthält jedoch keine Komponenten. Sie müssen diese aus dem Quell-Repository, das Sie verwenden, in das Projekt importieren.

1. Wählen Sie den Projektnamen. Wählen Sie im entsprechenden Kontextmenü die Option **Import**.  
![\[Das Projekt-Kontextmenü mit ausgewähltem Import.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-uc2-step4.png)

1. Wählen Sie im daraufhin angezeigten Dialogfeld im Bereich **Allgemein die** Option **Dateisystem** und dann Weiter.  
![\[Das Importfeld mit ausgewähltem Dateisystem.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-uc2-step5.png)

1. Füllen Sie das Feld **Aus dem Verzeichnis aus**, indem Sie das Dateisystem so durchsuchen, dass es auf den Repository-Ordner verweist. Wählen Sie alle Ordner aus, die Sie importieren möchten, z. B. `sources` Das `Into folder` Feld wird vorab ausgefüllt. Wählen Sie **Finish** (Abschließen).   
![\[Das Dateisystem-Feld mit dem erweiterten BankDemo Verzeichnis.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-uc2-step6.png)

   Nachdem die Quellvorlagenstruktur alle Quellelemente enthält, werden sie automatisch in Enterprise Developer erstellt.

## Anwendungsfall 3 — Verwendung des vordefinierten COBOL-Projekts, das auf die Quellordner verweist
<a name="tutorial-templates-ed-step3"></a>

1. Starten Sie Enterprise Developer und geben Sie den ausgewählten Workspace an.  
![\[Der Eclipse-Launcher mit einem ausgewählten Workspace.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-uc3-step1.png)

1. Wählen Sie im Menü **Datei** die Option **Import** aus.  
![\[Das Datei-Menü mit ausgewähltem Import.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-uc3-step2.png)

1. Wählen Sie im daraufhin angezeigten Dialogfeld unter **Allgemein die** Option **Projekte aus Ordner oder Archiv** und **dann Weiter**.  
![\[Das Importfeld mit ausgewählten Projekten aus einem Ordner oder Archiv.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-uc3-step3.png)

1. Füllen Sie die **Importquelle** aus, wählen Sie **Verzeichnis** und durchsuchen Sie das Dateisystem, um den vordefinierten Projektordner auszuwählen. Das darin enthaltene Projekt enthält Links zu den Quellordnern im selben Repository.  
![\[Die Importprojekte aus dem Dateisystem oder der Archivbox mit dem eingegebenen Pfad zur Importquelle.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-uc3-step4.png)

   Wählen Sie **Finish** (Abschließen).

   Da das Projekt durch die Links zum Quellordner aufgefüllt wird, wird der Code automatisch erstellt.

## Verwenden der JSON-Vorlage für die Regionsdefinition
<a name="tutorial-templates-ed-step4"></a>

1. Wechseln Sie zur Server Explorer-Ansicht. Wählen Sie im entsprechenden Kontextmenü die Option **Administrationsseite öffnen**, wodurch der Standardbrowser gestartet wird.  
![\[Das Server-Explorer-Kontextmenü mit ausgewählter geöffneter Administrationsseite.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-json-admin-page.png)

1. Wählen Sie im daraufhin angezeigten Fenster Enterprise Server Common Web Administration (ESCWA) die Option **Import** aus.  
![\[Das Fenster Enterprise Server Common Web Administration mit ausgewähltem Import.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-json-import.png)

1. Wählen Sie den **JSON-Importtyp** und **dann Weiter**.  
![\[Das Feld „Importtyp auswählen“ mit ausgewähltem JSON.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-json-import-type.png)

1. Laden Sie die bereitgestellte `BANKDEMO.JSON` Datei hoch.  
![\[Das Feld „Datei zum Hochladen auswählen“ mit der ausgewählten BANKDEMO-Datei.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-json-upload.png)

   Sobald Sie die Auswahl getroffen haben, wählen Sie **Weiter**.  
![\[Das Feld „Regionen auswählen“ enthält die Option „Ports von Endpunkten löschen“, die nicht ausgewählt sind.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-json-next.png)

   Stellen Sie sicher, dass im Bereich **„Regionen auswählen**“ die Option „**Anschlüsse von Endpunkten löschen**“ nicht aktiviert ist, und wählen Sie dann in den Bedienfeldern „**Weiter**“, bis der Bereich „**Import durchführen**“ angezeigt wird. Wählen Sie dann im linken Navigationsbereich **Import** aus.

   Klicken Sie abschließend auf **Fertig stellen**. Die BANKDEMO-Region wird dann der Serverliste hinzugefügt.  
![\[Die Region und die Serverliste BankDemo wurden hinzugefügt.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-json-server-list.png)

1. Navigieren Sie zu den **Allgemeinen Eigenschaften** für die Region BANKDEMO.

1. Scrollen Sie zum Abschnitt **Konfiguration**.

1. Die ESP-Umgebungsvariable muss auf den `System` Ordner gesetzt werden, der für das in den vorherigen Schritten erstellte Eclipse-Projekt relevant ist. Das sollte sein`workspacefolder/projectname/System`.  
![\[Der Konfigurationsabschnitt mit der angezeigten ESP-Variablen.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-json-ESP.png)

1. Klicken Sie auf **Apply (Anwenden)**.

   Die Region ist jetzt vollständig für die Ausführung in Verbindung mit dem Eclipse-COBOL-Projekt konfiguriert.

1. Verknüpfen Sie abschließend wieder in Enterprise Developer die importierte Region mit dem Projekt.  
![\[Im Kontextmenü des Projekts ist die Option Dem Projekt zugeordnet ausgewählt.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ed-json-associate.png)

   Die Enterprise Developer-Umgebung ist jetzt mit einer vollständigen, funktionierenden Version von einsatzbereit BankDemo. Sie können Code für die Region bearbeiten, kompilieren und debuggen.
**Wichtig**  
Wenn Sie die Version von Enterprise Developer für Windows verwenden, können die vom Compiler generierten Binärdateien nur auf dem Enterprise Server ausgeführt werden, der im Lieferumfang von Enterprise Developer enthalten ist. Sie können sie nicht unter der AWS Mainframe Modernization Runtime ausführen, die auf Linux basiert.

# Tutorial: Enterprise Analyzer für WorkSpaces Anwendungen einrichten
<a name="set-up-ea"></a>

Dieses Tutorial beschreibt, wie Sie Rocket Enterprise Analyzer (früher Micro Focus Enterprise Analyzer) einrichten, um eine oder mehrere Mainframe-Anwendungen zu analysieren. Das Enterprise Analyzer-Tool bietet mehrere Berichte, die auf der Analyse des Anwendungsquellcodes und der Systemdefinitionen basieren.

Dieses Setup wurde entwickelt, um die Zusammenarbeit im Team zu fördern. Bei der Installation wird ein Amazon S3 S3-Bucket verwendet, um den Quellcode mit virtuellen Laufwerken zu teilen. Dabei wird [Rclone](https://rclone.org/) () auf dem Windows-Computer verwendet. Mit einer gemeinsamen Amazon RDS-Instance, auf der [PostgreSQL](https://www.postgresql.org/) ausgeführt wird, kann jedes Mitglied des Teams auf alle angeforderten Berichte zugreifen.

Teammitglieder können die virtuelle Amazon S3 S3-gesicherte Festplatte auch auf ihren persönlichen Computern mounten und den Quell-Bucket von ihren Workstations aus aktualisieren. Sie können möglicherweise Skripts oder jede andere Form der Automatisierung auf ihren Computern verwenden, wenn sie mit anderen internen Systemen vor Ort verbunden sind.

Das Setup basiert auf den WorkSpaces Windows-Anwendungsabbildern, die AWS Mainframe Modernization dem Kunden zur Verfügung stellt. Die Einrichtung basiert auch auf der Erstellung von WorkSpaces Anwendungsflotten und -stapeln, wie unter beschrieben. [Tutorial: WorkSpaces Anwendungen für die Verwendung mit Rocket Enterprise Analyzer und Rocket Enterprise Developer einrichten](set-up-appstream-mf.md)

**Wichtig**  
Bei den Schritten in diesem Tutorial wird davon ausgegangen, dass Sie WorkSpaces Anwendungen mit der herunterladbaren CloudFormation Vorlage [cfn-m2](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) - .yml einrichten. appstream-fleet-ea-ed Weitere Informationen finden Sie unter [Tutorial: WorkSpaces Anwendungen für die Verwendung mit Rocket Enterprise Analyzer und Rocket Enterprise Developer einrichten](set-up-appstream-mf.md).  
Um die Schritte in diesem Tutorial ausführen zu können, müssen Sie Ihre Enterprise Analyzer-Flotte und Ihren Enterprise Analyzer-Stack eingerichtet haben und diese müssen laufen.

Eine vollständige Beschreibung der Funktionen und Leistungen von Enterprise Analyzer finden Sie in der [Enterprise Analyzer-Dokumentation](https://www.microfocus.com/documentation/enterprise-analyzer/) auf der Website von Rocket Software (ehemals Micro Focus).

## Inhalt des Bildes
<a name="set-up-ea-image-contents"></a>

Neben der Enterprise Analyzer-Anwendung selbst enthält das Image die folgenden Tools und Bibliotheken.

Tools von Drittanbietern
+ [Python](https://www.python.org/)
+ [Rclone](https://rclone.org/)
+ [pgAdmin](https://www.pgadmin.org/)
+ [git-scm](https://git-scm.com/)
+ [PostgreSQL ODBC-Treiber](https://odbc.postgresql.org/)

Bibliotheken in `C:\Users\Public`
+ BankDemo Quellcode und Projektdefinition für Enterprise Developer:`m2-bankdemo-template.zip`.
+ MFA-Installationspaket für den Mainframe:. `mfa.zip` Weitere Informationen finden Sie unter [Mainframe Access Overview](https://www.microfocus.com/documentation/enterprise-developer/30pu12/ED-VS2012/BKMMMMINTRS001.html) in der *Micro Focus Enterprise* Developer-Dokumentation.
+ Befehls- und Konfigurationsdateien für Rclone (Anweisungen zu deren Verwendung in den Tutorials): `m2-rclone.cmd` und. `m2-rclone.conf`

**Topics**
+ [Inhalt des Bildes](#set-up-ea-image-contents)
+ [Voraussetzungen](#tutorial-ea-prerequisites)
+ [Schritt 1: Einrichtung](#tutorial-ea-step1)
+ [Schritt 2: Erstellen Sie den Amazon S3 S3-basierten virtuellen Ordner unter Windows](#tutorial-ea-step2)
+ [Schritt 3: Erstellen Sie eine ODBC-Quelle für die Amazon RDS-Instance](#tutorial-ea-step3)
+ [Nachfolgende Sitzungen](#tutorial-ea-step4)
+ [Problembehandlung bei der Workspace-Verbindung](#tutorial-ea-step5)
+ [Bereinigen von Ressourcen](#tutorial-ea-clean)

## Voraussetzungen
<a name="tutorial-ea-prerequisites"></a>
+ Laden Sie den Quellcode und die Systemdefinitionen für die Kundenanwendung, die Sie analysieren möchten, in einen S3-Bucket hoch. Zu den Systemdefinitionen gehören CICS CSD, DB2 Objektdefinitionen usw. Sie können innerhalb des Buckets eine Ordnerstruktur erstellen, die für die Organisation der Anwendungsartefakte sinnvoll ist. Wenn Sie das BankDemo Beispiel beispielsweise entpacken, hat es die folgende Struktur:

  ```
  demo
       |--> jcl
       |--> RDEF
       |--> transaction
       |--> xa
  ```
+ Erstellen und starten Sie eine Amazon RDS-Instance, auf der PostgreSQL ausgeführt wird. Diese Instance speichert die von Enterprise Analyzer erstellten Daten und Ergebnisse. Sie können diese Instanz mit allen Mitgliedern des Anwendungsteams teilen. Erstellen Sie außerdem ein leeres Schema mit dem Namen `m2_ea` (oder einem anderen geeigneten Namen) in der Datenbank. Definieren Sie Anmeldeinformationen für autorisierte Benutzer, die es ihnen ermöglichen, Elemente in diesem Schema zu erstellen, einzufügen, zu aktualisieren und zu löschen. Sie können den Datenbanknamen, die URL des Serverendpunkts und den TCP-Port von der Amazon RDS-Konsole oder vom Kontoadministrator abrufen.
+ Stellen Sie sicher, dass Sie den programmatischen Zugriff auf Ihre AWS-Konto eingerichtet haben. *Weitere Informationen finden Sie unter [Programmgesteuerter Zugriff](https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys) in der.Allgemeine Amazon Web Services-Referenz*

## Schritt 1: Einrichtung
<a name="tutorial-ea-step1"></a>

1. Starten Sie eine Sitzung mit WorkSpaces Applications mit der URL, die Sie in der Willkommens-E-Mail von WorkSpaces Applications erhalten haben.

1. Verwenden Sie Ihre E-Mail-Adresse als Benutzer-ID und definieren Sie Ihr permanentes Passwort.

1. Wählen Sie den Enterprise Analyzer-Stack aus.

1. Wählen Sie auf der Menüseite „ WorkSpaces Anwendungen“ die Option **Desktop** aus, um den Windows-Desktop aufzurufen, auf dem die Flotte streamt.

## Schritt 2: Erstellen Sie den Amazon S3 S3-basierten virtuellen Ordner unter Windows
<a name="tutorial-ea-step2"></a>

**Anmerkung**  
Wenn Sie Rclone bereits in der Vorschauversion der AWS Mainframe-Modernisierung verwendet haben, müssen Sie `m2-rclone.cmd` auf die neuere Version aktualisieren, die sich unter befindet. `C:\Users\Public`

1. Kopieren Sie die bereitgestellten `m2-rclone.cmd` Dateien `m2-rclone.conf` und mit `C:\Users\Public` dem `C:\Users\PhotonUser\My Files\Home Folder` Datei-Explorer in Ihren Home-Ordner.

1. Aktualisieren Sie die `m2-rclone.conf` Konfigurationsparameter mit Ihrem AWS Zugriffsschlüssel und dem entsprechenden Geheimnis sowie Ihrem AWS-Region.

   ```
   [m2-s3]
   type = s3
   provider = AWS
   access_key_id = YOUR-ACCESS-KEY
   secret_access_key = YOUR-SECRET-KEY
   region = YOUR-REGION
   acl = private
   server_side_encryption = AES256
   ```

1. Nehmen Sie in `m2-rclone.cmd` die folgenden Änderungen vor:
   + Wechseln Sie `amzn-s3-demo-bucket` zu Ihrem Amazon S3 S3-Bucket-Namen. Beispiel, `m2-s3-mybucket`.
   + Wechseln Sie `your-s3-folder-key` zu Ihrem Amazon S3 S3-Bucket-Key. Beispiel, `myProject`.
   + Wechseln Sie `your-local-folder-path` zum Pfad des Verzeichnisses, in das die Anwendungsdateien aus dem Amazon S3 S3-Bucket synchronisiert werden sollen, der sie enthält. Beispiel, `D:\PhotonUser\My Files\Home Folder\m2-new`. Dieses synchronisierte Verzeichnis muss ein Unterverzeichnis des Home-Ordners sein, damit WorkSpaces Anwendungen es beim Start und Ende der Sitzung ordnungsgemäß sichern und wiederherstellen können.

   ```
   :loop
   timeout /T 10
   "C:\Program Files\rclone\rclone.exe" sync m2-s3:amzn-s3-demo-bucket/your-s3-folder-key "D:\PhotonUser\My Files\Home Folder\your-local-folder-path" --config "D:\PhotonUser\My Files\Home Folder\m2-rclone.conf"
   goto :loop
   ```

1. Öffnen Sie eine Windows-Eingabeaufforderung, geben Sie bei `C:\Users\PhotonUser\My Files\Home Folder` Bedarf eine CD ein und führen Sie den Befehl aus. `m2-rclone.cmd` Dieses Befehlsskript führt eine Endlosschleife aus und synchronisiert Ihren Amazon S3 S3-Bucket und Ihren Schlüssel alle 10 Sekunden mit dem lokalen Ordner. Sie können das Timeout nach Bedarf anpassen. Sie sollten den Quellcode der Anwendung sehen, der sich im Amazon S3 S3-Bucket im Windows-Datei-Explorer befindet.

Um dem Set, an dem Sie gerade arbeiten, neue Dateien hinzuzufügen oder bestehende zu aktualisieren, laden Sie die Dateien in den Amazon S3 S3-Bucket hoch. Sie werden dann bei der nächsten unter definierten Iteration mit Ihrem Verzeichnis synchronisiert. `m2-rclone.cmd` Wenn Sie einige Dateien löschen möchten, löschen Sie sie ebenfalls aus dem Amazon S3 S3-Bucket. Beim nächsten Synchronisierungsvorgang werden sie aus Ihrem lokalen Verzeichnis gelöscht.

## Schritt 3: Erstellen Sie eine ODBC-Quelle für die Amazon RDS-Instance
<a name="tutorial-ea-step3"></a>

1. **Um das EA\$1Admin-Tool zu starten, navigieren Sie zum Anwendungsauswahlmenü in der oberen linken Ecke des Browserfensters und wählen Sie MF EA\$1Admin.**

1. ****Wählen Sie im Menü „**Verwalten**“ die Option „**ODBC-Datenquellen**“ und anschließend auf der Registerkarte „Benutzer-DSN“ die Option „Hinzufügen“.****

1. **Wählen Sie im Dialogfeld Neue Datenquelle erstellen den **PostgreSQL-Unicode-Treiber** aus, und klicken Sie dann auf Fertig stellen.**

1. Definieren Sie im Dialogfeld **PostgreSQL Unicode ODBC Driver (psqlODBC) Setup** den gewünschten Datenquellennamen und notieren Sie sich diesen. Vervollständigen Sie die folgenden Parameter mit den Werten aus der RDS-Instanz, die Sie zuvor erstellt haben:  
**Description**  
Optionale Beschreibung, die Ihnen hilft, diese Datenbankverbindung schnell zu identifizieren.  
**Datenbank**  
Die Amazon RDS-Datenbank, die Sie zuvor erstellt haben.  
**Server**  
Der Amazon RDS-Endpunkt.  
**Port**  
Der Amazon RDS-Port.  
**Benutzername**  
Wie in der Amazon RDS-Instance definiert.  
**Passwort**  
Wie in der Amazon RDS-Instance definiert.

1. Wählen Sie **Test**, um zu überprüfen, ob die Verbindung zu Amazon RDS erfolgreich ist, und wählen Sie dann **Speichern**, um Ihren neuen Benutzer-DSN zu speichern.

1. Warten Sie, bis Sie die Meldung sehen, die bestätigt, dass der richtige Workspace erstellt wurde, und wählen Sie dann **OK**, um mit ODBC-Datenquellen fertig zu werden und das EA\$1Admin-Tool zu schließen.

1. Navigieren Sie erneut zum Anwendungsauswahlmenü und wählen Sie Enterprise Analyzer, um das Tool zu starten. Wählen Sie „**Neu erstellen**“. 

1. Geben Sie im Fenster Workspace-Konfiguration Ihren Workspace-Namen ein und definieren Sie dessen Speicherort. Der Arbeitsbereich kann die Amazon S3 S3-basierte Festplatte sein, wenn Sie mit dieser Konfiguration arbeiten, oder Ihr Home-Ordner, wenn Sie dies bevorzugen.

1. **Wählen Sie „Andere Datenbank** auswählen“, um eine Verbindung zu Ihrer Amazon RDS-Instance herzustellen.

1. Wählen Sie das **Postgre-Symbol** aus den Optionen und klicken Sie dann **auf OK**.

1. Geben Sie für die Windows-Einstellungen unter **Optionen — Verbindungsparameter definieren** den Namen der Datenquelle ein, die Sie erstellt haben. Geben Sie außerdem den Datenbanknamen, den Schemanamen, den Benutzernamen und das Passwort ein. Wählen Sie **OK** aus.

1. Warten Sie, bis Enterprise Analyzer alle Tabellen, Indizes usw. erstellt hat, die zum Speichern der Ergebnisse benötigt werden. Dieser Vorgang kann einige Minuten dauern. Enterprise Analyzer bestätigt, wann die Datenbank und der Workspace einsatzbereit sind.

1. Navigieren Sie erneut zum Anwendungsauswahlmenü und wählen Sie Enterprise Analyzer, um das Tool zu starten.

1. Das Enterprise Analyzer-Startfenster wird am neuen, ausgewählten Workspace-Speicherort angezeigt. Wählen Sie **OK** aus.

1. Navigieren Sie im linken Bereich zu Ihrem Repository, wählen Sie den Repository-Namen und wählen Sie **Dateien/Ordner zu Ihrem Workspace hinzufügen**. Wählen Sie den Ordner aus, in dem Ihr Anwendungscode gespeichert ist, um ihn dem Workspace hinzuzufügen. Sie können den vorherigen BankDemo Beispielcode verwenden, wenn Sie möchten. Wenn Enterprise Analyzer Sie auffordert, diese Dateien zu verifizieren, wählen Sie **Verify**, um den ersten Enterprise Analyzer-Bestätigungsbericht zu starten. Je nach Größe Ihrer Anwendung kann es einige Minuten dauern, bis der Vorgang abgeschlossen ist.

1. Erweitere deinen Workspace, um die Dateien und Ordner zu sehen, die du dem Workspace hinzugefügt hast. Die Objekttypen und zyklomatischen Komplexitätsberichte sind auch im oberen Quadranten des **Chart Viewer-Fensters** sichtbar.

Sie können Enterprise Analyzer jetzt für alle erforderlichen Aufgaben verwenden.

## Nachfolgende Sitzungen
<a name="tutorial-ea-step4"></a>

1. Starten Sie eine Sitzung mit WorkSpaces Applications mit der URL, die Sie in der Willkommens-E-Mail von WorkSpaces Applications erhalten haben.

1. Melden Sie sich mit Ihrer E-Mail-Adresse und Ihrem permanenten Passwort an.

1. Wählen Sie den Enterprise Analyzer-Stack aus.

1. Starten Sie`Rclone`, um eine Verbindung zur Amazon S3 S3-gesicherten Festplatte herzustellen, wenn Sie diese Option verwenden, um die Workspace-Dateien gemeinsam zu nutzen.

1. Starten Sie Enterprise Analyzer, um Ihre Aufgaben zu erledigen.

## Problembehandlung bei der Workspace-Verbindung
<a name="tutorial-ea-step5"></a>

Wenn Sie versuchen, erneut eine Verbindung zu Ihrem Enterprise Analyzer-Workspace herzustellen, wird möglicherweise ein Fehler wie dieser angezeigt:

```
Cannot access the workspace directory D:\PhotonUser\My Files\Home Folder\EA_BankDemo. The workspace has been created on a non-shared disk of the EC2AMAZ-E6LC33H computer. Would you like to correct the workspace directory location?
```

Um dieses Problem zu beheben, wählen Sie **OK**, um die Meldung zu löschen, und führen Sie dann die folgenden Schritte aus.

1. Wählen Sie unter WorkSpaces Anwendungen in der Werkzeugleiste das Symbol „**Anwendung starten**“ und anschließend „**EA\$1Admin**“, um das Enterprise Analyzer-Administrationstool zu starten.  
![\[Wählen Sie im Auswahlmenü für den WorkSpaces Anwendungsstart das Rocket Enterprise Developer-Administrationstool aus.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/aas-launch-selector.png)

1. Wählen Sie im Menü „**Verwalten**“ die Option „**Workspace-Pfad aktualisieren...“** .  
![\[Menü „Verwalten“ des Rocket Enterprise Analyzer-Administrationstools, wobei die Option Workspace-Pfad aktualisieren ausgewählt ist.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ea_admin-administer-refresh.png)

1. **Wählen Sie unter Arbeitsbereich** auswählen den gewünschten Arbeitsbereich aus und klicken Sie dann **auf OK**.  
![\[Das Dialogfeld „Workspace auswählen“ des Rocket Enterprise Analyzer-Verwaltungstools mit einem ausgewählten Projekt.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ea_admin-select-workspace.png)

1. Wählen Sie **OK**, um die Fehlermeldung zu bestätigen.  
![\[Die Enterprise Analyzer-Fehlermeldung „Zugriff auf das Workspace-Verzeichnis ist nicht möglich“, wenn OK ausgewählt ist.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ea_admin-select-workspace-error.png)

1. Geben Sie unter **Netzwerkpfad für das Workspace-Verzeichnis** den richtigen Pfad zu Ihrem Workspace ein, `D:\PhotonUser\My Files\Home Folder\EA\MyWorkspace3` z. B.  
![\[Netzwerkpfad des Workspace-Verzeichnisses im Enterprise Analyzer-Dialogfeld mit einem Beispielpfad.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ea_admin-workspace-directory-network-path.png)

1. Schließen Sie das Micro Focus Enterprise Analyzer Administration Tool.  
![\[Das Micro Focus Enterprise Analyzer Administrationstool, bei dem die Schaltfläche Schließen ausgewählt ist.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/ea_admin-close.png)

1. Wählen Sie unter WorkSpaces Anwendungen in der Werkzeugleiste das Symbol „**Anwendung starten**“ und anschließend „**EA**“, um Micro Focus Enterprise Analyzer zu starten.  
![\[Klicken Sie auf das Symbol „ WorkSpaces Anwendungen starten“, wenn EA ausgewählt ist.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/aas-launch-ea.png)

1. Wiederhole die Schritte 3 bis 5.

Micro Focus Enterprise Analyzer sollte jetzt mit dem vorhandenen Workspace geöffnet werden.

## Bereinigen von Ressourcen
<a name="tutorial-ea-clean"></a>

Wenn Sie die Ressourcen, die Sie für dieses Tutorial erstellt haben, nicht mehr benötigen, löschen Sie sie, damit Ihnen keine weiteren Kosten entstehen. Führen Sie folgende Schritte aus:
+ Verwenden Sie das **EA\$1Admin-Tool**, um den Workspace zu löschen.
+ Löschen Sie die S3-Buckets, die Sie für dieses Tutorial erstellt haben. Weitere Informationen finden Sie unter [Löschen eines Bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/delete-bucket.html) im *Amazon-S3-Benutzerhandbuch*.
+ Löschen Sie die Datenbank, die Sie für dieses Tutorial erstellt haben. Weitere Informationen finden Sie unter [Löschen einer DB-Instance](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html#CHAP_GettingStarted.Deleting.PostgreSQL).

# Tutorial: Rocket Enterprise Developer für WorkSpaces Anwendungen einrichten
<a name="set-up-ed"></a>

Dieses Tutorial beschreibt, wie Sie Rocket Enterprise Developer (ehemals Micro Focus Enterprise Developer) für eine oder mehrere Mainframe-Anwendungen einrichten, um sie mithilfe der Enterprise Developer-Funktionen zu warten, zu kompilieren und zu testen. Das Setup basiert auf den WorkSpaces Windows-Anwendungsabbildern, die AWS Mainframe Modernization dem Kunden zur Verfügung stellt, und auf der Erstellung von WorkSpaces Anwendungsflotten und -stapeln, wie unter beschrieben. [Tutorial: WorkSpaces Anwendungen für die Verwendung mit Rocket Enterprise Analyzer und Rocket Enterprise Developer einrichten](set-up-appstream-mf.md)

**Wichtig**  
Bei den Schritten in diesem Tutorial wird davon ausgegangen, dass Sie WorkSpaces Anwendungen mithilfe der herunterladbaren CloudFormation Vorlage [cfn-m2](https://d1vi4vxke6c2hu.cloudfront.net/tutorial/cfn-m2-appstream-fleet-ea-ed.yaml) - .yaml einrichten. appstream-fleet-ea-ed Weitere Informationen finden Sie unter [Tutorial: WorkSpaces Anwendungen für die Verwendung mit Rocket Enterprise Analyzer und Rocket Enterprise Developer einrichten](set-up-appstream-mf.md).  
Sie müssen die Schritte dieses Setups durchführen, wenn die Enterprise Developer-Flotte und der Enterprise Developer-Stack betriebsbereit sind.

Eine vollständige Beschreibung der Funktionen und Leistungen von Enterprise Developer v7 finden Sie in der [up-to-date Online-Dokumentation (v7.0)](https://www.microfocus.com/documentation/enterprise-developer/ed70/ED-Eclipse/GUID-8D6B7358-AC35-4DAF-A445-607D8D97EBB2.html) auf der Website von Rocket Software (ehemals Micro Focus).

## Inhalt des Bildes
<a name="set-up-ed-image-contents"></a>

Zusätzlich zu Enterprise Developer selbst enthält das Image Rumba (einen TN3270 Emulator). Es enthält auch die folgenden Tools und Bibliotheken.

Tools von Drittanbietern
+ [Python](https://www.python.org/)
+ [Rclone](https://rclone.org/)
+ [pgAdmin](https://www.pgadmin.org/)
+ [git-scm](https://git-scm.com/)
+ [PostgreSQL ODBC-Treiber](https://odbc.postgresql.org/)

Bibliotheken in `C:\Users\Public`
+ BankDemo Quellcode und Projektdefinition für Enterprise Developer:`m2-bankdemo-template.zip`.
+ MFA-Installationspaket für den Mainframe:. `mfa.zip` Weitere Informationen finden Sie unter [Mainframe Access Overview](https://www.microfocus.com/documentation/enterprise-developer/30pu12/ED-VS2012/BKMMMMINTRS001.html) in der *Micro Focus Enterprise* Developer-Dokumentation.
+ Befehls- und Konfigurationsdateien für Rclone (Anweisungen zu deren Verwendung in den Tutorials): `m2-rclone.cmd` und. `m2-rclone.conf`

Wenn Sie auf Quellcode zugreifen müssen, der noch nicht in CodeCommit Repositorys geladen wurde, der aber in einem Amazon S3 S3-Bucket verfügbar ist, um beispielsweise das erste Laden des Quellcodes in Git durchzuführen, gehen Sie wie unter beschrieben vor, um eine virtuelle Windows-Festplatte zu erstellen. [Tutorial: Enterprise Analyzer für WorkSpaces Anwendungen einrichten](set-up-ea.md)

**Topics**
+ [Inhalt des Bildes](#set-up-ed-image-contents)
+ [Voraussetzungen](#tutorial-ed-prerequisites)
+ [Schritt 1: Einrichtung durch einzelne Enterprise Developer-Benutzer](#tutorial-ed-step1)
+ [Schritt 2: Erstellen Sie den Amazon S3-basierten virtuellen Ordner unter Windows (optional)](#tutorial-ed-step2)
+ [Schritt 3: Klonen Sie das Repository](#tutorial-ed-step3)
+ [Nachfolgende Sitzungen](#tutorial-ed-step4)
+ [Bereinigen von Ressourcen](#tutorial-ed-clean)

## Voraussetzungen
<a name="tutorial-ed-prerequisites"></a>
+ Ein oder mehrere CodeCommit Repositorys, die mit dem Quellcode der zu verwaltenden Anwendung geladen wurden. Das Repository-Setup sollte den Anforderungen der oben genannten CI/CD Pipeline entsprechen, um durch die Kombination beider Tools Synergien zu schaffen.
+ Jeder Benutzer muss über Anmeldeinformationen für das CodeCommit Repository oder die Repositorys verfügen, die vom Kontoadministrator gemäß den Informationen unter [Authentifizierung und Zugriffskontrolle für AWS CodeCommit](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control.html) definiert wurden. Die Struktur dieser Anmeldeinformationen wird unter [Authentifizierung und Zugriffskontrolle für AWS](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control.html) überprüft, CodeCommit und die vollständige Referenz zu den IAM-Autorisierungen für CodeCommit finden Sie in der [CodeCommit Berechtigungsreferenz](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control-permissions-reference.html): Der Administrator kann unterschiedliche IAM-Richtlinien für verschiedene Rollen mit rollenspezifischen Anmeldeinformationen für jedes Repository definieren und seine Benutzerberechtigungen auf die spezifischen Aufgaben beschränken, die er in einem bestimmten Repository ausführen muss. Daher generiert der Kontoadministrator für jeden Betreuer des CodeCommit Repositorys einen Hauptbenutzer und erteilt diesem Benutzer Berechtigungen für den Zugriff auf das oder die erforderlichen Repositorys, indem er die richtige (n) IAM-Richtlinie (n) für den CodeCommit Zugriff auswählt.

## Schritt 1: Einrichtung durch einzelne Enterprise Developer-Benutzer
<a name="tutorial-ed-step1"></a>

1. Besorgen Sie sich Ihre IAM-Anmeldeinformationen:

   1. Connect zur AWS Konsole unter her [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

   1. Folgen Sie dem Verfahren, das in Schritt 3 von [Setup für HTTPS-Benutzer mithilfe von Git-Anmeldeinformationen](https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-gc.html) im *AWS CodeCommit Benutzerhandbuch* beschrieben wird. 

   1. Kopieren Sie die CodeCommit spezifischen Anmeldeinformationen, die IAM für Sie generiert hat, indem Sie diese Informationen entweder anzeigen, kopieren und dann in eine sichere Datei auf Ihrem lokalen Computer einfügen oder indem Sie **Anmeldeinformationen herunterladen** wählen, um diese Informationen als CSV-Datei herunterzuladen. Sie benötigen diese Informationen für die Verbindung mit CodeCommit.

1. Starten Sie eine Sitzung mit WorkSpaces Anwendungen, die auf der URL basieren, die Sie in der Willkommens-E-Mail erhalten haben. Verwenden Sie Ihre E-Mail-Adresse als Benutzernamen und erstellen Sie Ihr Passwort.

1. Wählen Sie Ihren Enterprise Developer-Stack aus.

1. Wählen Sie auf der Menüseite **Desktop** aus, um zum Windows-Desktop zu gelangen, der von der Flotte gestreamt wird.

## Schritt 2: Erstellen Sie den Amazon S3-basierten virtuellen Ordner unter Windows (optional)
<a name="tutorial-ed-step2"></a>

Wenn Rclone benötigt wird (siehe oben), erstellen Sie den Amazon S3-basierten virtuellen Ordner unter Windows: (optional, wenn alle Anwendungsartefakte ausschließlich aus Access stammen). CodeCommit 

**Anmerkung**  
Wenn Sie Rclone bereits in der Vorschauversion der AWS Mainframe-Modernisierung verwendet haben, müssen Sie auf die neuere Version aktualisieren, die `m2-rclone.cmd` sich unter befindet. `C:\Users\Public`

1. Kopieren Sie die bereitgestellten `m2-rclone.cmd` Dateien `m2-rclone.conf` und mit `C:\Users\Public` dem `C:\Users\PhotonUser\My Files\Home Folder` Datei-Explorer in Ihren Home-Ordner.

1. Aktualisieren Sie die `m2-rclone.conf` Konfigurationsparameter mit Ihrem AWS Zugriffsschlüssel und dem entsprechenden Geheimnis sowie Ihrem AWS-Region.

   ```
   [m2-s3]
   type = s3
   provider = AWS
   access_key_id = YOUR-ACCESS-KEY
   secret_access_key = YOUR-SECRET-KEY
   region = YOUR-REGION
   acl = private
   server_side_encryption = AES256
   ```

1. Nehmen Sie in `m2-rclone.cmd` die folgenden Änderungen vor:
   + Wechseln Sie `amzn-s3-demo-bucket` zu Ihrem Amazon S3 S3-Bucket-Namen. Beispiel, `m2-s3-mybucket`.
   + Wechseln Sie `your-s3-folder-key` zu Ihrem Amazon S3 S3-Bucket-Key. Beispiel, `myProject`.
   + Wechseln Sie `your-local-folder-path` zum Pfad des Verzeichnisses, in das die Anwendungsdateien aus dem Amazon S3 S3-Bucket synchronisiert werden sollen, der sie enthält. Beispiel, `D:\PhotonUser\My Files\Home Folder\m2-new`. Dieses synchronisierte Verzeichnis muss ein Unterverzeichnis des Home-Ordners sein, damit WorkSpaces Anwendungen es beim Start und Ende der Sitzung ordnungsgemäß sichern und wiederherstellen können.

   ```
   :loop
   timeout /T 10
   "C:\Program Files\rclone\rclone.exe" sync m2-s3:amzn-s3-demo-bucket/your-s3-folder-key "D:\PhotonUser\My Files\Home Folder\your-local-folder-path" --config "D:\PhotonUser\My Files\Home Folder\m2-rclone.conf"
   goto :loop
   ```

1. Öffnen Sie eine Windows-Eingabeaufforderung, geben Sie bei `C:\Users\PhotonUser\My Files\Home Folder` Bedarf eine CD ein und führen Sie den Befehl aus. `m2-rclone.cmd` Dieses Befehlsskript führt eine Endlosschleife aus und synchronisiert Ihren Amazon S3 S3-Bucket und Ihren Schlüssel alle 10 Sekunden mit dem lokalen Ordner. Sie können das Timeout nach Bedarf anpassen. Sie sollten den Quellcode der Anwendung sehen, der sich im Amazon S3 S3-Bucket im Windows-Datei-Explorer befindet.

Um dem Set, an dem Sie gerade arbeiten, neue Dateien hinzuzufügen oder bestehende zu aktualisieren, laden Sie die Dateien in den Amazon S3 S3-Bucket hoch. Sie werden dann bei der nächsten unter definierten Iteration mit Ihrem Verzeichnis synchronisiert. `m2-rclone.cmd` Wenn Sie einige Dateien löschen möchten, löschen Sie sie ebenfalls aus dem Amazon S3 S3-Bucket. Beim nächsten Synchronisierungsvorgang werden sie aus Ihrem lokalen Verzeichnis gelöscht.

## Schritt 3: Klonen Sie das Repository
<a name="tutorial-ed-step3"></a>

1. Navigieren Sie zum Anwendungsauswahlmenü in der oberen linken Ecke des Browserfensters und wählen Sie Enterprise Developer aus.

1. Schließe die von Enterprise Developer benötigte Workspace-Erstellung in deinem Home-Ordner ab, indem du `C:\Users\PhotonUser\My Files\Home Folder` (aka`D: \PhotonUser\My Files\Home Folder`) als Speicherort für den Workspace auswählst.

1. Klonen Sie in Enterprise Developer Ihr CodeCommit Repository, indem Sie zum Project Explorer gehen, mit der rechten Maustaste klicken und **Import, Import****...**, **Git**, **Projekte** aus **Git** **Clone URI** wählen. Geben Sie dann Ihre CodeCommit spezifischen Anmeldedaten ein und füllen Sie den Eclipse-Dialog aus, um den Code zu importieren.

Das CodeCommit Git-Repository ist jetzt in deinem lokalen Workspace geklont.

Ihr Enterprise Developer-Workspace ist jetzt bereit, mit den Wartungsarbeiten an Ihrer Anwendung zu beginnen. Insbesondere können Sie die in Enterprise Developer integrierte lokale Instanz von Enterprise Server (ES) verwenden, um Ihre Anwendung interaktiv zu debuggen und auszuführen, um Ihre Änderungen lokal zu validieren.

**Anmerkung**  
Die lokale Enterprise Developer-Umgebung, einschließlich der lokalen Enterprise Server-Instanz, läuft unter Windows, während AWS Mainframe Modernization unter Linux ausgeführt wird. Wir empfehlen, dass Sie ergänzende Tests in der von AWS Mainframe Modernization bereitgestellten Linux-Umgebung durchführen, nachdem Sie die neue Anwendung für dieses Ziel übernommen CodeCommit und für dieses Ziel neu erstellt haben und bevor Sie die neue Anwendung in der Produktionsumgebung einführen.

## Nachfolgende Sitzungen
<a name="tutorial-ed-step4"></a>

Wenn Sie einen Ordner auswählen, der sich unter der WorkSpaces Anwendungsverwaltung befindet, z. B. den Home-Ordner für das Klonen Ihres CodeCommit Repositorys, wird er sitzungsübergreifend transparent gespeichert und wiederhergestellt. Führen Sie die folgenden Schritte aus, wenn Sie das nächste Mal mit der Anwendung arbeiten müssen: 

1. Starten Sie eine Sitzung mit WorkSpaces Anwendungen auf der Grundlage der URL, die Sie in der Willkommens-E-Mail erhalten haben.

1. Melden Sie sich mit Ihrer E-Mail-Adresse und Ihrem permanenten Passwort an.

1. Wählen Sie den Enterprise Developer-Stack aus.

1. Starten Sie`Rclone`, um eine Verbindung zur Amazon S3-gestützten Festplatte herzustellen (siehe oben), wenn diese Option zur gemeinsamen Nutzung der Workspace-Dateien verwendet wird.

1. Starten Sie Enterprise Developer, um Ihre Arbeit zu erledigen.

## Bereinigen von Ressourcen
<a name="tutorial-ed-clean"></a>

Wenn Sie die Ressourcen, die Sie für dieses Tutorial erstellt haben, nicht mehr benötigen, löschen Sie sie, damit sie Ihnen nicht weiter in Rechnung gestellt werden. Führen Sie folgende Schritte aus:
+ Löschen Sie das CodeCommit Repository, das Sie für dieses Tutorial erstellt haben. Weitere Informationen finden Sie im *AWS CodeCommit Benutzerhandbuch* unter [Löschen eines CodeCommit Repositorys](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-delete-repository.html).
+ Löschen Sie die Datenbank, die Sie für dieses Tutorial erstellt haben. Weitere Informationen finden Sie unter [Löschen einer DB-Instance](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html#CHAP_GettingStarted.Deleting.PostgreSQL).

# Verfügbare Batch-Dienstprogramme in AWS Mainframe Modernization
<a name="utilities-m2"></a>

Mainframe-Anwendungen verwenden häufig Batch-Hilfsprogramme, um bestimmte Funktionen auszuführen, z. B. das Sortieren von Daten, das Übertragen von Dateien über FTP, das Laden von Daten in Datenbanken DB2, das Entladen von Daten aus Datenbanken usw.

Wenn Sie Ihre Anwendungen auf AWS Mainframe Modernization migrieren, benötigen Sie funktionsgleiche Ersatzprogramme, die dieselben Aufgaben ausführen können wie die, die Sie auf dem Mainframe verwendet haben. Einige dieser Dienstprogramme sind möglicherweise bereits als Teil der Runtime-Engines für die AWS Mainframe-Modernisierung verfügbar, aber wir bieten die folgenden Ersatz-Utilities an:
+ M2SFTP — ermöglicht die sichere Dateiübertragung mithilfe des SFTP-Protokolls.
+ M2WAIT — wartet eine bestimmte Zeit, bevor mit dem nächsten Schritt in einem Batch-Job fortgefahren wird.
+ TXT2PDF — konvertiert Textdateien in das PDF-Format.
+ M2DFUTIL — bietet Sicherungs-, Wiederherstellungs-, Lösch- und Kopierfunktionen für Datensätze, die der Unterstützung durch das Mainframe-Hilfsprogramm ADRDSSU ähneln.
+ M2RUNCMD — ermöglicht die Ausführung von Befehlen, Skripten und Systemaufrufen von Rocket Software (ehemals Micro Focus) direkt von JCL aus.

Wir haben diese Batch-Dienstprogramme auf der Grundlage von Kundenfeedback entwickelt und so konzipiert, dass sie dieselben Funktionen wie die Mainframe-Utilities bieten. Ziel ist es, Ihren Übergang von der Mainframe-Modernisierung zur AWS Mainframe-Modernisierung so reibungslos wie möglich zu gestalten.

**Topics**
+ [Binärer Standort](#location-utilities)
+ [M2SFTP-Batch-Hilfsprogramm](m2sftp.md)
+ [M2WAIT-Batch-Hilfsprogramm](m2wait.md)
+ [TXT2PDF-Batch-Hilfsprogramm](txt2pdf.md)
+ [M2DFUTIL-Batch-Hilfsprogramm](m2dfutil.md)
+ [M2RUNCMD Batch-Hilfsprogramm](m2runcmd.md)

## Binärer Standort
<a name="location-utilities"></a>

Diese Dienstprogramme sind auf den Produkten Rocket Enterprise Developer (ED) und Rocket Software (ES) vorinstalliert. Sie finden sie für alle Varianten von ED und ES an der folgenden Stelle:
+ Linux: `/opt/aws/m2/microfocus/utilities/64bit`
+ Windows (32 Bit): `C:\AWS\M2\MicroFocus\Utilities\32bit`
+ Windows (64 Bit): `C:\AWS\M2\MicroFocus\Utilities\64bit`

# M2SFTP-Batch-Hilfsprogramm
<a name="m2sftp"></a>

M2SFTP ist ein JCL-Hilfsprogramm, das entwickelt wurde, um sichere Dateiübertragungen zwischen Systemen mithilfe des Secure File Transfer Protocol (SFTP) durchzuführen. Das Programm verwendet den Putty SFTP-Client, um die eigentlichen Dateiübertragungen `psftp` durchzuführen. Das Programm funktioniert ähnlich wie ein Mainframe-FTP-Hilfsprogramm und verwendet Benutzer- und Kennwortauthentifizierung.

**Anmerkung**  
Die Authentifizierung mit öffentlichen Schlüsseln wird nicht unterstützt.

Um Ihr Mainframe-FTP JCLs zur Verwendung von SFTP zu konvertieren, wechseln `PGM=FTP` Sie zu. `PGM=M2SFTP`

**Topics**
+ [Unterstützte Plattformen](#m2sftp-platforms)
+ [Installieren von Abhängigkeiten](#m2sftp-dependencies)
+ [Konfigurieren Sie M2SFTP für Mainframe Modernization Managed AWS](#m2sftp-configure-managed)
+ [M2SFTP für AWS Mainframe Modernization Runtime auf Amazon EC2 konfigurieren (einschließlich Anwendungen) WorkSpaces](#m2sftp-configure-customer-infra)
+ [Beispiel JCLs](#m2sftp-jcl)
+ [Befehlsreferenz für den Putty SFTP (PSFTP) -Client](#m2sftp-cmd-ref)
+ [Nächste Schritte](#m2sftp-next)

## Unterstützte Plattformen
<a name="m2sftp-platforms"></a>

Sie können M2SFTP auf jeder der folgenden Plattformen verwenden:
+ AWS Von Rocket Software (ehemals Micro Focus) verwaltete Mainframe-Modernisierung
+ Rocket Software Runtime (auf Amazon EC2)
+ Alle Varianten der Produkte Rocket Software Enterprise Developer (ED) und Rocket Software Enterprise Server (ES).

## Installieren von Abhängigkeiten
<a name="m2sftp-dependencies"></a>

**Um den Putty SFTP-Client unter Windows zu installieren**
+ Laden Sie den [PuTTY SFTP-Client](https://www.putty.org/) herunter und installieren Sie ihn.

**Um den Putty SFTP-Client unter Linux zu installieren:**
+ Führen Sie den folgenden Befehl aus, um den Putty SFTP-Client zu installieren:

  ```
    sudo yum -y install putty
  ```

## Konfigurieren Sie M2SFTP für Mainframe Modernization Managed AWS
<a name="m2sftp-configure-managed"></a>

Wenn Ihre migrierten Anwendungen auf AWS Mainframe Modernization Managed laufen, müssen Sie M2SFTP wie folgt konfigurieren.
+ Stellen Sie die entsprechenden Rocket Enterprise Server-Umgebungsvariablen für MFFTP ein. Hier sind ein paar Beispiele:
  + `MFFTP_TEMP_DIR`
  + `MFFTP_SENDEOL`
  + `MFFTP_TIME`
  + `MFFTP_ABEND`

  Sie können so wenige oder so viele dieser Variablen festlegen, wie Sie möchten. Sie können sie mit der `ENVAR DD` Anweisung in Ihrer JCL setzen. Weitere Informationen zu diesen Variablen finden Sie unter [MFFTP-Steuervariablen](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-3F94BBC8-CB97-4642-A4A7-4235C0C079E2.html) in der Micro Focus-Dokumentation.

Informationen zum Testen Ihrer Konfiguration finden Sie unter. [Beispiel JCLs](#m2sftp-jcl)

## M2SFTP für AWS Mainframe Modernization Runtime auf Amazon EC2 konfigurieren (einschließlich Anwendungen) WorkSpaces
<a name="m2sftp-configure-customer-infra"></a>

Wenn Ihre migrierten Anwendungen auf der AWS Mainframe Modernization Runtime auf Amazon EC2 ausgeführt werden, konfigurieren Sie M2SFTP wie folgt.

1. Ändern Sie den [Micro Focus JES-Programmpfad](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-BC8A1796-9EDE-48EB-8363-31C9BDE7F96B.html) so, dass er den binären Speicherort für Batch-Dienstprogramme enthält. Wenn Sie mehrere Pfade angeben müssen, verwenden Sie Doppelpunkte (`:`), um Pfade unter Linux und Semikolons (`;`) unter Windows zu trennen.
   + Linux: `/opt/aws/m2/microfocus/utilities/64bit`
   + Windows (32-Bit): `C:\AWS\M2\MicroFocus\Utilities\32bit`
   + Windows (64 Bit): `C:\AWS\M2\MicroFocus\Utilities\64bit`

1. Stellen Sie die entsprechenden Rocket Enterprise Server-Umgebungsvariablen für MFFTP ein. Hier sind ein paar Beispiele:
   + `MFFTP_TEMP_DIR`
   + `MFFTP_SENDEOL`
   + `MFFTP_TIME`
   + ``MFFTP\$1ABEND

   Sie können so wenige oder so viele dieser Variablen setzen, wie Sie möchten. Sie können sie mit der `ENVAR DD` Anweisung in Ihrer JCL setzen. Weitere Informationen zu diesen Variablen finden Sie unter [MFFTP-Steuervariablen](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-3F94BBC8-CB97-4642-A4A7-4235C0C079E2.html) in der Micro Focus-Dokumentation.

Informationen zum Testen Ihrer Konfiguration finden Sie unter. [Beispiel JCLs](#m2sftp-jcl)

## Beispiel JCLs
<a name="m2sftp-jcl"></a>

Um die Installation zu testen, können Sie eine der folgenden JCL-Beispieldateien verwenden.

**M2 .jcl SFTP1**

Diese JCL zeigt, wie M2SFTP aufgerufen wird, um eine Datei an einen Remote-SFTP-Server zu senden. Beachten Sie die Umgebungsvariablen, die in der Anweisung festgelegt sind. `ENVVAR DD`

```
//M2SFTP1 JOB 'M2SFTP1',CLASS=A,MSGCLASS=X,TIME=1440
//*
//* Copyright Amazon.com, Inc. or its affiliates.* 
//* All Rights Reserved.* 
//*
//*-------------------------------------------------------------------**
//* Sample SFTP JCL step to send a file to SFTP server* 
//*-------------------------------------------------------------------**
//*
//STEP01 EXEC PGM=M2SFTP,
//            PARM='127.0.0.1 (EXIT=99 TIMEOUT 300'
//*
//SYSFTPD  DD  *
RECFM FB
LRECL 80
SBSENDEOL CRLF
MBSENDEOL CRLF
TRAILINGBLANKS FALSE
/*
//NETRC    DD  *
machine 127.0.0.1 login sftpuser password sftppass
/*
//SYSPRINT DD  SYSOUT=*
//OUTPUT   DD  SYSOUT=*
//STDOUT   DD  SYSOUT=*
//INPUT    DD  *
type a
locsite notrailingblanks
cd files
put 'AWS.M2.TXT2PDF1.PDF' AWS.M2.TXT2PDF1.pdf   
put 'AWS.M2.CARDDEMO.CARDDATA.PS' AWS.M2.CARDDEMO.CARDDATA.PS1.txt
quit
/*
//ENVVAR   DD *
MFFTP_VERBOSE_OUTPUT=ON
MFFTP_KEEP=N
/*
//*
//
```

**M2 SFTP2 .jcl**

Diese JCL zeigt, wie M2SFTP aufgerufen wird, um eine Datei von einem Remote-SFTP-Server zu empfangen. Beachten Sie die in der Anweisung festgelegten Umgebungsvariablen. `ENVVAR DD`

```
//M2SFTP2 JOB 'M2SFTP2',CLASS=A,MSGCLASS=X,TIME=1440
//*
//* Copyright Amazon.com, Inc. or its affiliates.* 
//* All Rights Reserved.* 
//*
//*-------------------------------------------------------------------**
//* Sample SFTP JCL step to receive a file from SFTP server* 
//*-------------------------------------------------------------------**
//*
//STEP01 EXEC PGM=M2SFTP
//*
//SYSPRINT DD  SYSOUT=*
//OUTPUT   DD  SYSOUT=*
//STDOUT   DD  SYSOUT=*
//INPUT    DD  *
open 127.0.0.1
sftpuser
sftppass
cd files
locsite recfm=fb lrecl=150
get AWS.M2.CARDDEMO.CARDDATA.PS.txt +
'AWS.M2.CARDDEMO.CARDDATA.PS2' (replace
quit
/*
//ENVVAR   DD *
MFFTP_VERBOSE_OUTPUT=ON
MFFTP_KEEP=N
/*
//*
//
```

**Anmerkung**  
Wir empfehlen dringend, FTP-Anmeldeinformationen in einer NETRC-Datei zu speichern und den Zugriff nur auf autorisierte Benutzer zu beschränken.

## Befehlsreferenz für den Putty SFTP (PSFTP) -Client
<a name="m2sftp-cmd-ref"></a>

Der PSFTP-Client unterstützt nicht alle FTP-Befehle. Die folgende Liste zeigt alle Befehle, die PSFTP unterstützt.


| Befehl | Description | 
| --- | --- | 
|  \$1  |  Führen Sie einen lokalen Befehl aus  | 
|  Tschüss  |  Beenden Sie Ihre SFTP-Sitzung  | 
|  cd  |  Ändern Sie Ihr Remote-Arbeitsverzeichnis  | 
|  chmod  |  Dateiberechtigungen und Modi ändern  | 
|  close  |  Beenden Sie Ihre SFTP-Sitzung, aber beenden Sie PSFTP nicht  | 
|  Entf  |  Dateien auf dem Remoteserver löschen  | 
|  dir  |  Entfernte Dateien auflisten  | 
|  exit  |  Beenden Sie Ihre SFTP-Sitzung  | 
|  get  |  Laden Sie eine Datei vom Server auf Ihren lokalen Computer herunter  | 
|  help  |  Gib Hilfe  | 
|  lcd  |  Lokales Arbeitsverzeichnis ändern  | 
|  lpwd  |  Lokales Arbeitsverzeichnis drucken  | 
|  LS  |  Entfernte Dateien auflisten  | 
|  mget  |  Laden Sie mehrere Dateien gleichzeitig herunter  | 
|  mkdir  |  Erstellen Sie Verzeichnisse auf dem Remoteserver  | 
|  mput  |  Laden Sie mehrere Dateien gleichzeitig hoch  | 
|  mv  |  Datei (en) auf dem Remoteserver verschieben oder umbenennen  | 
|  geöffnet  |  Stellen Sie eine Connect zu einem Host her  | 
|  put  |  Laden Sie eine Datei von Ihrem lokalen Computer auf den Server hoch  | 
|  pwd  |  Drucken Sie Ihr Remote-Arbeitsverzeichnis  | 
|  quit  |  Beenden Sie Ihre SFTP-Sitzung  | 
|  bereuen  |  Dateien weiter herunterladen  | 
|  ren  |  Datei (en) auf dem Remoteserver verschieben oder umbenennen  | 
|  wiedergeben  |  Fahren Sie mit dem Hochladen von Dateien fort  | 
|  rm  |  Löschen Sie Dateien auf dem Remoteserver  | 
|  rmdir  |  Entfernen Sie Verzeichnisse auf dem Remoteserver  | 

## Nächste Schritte
<a name="m2sftp-next"></a>

Um Dateien mithilfe von SFTP in Amazon Simple Storage Service hoch- und herunterzuladen, können Sie M2SFTP in Verbindung mit dem verwenden AWS Transfer Family, wie in den folgenden Blogbeiträgen beschrieben.
+ [Verwenden Sie logische AWS SFTP-Verzeichnisse, um einen einfachen Datenverteilungsservice zu erstellen](https://aws.amazon.com/blogs/storage/using-aws-sftp-logical-directories-to-build-a-simple-data-distribution-service/)
+ [Aktivieren Sie die Kennwortauthentifizierung für die Verwendung AWS Transfer for SFTPAWS Secrets Manager](https://aws.amazon.com/blogs/storage/enable-password-authentication-for-aws-transfer-for-sftp-using-aws-secrets-manager/)

# M2WAIT-Batch-Hilfsprogramm
<a name="m2wait"></a>

M2WAIT ist ein Mainframe-Hilfsprogramm, mit dem Sie eine Wartezeit in Ihren JCL-Skripten einführen können, indem Sie eine Zeitdauer in Sekunden, Minuten oder Stunden angeben. Sie können M2WAIT direkt von JCL aus aufrufen, indem Sie die Zeit, die Sie warten möchten, als Eingabeparameter übergeben. Intern ruft das M2WAIT-Programm das von Rocket Software (ehemals Micro Focus) bereitgestellte Modul auf, `C$SLEEP` um auf eine bestimmte Zeit zu warten.

**Anmerkung**  
Sie können Micro Focus-Aliase verwenden, um das zu ersetzen, was Sie in Ihren JCL-Skripten haben. Weitere Informationen finden Sie unter [JES-Alias](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-D4206FF9-32C4-43E7-9413-5E7E96AA8092.html) in der Micro Focus-Dokumentation.

**Topics**
+ [Unterstützte Plattformen](#m2wait-platforms)
+ [Konfigurieren Sie M2WAIT für AWS Mainframe-Modernisierung (Managed)](#m2wait-configure-managed)
+ [M2WAIT für AWS Mainframe Modernization Runtime auf Amazon EC2 konfigurieren (einschließlich Anwendungen) WorkSpaces](#m2wait-configure-customer-infra)
+ [Beispiel JCL](#m2wait-jcl)

## Unterstützte Plattformen
<a name="m2wait-platforms"></a>

Sie können M2WAIT auf jeder der folgenden Plattformen verwenden:
+ AWS Von Rocket Software (ehemals Micro Focus) verwaltete Mainframe-Modernisierung
+ Rocket Software Runtime (auf Amazon EC2)
+ Alle Varianten der Produkte Rocket Software Enterprise Developer (ED) und Rocket Software Enterprise Server (ES).

## Konfigurieren Sie M2WAIT für AWS Mainframe-Modernisierung (Managed)
<a name="m2wait-configure-managed"></a>

Wenn Ihre migrierten Anwendungen auf AWS Mainframe Modernization Managed laufen, müssen Sie M2WAIT wie folgt konfigurieren.
+ Verwenden Sie das Programm M2WAIT in Ihrer JCL, indem Sie die Eingabeparameter übergeben, wie unter gezeigt. [Beispiel JCL](#m2wait-jcl)

## M2WAIT für AWS Mainframe Modernization Runtime auf Amazon EC2 konfigurieren (einschließlich Anwendungen) WorkSpaces
<a name="m2wait-configure-customer-infra"></a>

Wenn Ihre migrierten Anwendungen auf der AWS Mainframe Modernization Runtime auf Amazon EC2 ausgeführt werden, konfigurieren Sie M2WAIT wie folgt.

1. Ändern Sie den [Micro Focus JES-Programmpfad](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-BC8A1796-9EDE-48EB-8363-31C9BDE7F96B.html) so, dass er den binären Speicherort für Batch-Dienstprogramme enthält. Wenn Sie mehrere Pfade angeben müssen, verwenden Sie Doppelpunkte (`:`), um Pfade unter Linux und Semikolons (`;`) unter Windows zu trennen.
   + Linux: `/opt/aws/m2/microfocus/utilities/64bit`
   + Windows (32-Bit): `C:\AWS\M2\MicroFocus\Utilities\32bit`
   + Windows (64 Bit): `C:\AWS\M2\MicroFocus\Utilities\64bit`

1. Verwenden Sie das Programm M2WAIT in Ihrer JCL, indem Sie den Eingabeparameter übergeben, wie unter gezeigt. [Beispiel JCL](#m2wait-jcl)

## Beispiel JCL
<a name="m2wait-jcl"></a>

Um die Installation zu testen, können Sie das `M2WAIT1.jcl` Programm verwenden.

Diese Beispiel-JCL zeigt, wie man M2WAIT aufruft und ihm mehrere verschiedene Dauern übergibt.

```
//M2WAIT1 JOB 'M2WAIT',CLASS=A,MSGCLASS=X,TIME=1440
//*
//* Copyright Amazon.com, Inc. or its affiliates.* 
//* All Rights Reserved.* 
//*
//*-------------------------------------------------------------------**
//* Wait for 12 Seconds*
//*-------------------------------------------------------------------**
//*
//STEP01 EXEC PGM=M2WAIT,PARM='S012'
//SYSOUT DD SYSOUT=*
//*
//*-------------------------------------------------------------------**
//* Wait for 0 Seconds (defaulted to 10 Seconds)*
//*-------------------------------------------------------------------**
//*
//STEP02 EXEC PGM=M2WAIT,PARM='S000'
//SYSOUT DD SYSOUT=*
//*
//*-------------------------------------------------------------------**
//* Wait for 1 Minute*
//*-------------------------------------------------------------------**
//*
//STEP03 EXEC PGM=M2WAIT,PARM='M001'
//SYSOUT DD SYSOUT=*
//*
//
```

# TXT2PDF-Batch-Hilfsprogramm
<a name="txt2pdf"></a>

TXT2PDF ist ein Mainframe-Hilfsprogramm, das häufig zum Konvertieren einer Textdatei in eine PDF-Datei verwendet wird. Dieses Programm verwendet denselben Quellcode für TXT2 PDF (z/OSFreeware). Wir haben es so modifiziert, dass es unter der Laufzeitumgebung AWS Mainframe Modernization Rocket Software (ehemals Micro Focus) läuft.

**Topics**
+ [Unterstützte Plattformen](#txt2pdf-platforms)
+ [TXT2PDF für AWS Mainframe Modernization Managed konfigurieren](#txt2pdf-configure-managed)
+ [TXT2PDF für AWS Mainframe Modernization Runtime auf Amazon EC2 konfigurieren (einschließlich WorkSpaces Anwendungen)](#txt2pdf-configure-customer-infra)
+ [Beispiel JCL](#txt2pdf-jcl)
+ [Modifikationen](#txt2pdf-mods)
+ [Referenzen](#txt2pdf-ref)

## Unterstützte Plattformen
<a name="txt2pdf-platforms"></a>

Sie können TXT2 PDF auf jeder der folgenden Plattformen verwenden:
+ AWS Mainframe-Modernisierung, Rocket Software Managed
+ Rocket Software Runtime (auf Amazon EC2)
+ Alle Varianten der Produkte Rocket Enterprise Developer (ED) und Rocket Enterprise Server (ES).

## TXT2PDF für AWS Mainframe Modernization Managed konfigurieren
<a name="txt2pdf-configure-managed"></a>

Wenn Ihre migrierten Anwendungen auf AWS Mainframe Modernization Managed ausgeführt werden, konfigurieren Sie TXT2 PDF wie folgt.
+ Erstellen Sie eine REXX EXEC-Bibliothek mit dem Namen. `AWS.M2.REXX.EXEC` Laden Sie diese [REXX-Module](https://drm0z31ua8gi7.cloudfront.net/utilities/mf/TXT2PDF/rexx/TXT2PDF_rexx.zip) herunter und kopieren Sie sie in die Bibliothek. 
  + `TXT2PDF.rex`- TXT2 z/OS PDF-Freeware (modifiziert)
  + `TXT2PDFD.rex`- TXT2 z/OS PDF-Freeware (unverändert)
  + `TXT2PDFX.rex`- TXT2 z/OS PDF-Freeware (modifiziert)
  + `M2GETOS.rex`- Um den Betriebssystemtyp zu überprüfen (Windows oder Linux)

Informationen zum Testen Ihrer Konfiguration finden Sie unter[Beispiel JCL](#txt2pdf-jcl).

## TXT2PDF für AWS Mainframe Modernization Runtime auf Amazon EC2 konfigurieren (einschließlich WorkSpaces Anwendungen)
<a name="txt2pdf-configure-customer-infra"></a>

Wenn Ihre migrierten Anwendungen auf der AWS Mainframe Modernization Runtime auf Amazon EC2 ausgeführt werden, konfigurieren Sie TXT2 PDF wie folgt.

1. Stellen Sie die Rocket Software-Umgebungsvariable `MFREXX_CHARSET` auf den entsprechenden Wert ein, z. B. „`A`“ für ASCII-Daten.
**Wichtig**  
Die Eingabe eines falschen Werts könnte zu Problemen bei der Datenkonvertierung (von EBCDIC nach ASCII) führen, wodurch das resultierende PDF unlesbar oder funktionsunfähig wird. `MFREXX_CHARSET``MF_CHARSET`Wir empfehlen eine entsprechende Einstellung.

1. Ändern Sie den [Micro Focus JES-Programmpfad](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-BC8A1796-9EDE-48EB-8363-31C9BDE7F96B.html) so, dass er den binären Speicherort für Batch-Dienstprogramme enthält. Wenn Sie mehrere Pfade angeben müssen, verwenden Sie Doppelpunkte (`:`), um Pfade unter Linux und Semikolons (`;`) unter Windows zu trennen.
   + Linux: `/opt/aws/m2/microfocus/utilities/64bit`
   + Windows (32-Bit): `C:\AWS\M2\MicroFocus\Utilities\32bit`
   + Windows (64 Bit): `C:\AWS\M2\MicroFocus\Utilities\64bit`

1. Erstellen Sie eine REXX EXEC-Bibliothek namens. `AWS.M2.REXX.EXEC`` Laden Sie diese [REXX-Module](https://drm0z31ua8gi7.cloudfront.net/utilities/mf/TXT2PDF/rexx/TXT2PDF_rexx.zip) herunter und kopieren Sie sie in die Bibliothek. 
   + `TXT2PDF.rex`- TXT2 z/OS PDF-Freeware (modifiziert)
   + `TXT2PDFD.rex`- TXT2 z/OS PDF-Freeware (unverändert)
   + `TXT2PDFX.rex`- TXT2 z/OS PDF-Freeware (modifiziert)
   + `M2GETOS.rex`- Um den Betriebssystemtyp zu überprüfen (Windows oder Linux)

Informationen zum Testen Ihrer Konfiguration finden Sie unter[Beispiel JCL](#txt2pdf-jcl).

## Beispiel JCL
<a name="txt2pdf-jcl"></a>

Um die Installation zu testen, können Sie eine der folgenden JCL-Beispieldateien verwenden.

**TXT2PDF1.jcl**

Diese JCL-Beispieldatei verwendet einen DD-Namen für die TXT2 PDF-Konvertierung.

```
//TXT2PDF1 JOB 'TXT2PDF1',CLASS=A,MSGCLASS=X,TIME=1440
//*
//* Copyright Amazon.com, Inc. or its affiliates.* 
//* All Rights Reserved.* 
//*
//*-------------------------------------------------------------------**
//* PRE DELETE*
//*-------------------------------------------------------------------**
//*
//PREDEL  EXEC PGM=IEFBR14
//* 
//DD01     DD DSN=AWS.M2.TXT2PDF1.PDF.VB,                      
//            DISP=(MOD,DELETE,DELETE)
//*
//DD02     DD DSN=AWS.M2.TXT2PDF1.PDF,                       
//            DISP=(MOD,DELETE,DELETE)
//* 
//*-------------------------------------------------------------------**
//* CALL TXT2PDF TO CONVERT FROM TEXT TO PDF (VB)*
//*-------------------------------------------------------------------**
//*
//STEP01 EXEC PGM=IKJEFT1B
//*
//SYSEXEC  DD DISP=SHR,DSN=AWS.M2.REXX.EXEC
//*
//INDD     DD *
1THIS IS THE FIRST LINE ON THE PAGE 1
0THIS IS THE THIRD LINE ON THE PAGE 1
-THIS IS THE   6TH LINE ON THE PAGE 1
THIS IS THE   7TH LINE ON THE PAGE 1
+____________________________________ - OVERSTRIKE 7TH LINE          
1THIS IS THE FIRST LINE ON THE PAGE 2
0THIS IS THE THIRD LINE ON THE PAGE 2
-THIS IS THE   6TH LINE ON THE PAGE 2 
THIS IS THE   7TH LINE ON THE PAGE 2
+____________________________________ - OVERSTRIKE 7TH LINE                 
/*
//*
//OUTDD    DD DSN=AWS.M2.TXT2PDF1.PDF.VB,
//            DISP=(NEW,CATLG,DELETE),
//            DCB=(LRECL=256,DSORG=PS,RECFM=VB,BLKSIZE=0)
//*
//SYSTSPRT DD SYSOUT=*
//SYSTSIN  DD DDNAME=SYSIN
//*
//SYSIN    DD *
%TXT2PDF BROWSE Y IN DD:INDD +
OUT DD:OUTDD +
CC YES
/*
//*
//*-------------------------------------------------------------------**
//* CONVERT PDF (VB) TO PDF (LSEQ - BYTE STREAM)*
//*-------------------------------------------------------------------**
//* 
//STEP02 EXEC PGM=VB2LSEQ
//*
//INFILE   DD DSN=AWS.M2.TXT2PDF1.PDF.VB,DISP=SHR             
//*
//OUTFILE  DD DSN=AWS.M2.TXT2PDF1.PDF,                      
//            DISP=(NEW,CATLG,DELETE),
//            DCB=(LRECL=256,DSORG=PS,RECFM=LSEQ,BLKSIZE=0)
//*
//SYSOUT   DD SYSOUT=*
//*
//
```

**TXT2PDF2.jcl**

Dieses JCL-Beispiel verwendet einen DSN-Namen für die PDF-Konvertierung. TXT2

```
//TXT2PDF2 JOB 'TXT2PDF2',CLASS=A,MSGCLASS=X,TIME=1440
//*
//* Copyright Amazon.com, Inc. or its affiliates.* 
//* All Rights Reserved.* 
//*
//*-------------------------------------------------------------------**
//* PRE DELETE*
//*-------------------------------------------------------------------**
//*
//PREDEL  EXEC PGM=IEFBR14
//* 
//DD01     DD DSN=AWS.M2.TXT2PDF2.PDF.VB,                      
//            DISP=(MOD,DELETE,DELETE)
//*
//DD02     DD DSN=AWS.M2.TXT2PDF2.PDF,                       
//            DISP=(MOD,DELETE,DELETE)
//* 
//*-------------------------------------------------------------------**
//* CALL TXT2PDF TO CONVERT FROM TEXT TO PDF (VB)*
//*-------------------------------------------------------------------**
//* 
//STEP01 EXEC PGM=IKJEFT1B
//*
//SYSEXEC  DD DISP=SHR,DSN=AWS.M2.REXX.EXEC
//*
//INDD     DD *
1THIS IS THE FIRST LINE ON THE PAGE 1
0THIS IS THE THIRD LINE ON THE PAGE 1
-THIS IS THE   6TH LINE ON THE PAGE 1
THIS IS THE   7TH LINE ON THE PAGE 1
+____________________________________ - OVERSTRIKE 7TH LINE          
1THIS IS THE FIRST LINE ON THE PAGE 2
0THIS IS THE THIRD LINE ON THE PAGE 2
-THIS IS THE   6TH LINE ON THE PAGE 2 
THIS IS THE   7TH LINE ON THE PAGE 2
+____________________________________ - OVERSTRIKE 7TH LINE                 
/*
//*
//SYSTSPRT DD SYSOUT=*
//SYSTSIN  DD DDNAME=SYSIN
//*
//SYSIN    DD *
%TXT2PDF BROWSE Y IN DD:INDD +
OUT 'AWS.M2.TXT2PDF2.PDF.VB' +
CC YES
/*
//*
//*-------------------------------------------------------------------**
//* CONVERT PDF (VB) TO PDF (LSEQ - BYTE STREAM)*
//*-------------------------------------------------------------------**
//*
//STEP02 EXEC PGM=VB2LSEQ
//*
//INFILE   DD DSN=AWS.M2.TXT2PDF2.PDF.VB,DISP=SHR             
//*
//OUTFILE  DD DSN=AWS.M2.TXT2PDF2.PDF,                      
//            DISP=(NEW,CATLG,DELETE),
//            DCB=(LRECL=256,DSORG=PS,RECFM=LSEQ,BLKSIZE=0)
//*
//SYSOUT   DD SYSOUT=*
//*
//
```

## Modifikationen
<a name="txt2pdf-mods"></a>

Damit das TXT2 PDF-Programm in der AWS Mainframe Modernization Rocket Software-Laufzeitumgebung ausgeführt werden kann, haben wir die folgenden Änderungen vorgenommen:
+ Änderungen am Quellcode, um die Kompatibilität mit der REXX-Laufzeit von Rocket Software sicherzustellen
+ Änderungen, um sicherzustellen, dass das Programm sowohl auf Windows- als auch auf Linux-Betriebssystemen ausgeführt werden kann
+ Änderungen zur Unterstützung sowohl der EBCDIC- als auch der ASCII-Laufzeit

## Referenzen
<a name="txt2pdf-ref"></a>

TXT2PDF-Referenzen und Quellcode:
+ [Text-zu-PDF-Konverter](https://homerow.net/rexx/txt2pdf/)
+ [z/OSFreeware TCP/IP und Mail-Tools](http://www.lbdsoftware.com/tcpip.html)
+ [TXT2PDF-Benutzerreferenzhandbuch](http://www.lbdsoftware.com/TXT2PDF-User-Guide.pdf)

# M2DFUTIL-Batch-Hilfsprogramm
<a name="m2dfutil"></a>

M2DFUTIL ist ein JCL-Hilfsprogramm, das Sicherungs-, Wiederherstellungs-, Lösch- und Kopierfunktionen für Datensätze bereitstellt, ähnlich der Unterstützung durch das Mainframe-Hilfsprogramm ADRDSSU. Dieses Programm behält viele der SYSIN-Parameter von ADRDSSU bei, wodurch der Prozess zur Migration zu diesem neuen Hilfsprogramm optimiert wird.

**Topics**
+ [Unterstützte Plattformen](#m2dfutil-platforms)
+ [Anforderungen an die Plattform](#m2dfutil-platform)
+ [Geplante future Unterstützung](#m2udfutil-future-support)
+ [Standorte von Vermögenswerten](#mdfutil-assets)
+ [Konfiguration von M2DFUTIL oder AWS Mainframe Modernization Runtime auf Amazon EC2 (einschließlich 2.0) AppStream](#mdfutil-dependencies)
+ [Allgemeine Syntax](#mdfutil-syntax)
+ [Beispiel JCLs](#mdfutil-sample-jcls)

## Unterstützte Plattformen
<a name="m2dfutil-platforms"></a>

Sie können M2DFUTIL auf jeder der folgenden Plattformen verwenden:
+ Rocket Software (ehemals Micro Focus) ES unter Windows (64 Bit und 32 Bit)
+ Rocket Software ES auf Linux (64 Bit)

## Anforderungen an die Plattform
<a name="m2dfutil-platform"></a>

M2DFUTIL hängt davon ab, dass ein Skript aufgerufen wird, um einen Test mit regulären Ausdrücken durchzuführen. Unter Windows müssen Sie Windows Services for Linux (WSL) installieren, damit dieses Skript ausgeführt werden kann.

## Geplante future Unterstützung
<a name="m2udfutil-future-support"></a>

Zu den Funktionen, die derzeit nicht über das Mainframe-Hilfsprogramm ADRDSSU verfügbar sind, aber in future verfügbar sein werden, gehören: 
+ M2 verwaltet
+ VSAM
+ COPY-Unterstützung für das Umbenennen von Dateinamen
+ RENAME-Unterstützung für RESTORE 
+ Mehrfach INCLUDE und EXCLUDE
+ BY-Klausel für die Unterauswahl nach DSORG, CREDT, EXPDT
+ MWAIT-Klausel zum erneuten Versuch, Fehler in der Warteschlange zu wiederholen
+ S3-Speicherunterstützung für DUMP/RESTORE

## Standorte von Vermögenswerten
<a name="mdfutil-assets"></a>

Das Lademodul für dieses Hilfsprogramm wird `M2DFUTIL.so` unter Linux und `M2DFUTIL.dll` Windows aufgerufen. Dieses Lademodul befindet sich an den folgenden Orten:
+ Linux: `/opt/aws/m2/microfocus/utilities/64bit`
+ Windows (32 Bit): `C:\AWS\M2\MicroFocus\Utilities\32bit`
+ Windows (64 Bit): `C:\AWS\M2\MicroFocus\Utilities\64bit`

Das für das Testen regulärer Ausdrücke verwendete Skript wird aufgerufen`compare.sh`. Dieses Skript befindet sich an den folgenden Orten:
+ Linux: `/opt/aws/m2/microfocus/utilities/scripts`
+ Windows (32 Bit): `C:\AWS\M2\MicroFocus\Utilities\scripts`

## Konfiguration von M2DFUTIL oder AWS Mainframe Modernization Runtime auf Amazon EC2 (einschließlich 2.0) AppStream
<a name="mdfutil-dependencies"></a>

Konfigurieren Sie Ihre Enterprise Server-Region wie folgt:
+ Fügen Sie die folgenden Variablen in **[ES-Environment**] hinzu
  + `M2DFUTILS_BASE_LOC`- Der Standardspeicherort für die DUMP-Ausgabe
  + `M2DFUTILS_SCRIPTPATH`— Der unter **Asset** Locations dokumentierte Speicherort des `compare.sh` Skripts
  + `M2DFUTILS_VERBOSE`- [AUSFÜHRLICH oder NORMAL]. Dies steuert den Detaillierungsgrad der Ausgabe `SYSPRINT `
+ Stellen Sie sicher, dass der Pfad zum Lademodul der `JES\Configuration\JES Program Path` Einstellung hinzugefügt wurde
+ Stellen Sie sicher, dass die Skripts im Verzeichnis der Dienstprogramme über Ausführungsberechtigungen verfügen. In der Linux-Umgebung können Sie mit dem `chmod + x <script name>` Befehl eine Ausführungsberechtigung hinzufügen

## Allgemeine Syntax
<a name="mdfutil-syntax"></a>

### DUMP
<a name="mdfutil-dump"></a>

Bietet die Möglichkeit, Dateien vom aktuellen katalogisierten Speicherort an einen Backup-Speicherort zu kopieren. Bei diesem Speicherort muss es sich derzeit um ein Dateisystem handeln.

#### Prozess
<a name="mdfutil-dump-process"></a>

DUMP führt Folgendes aus:

1. Erstellen Sie das Zielverzeichnis.

1. Katalogisieren Sie das Zielverzeichnis als PDS-Mitglied.

1. Ermitteln Sie, welche Dateien eingeschlossen werden sollen, indem Sie den INCLUDE-Parameter verarbeiten.

1. Deaktivieren Sie die eingeschlossenen Dateien, indem Sie den EXCLUDE-Parameter verarbeiten.

1. Ermitteln Sie, ob die ausgegebenen Dateien GELÖSCHT werden sollen.

1. Stellen Sie die zu verarbeitenden Dateien in eine Warteschlange.

1. Kopieren Sie die Dateien.

1. Exportieren Sie die katalogisierten DCB-Informationen der kopierten Dateien in eine Nebendatei am Zielort, um future RESTORE-Operationen zu unterstützen.

#### Syntax
<a name="mdfutil-dump-syntax"></a>

```
DUMP
TARGET ( TARGET LOCATION  )    -
INCLUDE ( DSN. )
[ EXCLUDE ( DSN ) ]
[ CANCEL | IGNORE ]
[ DELETE ]
```

#### Erforderliche Parameter
<a name="mdfutil-dump-requiredparam"></a>

Im Folgenden sind die erforderlichen Parameter für DUMP aufgeführt:
+ `SYSPRINT DD NAME`- Um zusätzliche Protokollierungsinformationen zu enthalten
+ `TARGET`- Zielort. Dies kann folgendes sein:
  + Vollständiger Pfad des Speicherorts
  + **Name des Unterverzeichnisses, das an dem in der Variablen M2DFUTILS\$1BASE\$1LOC definierten Speicherort erstellt wurde**
+ `INCLUDE`— Entweder ein einziger benannter DSNAME oder eine gültige Mainframe-DSN-Suchzeichenfolge
+ `EXCLUDE`- Entweder ein einziger benannter DSNAME oder eine gültige Mainframe-DSN-Suchzeichenfolge

#### Optionale Parameter
<a name="mdfutil-dump-optionalparam"></a>
+ CANCEL — Stornieren Sie den Vorgang, falls ein Fehler auftritt. Dateien, die verarbeitet wurden, werden beibehalten
+ (Standard) IGNORE — Ignoriert jeden Fehler und verarbeitet den Vorgang bis zum Ende
+ DELETE — Wenn kein ENQ-Fehler auftritt, wird die Datei gelöscht und nicht katalogisiert

### DELETE
<a name="mdfutil-delete"></a>

Bietet die Möglichkeit, Dateien massenweise zu löschen und deren Katalogisierung aufzuheben. Dateien werden nicht gesichert.

#### Prozess
<a name="mdfutil-delete-process"></a>

DELETE führt Folgendes aus:

1. Ermitteln Sie, welche Dateien eingeschlossen werden sollen, indem Sie den INCLUDE-Parameter verarbeiten.

1. Deaktivieren Sie die eingeschlossenen Dateien, indem Sie den EXCLUDE-Parameter verarbeiten.

1. Stellen Sie die zu verarbeitenden Dateien in die Warteschlange. Setzen Sie die Disposition auf OLD, DELETE, KEEP.

#### Syntax
<a name="mdfutil-delete-syntax"></a>

```
DELETE
INCLUDE ( DSN )
[ EXCLUDE ( DSN ) ]
[ CANCEL | IGNORE ]
[ DELETE ]
```

#### Erforderliche Parameter
<a name="mdfutil-delete-requiredparam"></a>

Im Folgenden sind die erforderlichen Parameter für DELETE aufgeführt:
+ `SYSPRINT DD NAME`- Um zusätzliche Protokollierungsinformationen zu enthalten
+ `INCLUDE`— Entweder ein einzelner benannter DSNAME oder eine gültige Mainframe-DSN-Suchzeichenfolge 
+ `EXCLUDE`- Entweder ein einziger benannter DSNAME oder eine gültige Mainframe-DSN-Suchzeichenfolge 

#### Optionale Parameter
<a name="mdfutil-delete-optionalparam"></a>
+ CANCEL — Stornieren Sie den Vorgang, falls ein Fehler auftritt. Verarbeitete Dateien werden beibehalten 
+ (Standard) IGNORE — Ignoriert jeden Fehler und verarbeitet den Vorgang bis zum Ende

### RESTORE
<a name="mdfutil-restore"></a>

Bietet die Möglichkeit, Dateien wiederherzustellen, die zuvor mit DUMP gesichert wurden. Dateien werden am ursprünglichen katalogisierten Speicherort wiederhergestellt, sofern RENAME nicht verwendet wird, um den wiederhergestellten DSNAME zu ändern.

#### Prozess
<a name="mdfutil-restore-process"></a>

RESTORE führt Folgendes aus:

1. Überprüfen Sie das Quellverzeichnis.

1. Ermitteln Sie, welche Dateien aufgenommen werden sollen, indem Sie die Katalogexportdatei verarbeiten.

1. Deaktivieren Sie die eingeschlossenen Dateien, indem Sie den EXCLUDE-Parameter verarbeiten.

1. Stellen Sie die zu verarbeitenden Dateien in die Warteschlange.

1. Katalogdateien, die nicht anhand ihrer Exportinformationen katalogisiert wurden.

1. Wenn eine Datei bereits katalogisiert ist und die Exportkataloginformationen identisch sind, ersetzt RESTORE den katalogisierten Datensatz, sofern die Option REPLACE gesetzt ist.

#### Syntax
<a name="mdfutil-restore-syntax"></a>

```
RESTORE
SOURCE ( TARGET LOCATION ) 
INCLUDE ( DSN )
[ EXCLUDE ( DSN ) ]
[ CANCEL | IGNORE ]
[ REPLACE]
```

#### Erforderliche Parameter
<a name="mdfutil-restore-requiredparam"></a>

Im Folgenden sind die erforderlichen Parameter für RESTORE aufgeführt:
+ `SYSPRINT DD NAME`— Um zusätzliche Protokollierungsinformationen zu enthalten 
+ `SOURCE`- Standort der Quelle. Dies kann folgendes sein:
  + Vollständiger Pfad des Speicherorts
  + **Name des Unterverzeichnisses, das an dem in der Variablen M2DFUTILS\$1BASE\$1LOC definierten Speicherort erstellt wurde**
+ `INCLUDE`— Entweder ein einziger benannter DSNAME oder eine gültige Mainframe-DSN-Suchzeichenfolge
+ `EXCLUDE`- Entweder ein einziger benannter DSNAME oder eine gültige Mainframe-DSN-Suchzeichenfolge

#### Optionale Parameter
<a name="mdfutil-restore-optionalparam"></a>
+ ABBRECHEN — Stornieren, falls ein Fehler auftritt. Verarbeitete Dateien wurden beibehalten
+ (Standard) IGNORE — Ignoriert jeden Fehler und verarbeitet den Vorgang bis zum Ende
+ REPLACE — Wenn die wiederherzustellende Datei bereits katalogisiert ist und die Katalogdatensätze identisch sind, ersetzen Sie die katalogisierte Datei

## Beispiel JCLs
<a name="mdfutil-sample-jcls"></a>

 **DUMP-Job**

Dieser Job erstellt ein Unterverzeichnis namens. `TESTDUMP` Dies ist der Standardspeicherort für Backups, der durch die Variable **M2DFUTILS\$1BASE\$1LOC** angegeben wird. Es erstellt eine PDS-Bibliothek für dieses Backup namens. `M2DFUTILS.TESTDUMP` Die exportierten Katalogdaten werden in einer zeilensequentiellen Datei im Backup-Verzeichnis namens gespeichert. `CATDUMP.DAT` Alle ausgewählten Dateien werden in dieses Backup-Verzeichnis kopiert.

```
//M2DFDMP JOB 'M2DFDMP',CLASS=A,MSGCLASS=X
//STEP001  EXEC PGM=M2DFUTIL
//SYSPRINT DD DSN=TESTDUMP.SYSPRINT,
//        DISP=(NEW,CATLG,DELETE),
//        DCB=(RECFM=LSEQ,LRECL=256)
//SYSIN    DD *
DUMP TARGET(TESTDUMP)               -
     INCLUDE(TEST.FB.FILE*.ABC)     -
 CANCEL
/*
//
```

 **Job LÖSCHEN**

Dieser Job löscht alle Dateien aus dem Katalog, die dem INCLUDE-Parameter entsprechen.

```
/M2DFDEL JOB 'M2DFDEL',CLASS=A,MSGCLASS=X
//STEP001  EXEC PGM=M2DFUTIL
//SYSPRINT DD DSN=TESTDEL.SYSPRINT,
//        DISP=(NEW,CATLG,DELETE),
//        DCB=(RECFM=LSEQ,LRECL=256)
//SYSPRINT DD SYSOUT=A
//SYSIN    DD *
  DELETE                               -
     INCLUDE(TEST.FB.FILE*.ABC)        -
 CANCEL
/*
 //
```

 **Job WIEDERHERSTELLEN**

Dieser Job stellt die Dateien, die dem INCLUDE-Parameter entsprechen, aus dem `TESTDUMP` Backup-Speicherort wieder her. Katalogisierte Dateien werden ersetzt, wenn die katalogisierte Datei mit der Datei im CATDUMP-Export übereinstimmt und die Option REPLACE angegeben ist.

```
//M2DFREST JOB 'M2DFREST',CLASS=A,MSGCLASS=X
//STEP001  EXEC PGM=M2DFUTIL
////SYSPRINT DD DSN=TESTREST.SYSPRINT,
//        DISP=(NEW,CATLG,DELETE),
//        DCB=(RECFM=LSEQ,LRECL=256)
//SYSPRINT DD SYSOUT=A
//SYSIN    DD *
RESTORE SOURCE(TESTDUMP)               -
     INCLUDE(TEST.FB.FILE*.ABC)        -
 IGNORE
 REPLACE
/*
//
```

# M2RUNCMD Batch-Hilfsprogramm
<a name="m2runcmd"></a>

Sie können M2RUNCMD, ein Batch-Hilfsprogramm, verwenden, um Befehle, Skripte und Systemaufrufe von Rocket Software (ehemals Micro Focus) direkt von JCL aus auszuführen, anstatt sie über ein Terminal oder eine Befehlszeile auszuführen. Die Ausgabe der Befehle wird im Spool-Protokoll des Batch-Jobs protokolliert.

**Topics**
+ [Unterstützte Plattformen](#m2runcmd-platforms)
+ [M2RUNCMD für AWS Mainframe Modernization Runtime auf Amazon EC2 konfigurieren (einschließlich 2.0) AppStream](#m2runcmd-configure)
+ [Beispiel JCLs](#m2runcmd-sample-jcls)

## Unterstützte Plattformen
<a name="m2runcmd-platforms"></a>

Sie können M2RUNCMD auf den folgenden Plattformen verwenden:
+ Rocket Software Runtime (auf Amazon EC2)
+  Alle Varianten der Produkte Rocket Software Enterprise Developer (ED) und Rocket Software Enterprise Server (ES).

## M2RUNCMD für AWS Mainframe Modernization Runtime auf Amazon EC2 konfigurieren (einschließlich 2.0) AppStream
<a name="m2runcmd-configure"></a>

Wenn Ihre migrierten Anwendungen auf der AWS Mainframe Modernization Runtime auf Amazon EC2 ausgeführt werden, konfigurieren Sie M2RUNCMD wie folgt.
+ Ändern Sie den [Micro Focus JES-Programmpfad](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/index.html?t=GUID-BC8A1796-9EDE-48EB-8363-31C9BDE7F96B.html) so, dass er den binären Speicherort für Batch-Dienstprogramme enthält. Wenn Sie mehrere Pfade angeben müssen, verwenden Sie Doppelpunkte (:), um Pfade unter Linux und Semikolons (;) unter Windows zu trennen.
  + Linux: `/opt/aws/m2/microfocus/utilities/64bit`
  + Windows (32-Bit): `C:\AWS\M2\MicroFocus\Utilities\32bit`
  + Windows (64 Bit): `C:\AWS\M2\MicroFocus\Utilities\64bit`

## Beispiel JCLs
<a name="m2runcmd-sample-jcls"></a>

Um die Installation zu testen, können Sie eines der folgenden Beispiele verwenden JCLs.

 **RUNSCRL1.jcl**

Diese Beispiel-JCL erstellt ein Skript und führt es aus. Im ersten Schritt wird ein Skript mit dem Namen `/tmp/TEST_SCRIPT.sh` und Inhalt aus `SYSUT1` In-Stream-Daten erstellt. Im zweiten Schritt wird die Ausführungsberechtigung festgelegt und das im ersten Schritt erstellte Skript ausgeführt. Sie können sich auch dafür entscheiden, nur den zweiten Schritt auszuführen, um bereits vorhandene Rocket Software- und Systembefehle auszuführen.

```
//RUNSCRL1 JOB 'RUN SCRIPT',CLASS=A,MSGCLASS=X,TIME=1440
//*
//*
//*-------------------------------------------------------------------*
//*  CREATE SCRIPT (LINUX)                                           
//*-------------------------------------------------------------------*
//*
//STEP0010 EXEC PGM=IEBGENER
//*
//SYSPRINT DD SYSOUT=*
//SYSIN    DD DUMMY
//*
//SYSUT1   DD *
#!/bin/bash

set -x

## ECHO PATH ENVIRONMNET VARIABLE
echo $PATH

## CLOSE/DISABLE VSAM FILE
casfile -r$ES_SERVER -oc  -ed -dACCTFIL

## OPEN/ENABLE VSAM FILE
casfile -r$ES_SERVER -ooi -ee -dACCTFIL

exit $?
/*
//SYSUT2   DD DSN=&&TEMP,
//            DISP=(NEW,CATLG,DELETE),
//            DCB=(RECFM=LSEQ,LRECL=300,DSORG=PS,BLKSIZE=0)
//*MFE: %PCDSN='/tmp/TEST_SCRIPT.sh'
//*
//*-------------------------------------------------------------------*
//*   RUN SCRIPT (LINUX)                                              *
//*-------------------------------------------------------------------*
//*
//STEP0020 EXEC PGM=RUNCMD
//*
//SYSOUT  DD  SYSOUT=*
//* 
//SYSIN   DD *
*RUN SCRIPT
 sh /tmp/TEST_SCRIPT.sh
/*
//
```

 **SYSOUT**

Die Ausgabe des Befehls oder Skripts, das ausgeführt wird, wird in das `SYSOUT` Protokoll geschrieben. Für jeden ausgeführten Befehl werden der Befehl, die Ausgabe und der Rückgabecode angezeigt.

```
************ CMD Start ************   
                                                                                    
CMD_STR: sh /tmp/TEST_SCRIPT.sh                                                                                              
CMD_OUT:                                                                                                                                                                                                                             
+ echo /opt/microfocus/EnterpriseServer/bin:/sbin:/bin:/usr/sbin:/usr/bin    
/opt/microfocus/EnterpriseServer/bin:/sbin:/bin:/usr/sbin:/usr/bin           
+ casfile -rMYDEV -oc -ed -dACCTFIL                                                                       
-Return Code:   0                                                                                                         
Highest return code:    0                                                                                                 
+ casfile -rMYDEV -ooi -ee -dACCTFIL                                                                     
-Return Code:   8                                                                                                         
Highest return code:    8                                                                                                 
+ exit 8                                                                                                                  

CMD_RC=8                                                                                                                  

************  CMD End  ************
```

 **RUNCMDL1.jcl**

Diese Beispiel-JCL verwendet RUNCMD, um mehrere Befehle auszuführen.

```
//RUNCMDL1 JOB 'RUN CMD',CLASS=A,MSGCLASS=X,TIME=1440
//*
//*
//*-------------------------------------------------------------------*
//*   RUN SYSTEM COMMANDS                                             *
//*-------------------------------------------------------------------*
//*
//STEP0001 EXEC PGM=RUNCMD
//*
//SYSOUT  DD  SYSOUT=*
//* 
//SYSIN   DD *
*LIST DIRECTORY
 ls
*ECHO PATH ENVIRONMNET VARIABLE
 echo $PATH
/*
//
```