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.
# AWS Modernisierung von Mainframes und Neuplattformen mit NTT DATA
AWS Mainframe Modernization bietet eine Vielzahl von Amazon Machine Images (AMIs). Diese AMIs ermöglichen die schnelle Bereitstellung von Amazon EC2 EC2-Instances und schaffen eine maßgeschneiderte Umgebung für das Rehosting und die Neuplattformierung von Mainframe-Anwendungen mithilfe von NTT Data. AWS Dieses Handbuch enthält die erforderlichen Schritte, um auf diese zuzugreifen und sie zu verwenden. AMIs
## Voraussetzungen
+ Stellen Sie sicher, dass Sie Administratorzugriff auf ein AWS Konto haben, mit dem Sie Amazon EC2 EC2-Instances erstellen können.
+ Stellen Sie sicher, dass der AWS Mainframe-Modernisierungsservice in der Region verfügbar ist, in der Sie die Amazon EC2 EC2-Instances erstellen möchten. Sehen Sie sich [die Liste der verfügbaren AWS-Services nach Regionen](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/) an.
+ Identifizieren Sie die Amazon VPC, in der Sie die Amazon EC2 EC2-Instances erstellen möchten.
## Abonnieren Sie das Amazon Machine Image
Wenn Sie ein AWS Marketplace Marketplace-Produkt abonnieren, können Sie eine Instance über das AMI des Produkts starten.
1. Melden Sie sich bei [https://console.aws.amazon.com/marketplace](https://console.aws.amazon.com/marketplace) an AWS-Managementkonsole und öffnen Sie die AWS Marketplace Konsole.
1. Wählen Sie **Manage subscriptions (Abonnements verwalten)**.
1. [Kopieren Sie den folgenden Link und fügen Sie ihn in die Adressleiste des Browsers ein: https://aws.amazon.com/marketplace/ pp/prodview-eg227ymldsnx2](https://aws.amazon.com/marketplace/pp/prodview-eg227ymldsnx2)
1. Wählen Sie **Continue to Subscribe (Weiter abonnieren)** aus.
1. **Wenn die Allgemeinen Geschäftsbedingungen akzeptabel sind, wählen Sie Bedingungen akzeptieren.** Die Bearbeitung des Abonnements kann einige Minuten dauern.
1. Warten Sie, bis eine Dankesnachricht erscheint. Diese Nachricht bestätigt, dass Sie das Produkt erfolgreich abonniert haben.
1. Wählen Sie im linken Navigationsbereich die Option **Abonnements verwalten** aus. In dieser Ansicht werden Ihnen alle Ihre Abonnements angezeigt.
## Starten Sie die AWS Mainframe Modernization Replatform mit der NTT DATA-Instanz
1. [Öffnen Sie die AWS Marketplace Konsole unter /marketplace. https://console.aws.amazon.com](https://console.aws.amazon.com/marketplace)
1. Wählen Sie im linken Navigationsbereich die Option **Abonnements verwalten** aus.
1. Suchen Sie das AMI, das Sie starten möchten, und wählen Sie **Neue Instanz starten** aus.
1. Wählen Sie unter **Region** die Region aus, für die die Zulassung gilt.
1. Wählen Sie **Weiter, um über EC2 zu starten**. Mit dieser Aktion gelangen Sie zur Amazon EC2 EC2-Konsole.
1. Geben Sie einen Namen für den Server ein.
1. Wählen Sie einen Instance-Typ, der Ihren Leistungs- und Kostenanforderungen für Ihr Projekt entspricht. Der empfohlene Startpunkt für die Instanzgröße ist`c5.2xLarge`.
1. Wählen Sie ein vorhandenes key pair oder erstellen und speichern Sie ein neues. Informationen zu Schlüsselpaaren finden Sie unter [Amazon EC2 EC2-Schlüsselpaare und Linux-Instances](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html) im Amazon EC2 EC2-Benutzerhandbuch.
1. Bearbeiten Sie die Netzwerkeinstellungen und wählen Sie die VPC auf der Zulassungsliste und das entsprechende Subnetz aus.
1. Wählen Sie eine bestehende Sicherheitsgruppe oder erstellen Sie eine neue. Wenn es sich um eine Enterprise Server Amazon EC2 EC2-Instance handelt, ist es in der Regel üblich, TCP-Verkehr zu den Ports 86 und 10086 zuzulassen, um die Konfiguration von Rocket Software (ehemals Micro Focus) zu verwalten.
1. Konfigurieren Sie den Speicher für die Amazon EC2 EC2-Instance.
1. Lesen Sie die Zusammenfassung und wählen Sie **Launch Instance** aus. Damit der Start erfolgreich ist, muss der Instance-Typ gültig sein. Wenn der Start fehlschlägt, wählen Sie **Instance-Konfiguration bearbeiten** und wählen Sie einen anderen Instance-Typ.
1. Wenn Sie die Erfolgsmeldung sehen, wählen Sie **Connect to instance** aus.
1. Öffnen Sie die Amazon-EC2-Konsole unter [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Wählen Sie im linken Navigationsbereich unter dem Menü **Instances** die Option **Instances** aus.
1. Überprüfen Sie im Hauptbereich den Status Ihrer Instance.
## Erste Schritte mit NTT Data
Nachdem Sie die Amazon EC2 EC2-Instance bereitgestellt haben, greifen Sie mit dem Benutzernamen per SSH auf sie zu. `ec2-user` Der Bildschirm wird wie in der folgenden Abbildung aussehen.
![\[SSH-Bildschirm mit bereitgestellter Amazon EC2 EC2-Instanz und Benutzername.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/unikix-start-screen.png)
Unter dem `/opt/software/` Ordner befindet sich ein Ordner mit dem Namen`UniKix_Product_Guides`, wie in der folgenden Abbildung dargestellt.
![\[SSH-Bildschirm mit Details zum /opt/software/ Ordner. Finde den OrdnerUniKix_Product_Guides.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/unikix-product-guides.png)
Der `UniKix_Product_Guides` Ordner enthält die Dokumentation für die folgenden Komponenten, die auf dieser Amazon EC2 EC2-Instance installiert sind:
+ NTT-DATENTYP
+ NTT-DATEN BPE
+ NTT DATA COBOL für Unternehmen
+ NTT DATA ist sicher UniKix
+ Zentraler Manager von NTT DATA UniKix
Der `software` Ordner, der im vorherigen Bild angezeigt wird, enthält die Binärdateien für die oben aufgeführten Komponenten.
Nachdem Sie die Amazon EC2 EC2-Instance erfolgreich validiert haben, beginnen Sie mit der Nutzung von AWS Mainframe Modernization Replatform mit NTT DATA, indem Sie der NTT Data-Dokumentation folgen.
# Tutorial: Anwendung auf NTT DATA bereitstellen CardDemo
Diese Seite führt Sie durch den step-by-step Prozess zur Bereitstellung der CardDemo Beispielanwendung auf der AWS Mainframe Modernization Replatform mit NTT DATA Unikix Runtime.
Bei der CardDemo Beispielanwendung handelt es sich um eine vereinfachte Mainframe-Anwendung, die entworfen und entwickelt wurde, um Technologien für Anwendungsfälle der Mainframe-Migration und -Modernisierung zu testen und zu präsentieren AWS und zu präsentieren und mit Partnern zusammenzuarbeiten.
[Weitere Informationen zu dieser Anwendung finden Sie unter Repository für. GitHub CardDemo](https://github.com/aws-samples/aws-mainframe-modernization-carddemo)
**Topics**
+ [Flussdiagramm für die Bereitstellung](#tutorial-unikix-workflow)
+ [Voraussetzungen](#tutorial-unikix-prerequisites)
+ [Schritt 1: Bereiten Sie die Umgebung vor](#tutorial-unikix-prepare)
+ [Schritt 2: Erstellen Sie eine TPE-Region](#tutorial-unikix-tpe)
+ [Schritt 3: Erstellen Sie den BPE-Knoten und das Subsystem](#tutorial-unikix-bpe)
+ [Schritt 4: Anwendung kompilieren und bereitstellen CardDemo](#tutorial-unikix-compile)
+ [Schritt 5: BPE- und TPE-Katalog importieren](#tutorial-unikix-import)
+ [Schritt 6: Starten und verbinden Sie TPE mit BPE](#unikix-tutorial-connect)
+ [Schritt 7: Führen Sie die Anwendung aus CardDemo](#unikix-tutorial-run-application)
+ [Fehlerbehebung](#tutorial-unikix-troubleshoot)
## Flussdiagramm für die Bereitstellung
Das folgende Diagramm zeigt jeden Schritt im Workflow für die Bereitstellung einer Anwendung auf der NTT DATA Unikix-Laufzeit.
![\[Der allgemeine Arbeitsablauf bei der Bereitstellung der Anwendung auf der NTT DATA Unikix-Laufzeit.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/unikix-process.png)
## Voraussetzungen
+ Folgen Sie den Anweisungen unter [AWS Modernisierung von Mainframes und Neuplattformen mit NTT DATA](unikix.md) Verwenden des [NTT DATA UniKix Marketplace AMI](https://aws.amazon.com/marketplace/pp/prodview-eg227ymldsnx2).
+ Ändern Sie die Option für Instance-Metadaten **IMDSv2**auf **Optional**, wie unter [Restore the use of IMDSv1](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-IMDS-existing-instances.html) im *Amazon EC2 EC2-Benutzerhandbuch* beschrieben.
+ Laden Sie die CardDemo Laufzeitkomponenten für NTT DATA von UniKix der
[GitHub Repository](https://github.com/aws-samples/aws-mainframe-modernization-carddemo/blob/main/samples/m2/unikix/UniKix_CardDemo_runtime_v1.zip).
+ Melden Sie sich bei der UniKix EC2-Runtime-Instanz an als`ec2-user`.
+ Extrahieren Sie die heruntergeladenen CardDemo Runtime-Komponenten über diesen Link: [UniKix\$1 CardDemo \$1runtime\$1v1.zip](https://github.com/aws-samples/aws-mainframe-modernization-carddemo/blob/main/samples/m2/unikix/UniKix_CardDemo_runtime_v1.zip).
+ Das entpackte Verzeichnis sollte zwei `migrated_app` Verzeichnisse enthalten`bin`.
+ Verschieben Sie `bin` sowohl als auch `migrated_app` Verzeichnisse in Ihr `$HOME` Verzeichnis. Der Pfad würde so aussehen`/home/ec2-user`.
+ Sie sollten die folgenden Verzeichnisse in Ihrem haben`$HOME`:
+ `/home/ec2-user/bin`
+ `/home/ec2-user/migrated_app`
+ Verschieben Sie alle Dateien im Verzeichnis \$1HOME/bin mit dem folgenden Befehl:
+
+ `chmod +x $HOME/bin/*`
## Schritt 1: Bereiten Sie die Umgebung vor
Nachdem Sie die Voraussetzungen erfüllt haben, besteht der erste Schritt darin, die Umgebung vorzubereiten, in der Sie die CardDemo Anwendung bereitstellen möchten.
1. Melden Sie sich bei der UniKix EC2-Runtime-Instanz an als`ec2-user`.
1. Beachten Sie die Liste der im AMI vorkonfigurierten UniKix Softwarepakete wie TPE, BPE und COBOL sowie andere Software aus dem NTT UniKix DATA-Produktverzeichnis, indem Sie den folgenden Befehl in Ihrer EC2-Instance verwenden:
```
ls -l /opt/software/
```
1. Untersuchen Sie die migrierte Anwendung. CardDemo Sie werden den gesamten Quellcode sehen, einschließlich BMS-Maps, COBOL-Programmen, COBOL-Copybooks und. JCLs Auf diese Weise finden Sie auch den Export von BPE- und TPE-Katalogen, CICS-Ressourcendefinitionen und den migrierten Daten wie sequentiellen Dateien und VSAM-Dateien:
```
ls $HOME/migrated_app/*/*
```
1. Erstellen Sie eine Ordnerstruktur, indem Sie das Skript mit dem folgenden Befehl ausführen: `create_project`
```
sh $HOME/bin/create_project
```
1. Aktivieren Sie die CardDemo Umgebung, indem Sie die `carddemo.env` Setup-Datei wie folgt beziehen:
```
source $HOME/bin/carddemo.env
```
## Schritt 2: Erstellen Sie eine TPE-Region
Nachdem Sie die Umgebung aktiviert haben, in der Sie die Anwendung bereitstellen möchten, müssen Sie eine TPE-Region erstellen.
1. Erstellen Sie eine TPE-Region mit dem `kixregion createRegion` Befehl, der Eingaben wie `$KIXSYS``$JAVA_HOME`, und erfordert. `$KIXLICDIR` Diese Umgebungsvariablen sind bereits in der `carddemo.env` Setup-Datei eingerichtet.
```
kixregion createRegion $KIXSYS $JAVA_HOME $KIXLICDIR
```
1. Konfigurieren Sie die TPE-Region mit dem `kixregion setAttr` Befehl.
```
kixregion setAttr $KIXSYS server.tx.languages.cobol.enabled true
kixregion setAttr $KIXSYS server.tx.languages.cobol.flavor vcobol
kixregion setAttr $KIXSYS server.tx.languages.cobol.home $VCOBOL
kixregion setAttr $KIXSYS maps.location $PROJECT_ROOT/maps
kixregion setAttr $KIXSYS programs.location $PROJECT_ROOT/loadlib
kixregion setAttr $KIXSYS environment.KIXDATA $KIXDATA
kixregion setAttr $KIXSYS td.jobq.submission.node $EBMHOME
kixregion setAttr $KIXSYS td.jobq.submission.subsys $EBMSYS
```
1. Generieren Sie die für diese TPE-Region spezifische Benutzerumgebungsdatei, indem Sie den `kixregion createScript` Befehl ausführen. Dieser Befehl erstellt oder aktualisiert `$KIXSYS/bin/userenv` basierend auf der TPE-Regionskonfiguration.
```
kixregion createScript $KIXSYS
```
1. Aktivieren Sie die TPE-Region, indem Sie die Benutzerumgebungsdatei () `$KIXSYS/bin/userenv` abrufen.
```
source $KIXSYS/bin/userenv
```
1. Erstellen Sie die TPE-Region, indem Sie den `kixinstall2` Befehl ausführen.
```
kixinstall2
```
## Schritt 3: Erstellen Sie den BPE-Knoten und das Subsystem
Nachdem Sie eine TPE-Region erstellt haben, müssen Sie den BPE-Knoten und das BPE-Subsystem erstellen, indem Sie die folgenden Schritte ausführen.
1. Ändern Sie den Besitz und die Berechtigungen von. `INSTEBM`
```
sudo chown root $INSTEBM
sudo chmod 4755 $INSTEBM
```
1. Erstellen Sie mit dem `INSTEBM` Befehl einen BPE-Knoten. Das BPE-Knotenverzeichnis wird als Eingabeparameter bereitgestellt.
```
$INSTEBM $EBMHOME
```
1. Aktivieren Sie die Batch-Umgebung, indem Sie die `batchenv` Datei vom neu erstellten BPE-Knoten beziehen.
```
source $EBMHOME/batchenv
```
1. Erstellen Sie das BPE-Subsystem innerhalb dieses Knotens mit dem Batch Administration Manager (bam). Der `bam` Befehl öffnet die Batch Administration Manager-Oberfläche.
```
bam
```
1. Starten Sie den BPE-Knoten über die BAM-Schnittstelle. Wählen Sie im Hauptmenü Option 2, **Systemumgebungen**.
![\[Wählen Sie in Batch Administrator Manager Option 2 Systemumgebungen aus.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/unikix-bpe-1.png)
1. Wählen Sie Option 2, **Start/ (Stop) Batch Node, um den BPE-Knoten** zu starten.
![\[Wählen Sie unter Systemumgebungen Option 2 Start/Stop Batch Node aus.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/unikix-bpe-2.png)
1. Drücken Sie nach dem Start zweimal die **Eingabetaste**, um zum BAM-Hauptmenü zurückzukehren.
![\[Bildschirm „Batch Node Startup abgeschlossen“.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/unikix-bpe-3.png)
1. Um das BPE-Subsystem zu erstellen, wählen Sie Option 3, **Anwendungen und** Subsysteme.
![\[Option 3 Auf der Batch Administrator Manager-Seite ausgewählte Anwendungen und Subsysteme.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/unikix-bpe-4.png)
1. Wählen Sie dann Option 3, **Subsystem erstellen**.
![\[Option 3 Erstellen Sie ein Subsystem, das auf dem Bildschirm „Anwendungen und Subsysteme“ ausgewählt wurde.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/unikix-bpe-5.png)
1. Geben Sie den Namen des Subsystems als ein. `sys1`
![\[Auf dem Bildschirm „Erstellen“ wurde sys1 eingegeben.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/unikix-bpe-6.png)
1. Wählen Sie Option 3, **Datenverwaltung**.
![\[Wählen Sie auf dem Bildschirm „Erstellen“ in Anwendungen und Subsystem Option 3 „Datenverwaltung“.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/unikix-bpe-7.png)
1. Wählen Sie Option 5, da die CardDemo Anwendung sowohl sequentielle als auch VSAM-Dateien umfasst.
![\[Wählen Sie Option 5, um sequenzielle Dateien und VSAM-Dateien einzubeziehen.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/unikix-bpe-8.png)
1. (Optional). Drücken Sie „R“, um zur Seite „**Menü erstellen**“ zurückzukehren und die verschiedenen verfügbaren Konfigurationsoptionen zu überprüfen.
1. Geben Sie auf der Seite „**Erstellen**“ „C“ ein, um das Subsystem `sys1` zu erstellen.
![\[Drücken Sie „C“ auf der Tastatur, um das Subsystem sys1 zu erstellen.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/unikix-bpe-9.png)
1. Überprüfen Sie die Einstellungen und geben Sie „C“ ein, um mit den restlichen Umgebungseinstellungen fortzufahren. Diese Umgebungseinstellungen sind vorbelegt, da die erforderlichen Umgebungsvariablen in der `carddemo.env` Setup-Datei definiert sind und die empfohlene Ordnerstruktur vorhanden ist.
1. Geben Sie „y“ ein, um die aktuellen Umgebungseinstellungen zu bestätigen und zu speichern.
![\[Zeigt an, dass die Umgebungseinstellungen des Sys1-Subsystems abgeschlossen sind. Geben Sie außerdem „y“ ein, um die aktuellen Einstellungen zu speichern.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/unikix-bpe-10.png)
1. Geben Sie „y“ ein, um das Protokoll beim Aufbau des Subsystems anzuzeigen.
![\[Zeigt den Aufbau des NTT DATA COBOL-Laufzeitsystems von sys1 auf dem Bildschirm an.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/unikix-bpe-11.png)
1. **Drücken Sie die Eingabetaste, bis Sie zum Hauptmenü **zurückkehren**, und verlassen Sie die BAM-Oberfläche, indem Sie die Option Quit wählen.**
![\[Zeigt das erstellte COBOL-Laufzeitsystem an. Fordert außerdem auf, die Eingabetaste zu drücken, um fortzufahren.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/unikix-bpe-12.png)
![\[Kehrt zum Menü Erstellen zurück und zeigt an, dass das Subsystem sys1 erstellt wurde. Und die Konfiguration ist aktualisiert. Fordert auf, die Eingabetaste zu drücken, um fortzufahren.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/unikix-bpe-13.png)
![\[Hauptmenü für Batch Administrator. Fordert zur Eingabe von Q auf, um dieses Menü zu verlassen.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/unikix-bpe-14.png)
1. Aktivieren Sie das BPE-Subsystem, indem Sie das `batchenv` mit dem Namen des Subsystems beziehen. `sys1`
```
source $EBMHOME/batchenv sys1
```
## Schritt 4: Anwendung kompilieren und bereitstellen CardDemo
In diesem Schritt kompilieren Sie die COBOL-Programme und stellen Anwendungsartefakte wie JCL, Prozeduren, Datendateien und CICS-Ressourcendefinitionen bereit.
1. Aktivieren Sie die CardDemo Umgebung erneut, indem Sie die Setup-Datei abrufen`carddemo.env`.
```
source $HOME/bin/carddemo.env
```
1. Navigieren Sie zum COBOL-Quellverzeichnis.
```
cd $MIGAPP_DIR/cbl
```
1. Kompilieren Sie das Cobol-Programm `CBACT01C.cbl` mithilfe eines Skripts`compile`.
```
compile CBACT01C.cbl
```
1. Kompilieren Sie alle Cobol-Programme mithilfe eines Skripts`compile.all`.
```
compile.all
```
1. Navigieren Sie zum Quellverzeichnis von BMS Maps.
```
cd $MIGAPP_DIR/bms
```
1. Kompilieren Sie die BMS-Map `COACTUP.bms` mithilfe eines Skripts`compbms`.
```
compbms COACTUP.bms
```
1. Kompilieren Sie alle BMS-Karten mithilfe eines Skripts`compbms.all`.
```
compbms.all
```
1. Überprüfen Sie die kompilierten Binärdateien für COBOL- und BMS-Karten.
```
ls $PROJECT_ROOT/loadlib
ls $PROJECT_ROOT/maps
```
1. Stellen Sie mithilfe des Skripts andere Anwendungsartefakte wie JCL, Prozeduren, Datendateien und CICS-Ressourcendefinitionen bereit. `deploy_app`
```
deploy_app
```
1. Navigieren Sie zum JCL-Verzeichnis des Projekts.
```
cd $PROJECT_ROOT/jcl
```
1. Translate Sie JCL ACCTFILE in BPE JCL Macro. Verwenden Sie den `mvstrans` Befehl und verwenden Sie dabei die Option „-v“ für die JCL-Überprüfung und die Option „-f“, um das Makro zu erstellen.
```
mvstrans ACCTFILE -v
mvstrans ACCTFILE -f
```
1. Translate Sie die JCL-Prozedur REPROC in die BPE JCL-Prozedur Macro. Verwenden Sie den `mvstrans` Befehl mit der Option „-p“ zusammen mit der Option „-v“ zur Überprüfung und der Option „-f“, um das Makro zu erstellen.
```
mvstrans REPROC -v -p
mvstrans REPROC -f -p
```
1. Translate Sie alle JCLs und JCL-Prozeduren.
```
for file in "./jmvs/*"; do mvstrans $file -f; done > jmvs.out
for file in "./mvsp/*"; do mvstrans $file -p -f; done > mvsp.out
```
## Schritt 5: BPE- und TPE-Katalog importieren
In diesem Schritt importieren Sie den BPE- und TPE-Katalog mit unterschiedlichen Befehlen.
1. Importieren Sie den BPE-Katalog mithilfe eines Befehls. `loadcat`
```
loadcat $MIGAPP_DIR/catlg/bpe/BPECAT*
```
1. Navigieren Sie zum Verzeichnis \$1KIXSYS.
```
cd $KIXSYS
```
1. Importieren Sie den TPE-Katalog mit dem Befehl. `kiximpcat`
```
kiximpcat -c CATALOG -l CATALOG.lst
```
1. Importieren Sie CICS-Ressourcendefinitionen mit dem Befehl kiximptbl.
```
kiximptbl
```
## Schritt 6: Starten und verbinden Sie TPE mit BPE
In diesem Schritt müssen Sie die zuvor erstellte TPE-Region zusammen mit dem BPE-Manager starten und diese verbinden, um die Beispielanwendung ausführen zu können. CardDemo
1. Führen Sie den `kixverify` Befehl für alle VSAM-Dateien aus, um sicherzustellen, dass sie zurückgesetzt und alle zuvor geöffneten Dateien geschlossen wurden.
```
kixverify -r ALL
```
1. Starten Sie die TPE-Region.
```
kixregion start $KIXSYS
```
1. Stellen Sie sicher, dass sowohl BPE als auch TPE angeschlossen sind. Dies ist von entscheidender Bedeutung, da die VSAM-Dateien Eigentum von TPE sind und für jeden Batch-Vorgang, der auf das VSAM zugreift, eine Verbindung zu TPE erforderlich ist.
```
ebmsys -t
```
![\[Zeigt den Namen des Subsystems als sys1 an. TPE ist verbunden und der TPE-Benutzer ist ec2-user.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/unikix-start-1.png)
## Schritt 7: Führen Sie die Anwendung aus CardDemo
In diesem Schritt führen Sie die CardDemo Anwendung im TN3270 Terminalemulator aus.
Das UniKix Runtime-AMI wird mit dem TN3270-Terminalemulator geliefert, den Sie direkt von der UniKix EC2-Instance aus starten können.
**Stellen Sie mithilfe des TN3270 Terminalemulators eine Connect zu TPE her**
+ Starten Sie das TN3270 Terminal mit dem `kixterm` Befehl.
```
kixterm
```
![\[Der Hauptbildschirm der UniKix CardDemo TPE-Beispielanwendung für Mainframe.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/unikix-carddemo-00.png)
(Optional). Wenn Sie Ihren eigenen Terminalemulator verwenden möchten:
1. Rufen Sie die IP-Adresse der UniKix Runtime-Instance von der Amazon EC2 EC2-Konsole ab.
1. Rufen Sie mithilfe des TN3270 Terminalemulators die Portnummer für die Verbindung mit der TPE-Region ab. Sie finden dies in der TNServer ListenPort Datei unikixrc.cfg.
```
cat $KIXSYS/unikixrc.cfg
```
![\[Zeigt die Details der Datei UniKix unikixrc.cfg mit dem Listener-Port 15440 an.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/unikix-carddemo-1.png)
1. Konfigurieren Sie Ihren TN3270 Terminalemulator so, dass er die IP-Adresse der UniKix Laufzeitinstanz und die Portnummer 15440 verwendet.
**Online-Transaktionen**
In diesem Abschnitt wird davon ausgegangen, dass Sie mit dem `kixterm` Befehl eine Verbindung zum TN3270 Terminalemulator hergestellt haben.
1. Nachdem Sie vom TN3270 Terminalemulator aus eine Verbindung hergestellt haben, drücken Sie die Eingabetaste, um den TPE-Bildschirm zu löschen und die erste Transaktion einzugeben.
1. Geben Sie bei der ersten Transaktion CC00 (Anmeldebildschirm) den Benutzernamen und `USER001` `PASSWORD` das Passwort ein.
![\[Hauptbildschirm für CardDemo. Zeigt an, dass es sich um einen CardDemo Kreditantrag für die Mainframe-Modernisierung handelt. Fordert Sie zur Eingabe Ihrer Benutzer-ID und Ihres Kennworts auf.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/unikix-carddemo-2.png)
1. Wählen Sie im **Hauptmenü** die Option „01“, um Konten anzuzeigen.
![\[CardDemo Das Hauptmenü der Anwendung im Emulator mit der ausgewählten Option 1.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/unikix-carddemo-3.png)
1. Geben Sie im Bildschirm „**Konto anzeigen**“ eine Kontonummer ein (z. B. 00000000010). Sie sollten die Kontoinformationen sehen, die aus den migrierten Daten stammen.
![\[Einzelheiten des CardDemo Antrags mit der eingegebenen Kontonummer 00000000010.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/unikix-carddemo-4.png)
1. Drücken Sie zweimal die Taste „PF03“, um zum Anmeldebildschirm zurückzukehren, und verlassen Sie das TN3270 Terminal, indem Sie „Strg\$1C“ (Windows) oder „Cmd\$1C“ (Macbook) drücken.
**Batch-Jobs**
1. Navigieren Sie zum JCL-Verzeichnis.
```
cd $MBMSUB
```
1. Senden Sie den Job ab `MFCATGL1` und beobachten Sie die Ausgabe des Jobprotokolls.
```
BPESUB READCARD
```
1. Optional können Sie die Jobprotokolle aus dem `$SUBSYS_OUTDIR` Verzeichnis anzeigen.
```
ls -lrt $SUBSYS_OUTDIR/*
```
Sie haben die CardDemo Anwendung nun erfolgreich auf der NTT UniKix DATA-Laufzeit bereitgestellt und die laufende Anwendung verifiziert, indem Sie durch einige CICS-Online-Bildschirme und Batch-Jobs navigiert haben.
## Fehlerbehebung
Im Folgenden finden Sie einige häufig auftretende Fehler, die bei der Einrichtung der Anwendung auftreten können. CardDemo
### Fehler: Lizenzierungsfehler
Wenn Sie während der Durchführung dieses Tutorials einen Lizenzfehler erhalten, kann es sein, dass der in Ihrem EC2 aktiviert **IMDSv2**ist. Sie können dieses Problem lösen, indem Sie die Option für Instance-Metadaten **IMDSv2**auf **Optional** ändern, wie unter [Restore the use of IMDSv1](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-IMDS-existing-instances.html) im *Amazon EC2 EC2-Benutzerhandbuch* beschrieben.
### Fehler: TPE ist nicht mit BPE verbunden
Wenn das TPE nicht mit BPE verbunden ist, stellen Sie sicher, dass die **VSAM-Konfigurationstabelle korrekt mit dem BPE-Knotenverzeichnis** konfiguriert ist. Um auf die VSAM-Konfigurationstabelle zuzugreifen, starten Sie den TN3270 Terminalemulator mit dem folgenden Befehl:
```
kixterm
```
1. Geben Sie den Transaktionsnamen als ein. `CTBL`
1. Wählen Sie im Menü **Table Manager** die Option **Standardtabellen**.
1. Wählen Sie auf dem Bildschirm Standardtabellen die Option **VSAM-Konfigurationstabelle**.
1. Prüfen Sie, ob **Connect zum Batch-Knoten herstellen?** ist auf "**Y**“ gesetzt und das Knotenverzeichnis ist korrekt.
![\[VSAM-Konfigurationstabelle im TN3270 Terminalemulator. Anzeige von Werten für jedes der Felder in der Tabelle.\]](http://docs.aws.amazon.com/de_de/m2/latest/userguide/images/unikix-troubleshoot.png)