View a markdown version of this page

Tutorial: Anwendung auf NTT DATA bereitstellen CardDemo - AWS Mainframe-Modernisierung

AWS Die selbstverwaltete Mainframe-Modernisierung steht Neukunden nicht mehr zur Verfügung. Informationen zu Funktionen, die denen der selbstverwalteten AWS Mainframe-Modernisierung ähneln, finden Sie unter Funktionen, die direkt vom Anbieter angeboten werden, und von. AWS Transform Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter Änderung der Verfügbarkeit von Mainframe Modernization AWS .

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 Der Mainframe Modernization Service (Erfahrung mit Managed Runtime Environment) steht Neukunden nicht mehr zur Verfügung. Funktionen, die dem AWS Mainframe Modernization Service (Erfahrung mit Managed Runtime Environment) ähneln, finden Sie unter AWS Mainframe Modernization Service (Self-ManagedExperience). Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter Änderung der Verfügbarkeit von AWS Mainframe Modernization.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Tutorial: Anwendung auf NTT DATA bereitstellen CardDemo

Diese Seite führt Sie Schritt für Schritt durch den 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 Mainframe-Migration und AWS -Modernisierung zu testen und zu präsentieren.

Weitere Informationen zu dieser Anwendung finden Sie unter, GitHub Repository für CardDemo.

Ablaufdiagramm für die Bereitstellung

Das folgende Diagramm zeigt jeden Schritt im Workflow für die Bereitstellung einer Anwendung auf der NTT DATA Unikix-Runtime.

Der gesamte Arbeitsablauf der Bereitstellung der Anwendung auf der NTT DATA Unikix-Runtime.

Voraussetzungen

  • Folgen Sie den Anweisungen AWS Mainframe-Modernisierung und Neuplattformierung mit NTT DATA unter Verwenden des NTT DATA Marketplace AMI. UniKix

  • Ändern Sie die Instance-Metadatenoption IMDSv2 in Optional, wie unter Restore the use of IMDSv1 im Amazon EC2-Benutzerhandbuch beschrieben.

  • Laden Sie die CardDemo Laufzeitkomponenten für NTT DATA von der herunter UniKix

    GitHub Repositorium.

  • Melden Sie sich bei der UniKix Runtime-EC2-Instance als ec2-user an.

  • Extrahieren Sie die heruntergeladenen CardDemo Runtime-Komponenten über diesen Link: UniKix _ CardDemo _runtime_v1.zip.

    • Das entpackte Verzeichnis sollte migrated_app Verzeichnisse bin und enthalten.

    • Verschieben Sie beide bin migrated_app Verzeichnisse unter 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 innerhalb des HOME/bin $-Verzeichnisses mit dem folgenden Befehl:

      • chmod +x $HOME/bin/*

Schritt 1: Bereite 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 Runtime-EC2-Instance als ec2-user an.

  2. Beachten Sie die Liste der UniKix Software, die im AMI vorverpackt ist, wie TPE, BPE und COBOL, zusammen mit anderen aus dem NTT UniKix DATA-Produktverzeichnis, indem Sie den folgenden Befehl in Ihrer EC2-Instance verwenden:

    ls -l /opt/software/
  3. Untersuchen Sie die migrierte Anwendung. CardDemo Sie werden den gesamten Quellcode sehen, einschließlich BMS-Maps, COBOL-Programmen, COBOL-Copybooks und JCLs. Gehen Sie wie folgt vor, um BPE- und TPE-Kataloge, CICS-Ressourcendefinitionen und migrierte Daten wie sequentielle Dateien und VSAM-Dateien zu exportieren:

    ls $HOME/migrated_app/*/*
  4. Erstellen Sie eine Ordnerstruktur, indem Sie das Skript mit dem folgenden Befehl ausführen: create_project

    sh $HOME/bin/create_project
  5. 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
  2. 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
  3. 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
  4. Aktivieren Sie die TPE-Region, indem Sie die Benutzerumgebungsdatei () $KIXSYS/bin/userenv angeben.

    source $KIXSYS/bin/userenv
  5. 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-Node und das 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
  2. Erstellen Sie mit dem INSTEBM Befehl einen BPE-Knoten. Das BPE-Knotenverzeichnis wird als Eingabeparameter bereitgestellt.

    $INSTEBM $EBMHOME
  3. Aktivieren Sie die Batch-Umgebung, indem Sie die batchenv Datei vom neu erstellten BPE-Knoten beziehen.

    source $EBMHOME/batchenv
  4. Erstellen Sie das BPE-Subsystem innerhalb dieses Knotens mithilfe des 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 im Batch Administrator Manager Option 2 „Systemumgebungen“.
    2. Wählen Sie Option 2, Batch Node starten/ (Stop), um den BPE-Knoten zu starten.

      Wählen Sie unter Systemumgebungen die Option 2 Start/Stop Batch Node aus.
    3. Drücken Sie nach dem Start zweimal die Eingabetaste, um zum BAM-Hauptmenü zurückzukehren.

      Bildschirm „Batch Node Startup abgeschlossen“.
    4. Um das BPE-Subsystem zu erstellen, wählen Sie Option 3, Anwendungen und Subsysteme.

      Option 3 Anwendungen und Subsysteme, die auf der Batch Administrator Manager-Seite ausgewählt wurden.
    5. Wählen Sie dann Option 3, Ein Subsystem erstellen.

      Option 3 Ein Subsystem erstellen, das auf dem Bildschirm „Anwendungen und Subsysteme“ ausgewählt wurde.
    6. Geben Sie den Namen des Subsystems als ein. sys1

      Auf dem Bildschirm „Erstellen“ wurde sys1 eingegeben.
    7. Wählen Sie Option 3, Datenmanagement.

      Wählen Sie auf dem Bildschirm Erstellen in Anwendungen und Subsystem die Option 3 Datenmanagement aus.
    8. Wählen Sie Option 5, da die CardDemo Anwendung sowohl sequentielle als auch VSAM-Dateien umfasst.

      Wählen Sie Option 5, um sequentielle Dateien und VSAM-Dateien einzubeziehen.
    9. (Optional). Drücken Sie „R“, um zur Seite „Menü erstellen“ zurückzukehren. Sehen Sie sich die verschiedenen verfügbaren Konfigurationsoptionen an.

    10. 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.
    11. Überprüfen Sie die Einstellungen und geben Sie „C“ ein, um mit den restlichen Umgebungseinstellungen fortzufahren. Diese Umgebungseinstellungen sind bereits ausgefüllt, da die erforderlichen Umgebungsvariablen in der carddemo.env Setup-Datei definiert sind und die empfohlene Ordnerstruktur vorhanden ist.

    12. Geben Sie „y“ ein, um die aktuellen Umgebungseinstellungen zu bestätigen und zu speichern.

      Zeigt an, dass die Umgebungseinstellung des sys1-Subsystems abgeschlossen ist. Geben Sie auch „y“ ein, um die aktuellen Einstellungen zu speichern.
    13. Geben Sie „y“ ein, um das Protokoll beim Erstellen des Subsystems anzuzeigen.

      Zeigt das NTT DATA COBOL-Laufzeitsystem von Building sys1 auf dem Bildschirm an.
    14. Drücken Sie die Eingabetaste, bis Sie zum Hauptmenü zurückkehren, und verlassen Sie die BAM-Oberfläche, indem Sie die Option Beenden auswählen.

      Zeigt das erstellte COBOL-Laufzeitsystem an. Fordert außerdem auf, die Eingabetaste zu drücken, um fortzufahren.
      Kehrt zum Menü Erstellen zurück und zeigt an, dass das Subsystem sys1 erstellt wurde. Und die Konfiguration wird aktualisiert. Fordert auf, die Eingabetaste zu drücken, um fortzufahren.
      Hauptmenü für Batch Administrator. Fordert auf, Q einzugeben, um dieses Menü zu verlassen.
  5. Aktivieren Sie das BPE-Subsystem, indem Sie das batchenv mit dem Subsystemnamen angeben. 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 carddemo.env Setup-Datei beziehen.

    source $HOME/bin/carddemo.env
  2. Navigieren Sie zum COBOL-Quellverzeichnis.

    cd $MIGAPP_DIR/cbl
  3. Kompilieren Sie das Cobol-Programm CBACT01C.cbl mithilfe eines Skriptscompile.

    compile CBACT01C.cbl
  4. Kompilieren Sie alle Cobol-Programme mithilfe eines Skriptscompile.all.

    compile.all
  5. Navigieren Sie zum Quellverzeichnis von BMS-Maps.

    cd $MIGAPP_DIR/bms
  6. Kompilieren Sie die BMS-Karte COACTUP.bms mithilfe eines Skriptscompbms.

    compbms COACTUP.bms
  7. Kompilieren Sie alle BMS-Karten mithilfe eines Skriptscompbms.all.

    compbms.all
  8. Überprüfen Sie die kompilierten Binärdateien für COBOL- und BMS-Karten.

    ls $PROJECT_ROOT/loadlib ls $PROJECT_ROOT/maps
  9. Stellen Sie mithilfe des Skripts andere Anwendungsartefakte wie JCL, Prozeduren, Datendateien und CICS-Ressourcendefinitionen bereit. deploy_app

    deploy_app
  10. Navigieren Sie zum JCL-Verzeichnis des Projekts.

    cd $PROJECT_ROOT/jcl
  11. Übersetzen Sie JCL ACCTFILE in BPE JCL Macro. Verwenden Sie den mvstrans Befehl und verwenden Sie die Option „-v“ für die JCL-Überprüfung und die Option „-f“, um das Makro zu erstellen.

    mvstrans ACCTFILE -v mvstrans ACCTFILE -f
  12. Übersetzen Sie die JCL-Prozedur REPROC in das BPE-JCL-Prozedurmakro. Verwenden Sie den mvstrans Befehl mit der Option „-p“ zusammen mit der Option „-v“ zur Überprüfung und die Option „-f“, um das Makro zu erstellen.

    mvstrans REPROC -v -p mvstrans REPROC -f -p
  13. Übersetzen 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 des Befehls. loadcat

    loadcat $MIGAPP_DIR/catlg/bpe/BPECAT*
  2. Navigieren Sie zum Verzeichnis $KIXSYS.

    cd $KIXSYS
  3. Importieren Sie den TPE-Katalog mit dem Befehl. kiximpcat

    kiximpcat -c CATALOG -l CATALOG.lst
  4. Importieren Sie CICS-Ressourcendefinitionen mit dem Befehl kiximptbl.

    kiximptbl

Schritt 6: TPE starten und mit BPE verbinden

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 werden und alle zuvor geöffneten Dateien geschlossen werden.

    kixverify -r ALL
  2. Starten Sie die TPE-Region.

    kixregion start $KIXSYS
  3. Stellen Sie sicher, dass sowohl BPE als auch TPE verbunden 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.

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 EC2-Instance aus starten können. UniKix

Stellen Sie mithilfe des TN3270-Terminalemulators eine Verbindung zu TPE her
  • Starten Sie das TN3270-Terminal mit dem Befehl. kixterm

    kixterm
    Der Hauptbildschirm der UniKix CardDemo TPE-Beispielanwendung für Mainframe.

(Optional). Wenn Sie Ihren eigenen Terminalemulator verwenden möchten:

  1. Rufen Sie die IP-Adresse der UniKix Runtime-Instance von der Amazon EC2-Konsole ab.

  2. Rufen Sie die Portnummer für die Verbindung mit der TPE-Region mithilfe des TN3270-Terminalemulators ab. Sie finden dies bei ListenPort TNServer in der Datei unikixrc.cfg.

    cat $KIXSYS/unikixrc.cfg
    Zeigt die Details der Datei UniKix unikixrc.cfg mit dem Listener-Port als 15440 an.
  3. 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 Befehl eine Verbindung zum TN3270-Terminalemulator hergestellt haben. kixterm

  1. Drücken Sie nach dem Herstellen einer Verbindung über den TN3270-Terminalemulator die Eingabetaste, um den TPE-Bildschirm zu löschen und die erste Transaktion einzugeben.

  2. Geben Sie bei der ersten Transaktion CC00 (Anmeldebildschirm) den Benutzernamen und das Passwort einUSER001. PASSWORD

    Hauptbildschirm für. CardDemo Zeigt an, dass es sich um einen CardDemo Kreditantrag für die Mainframe-Modernisierung handelt. Fordert Sie auf, Ihre Benutzer-ID und Ihr Passwort einzugeben.
  3. Wählen Sie im Hauptmenü die Option „01“, um Konten anzuzeigen.

    CardDemo Hauptmenü der Anwendung im Emulator mit der ausgewählten Option 1.
  4. Geben Sie im Bildschirm „Konto anzeigen“ eine Kontonummer ein (z. B. 00000000010). Sie sollten sehen, dass die Kontoinformationen aus den migrierten Daten übernommen wurden.

    Einzelheiten des CardDemo Antrags mit der eingegebenen Kontonummer 00000000010.
  5. Drücken Sie zweimal die Taste „PF03“, um zum Anmeldebildschirm zurückzukehren, und verlassen Sie das TN3270-Terminal, indem Sie „Strg+C“ (Windows) oder „Cmd+C“ (Macbook) drücken.

Batch-Jobs

  1. Navigieren Sie zum JCL-Verzeichnis.

    cd $MBMSUB
  2. Senden Sie den Job ab MFCATGL1 und beobachten Sie die Ausgabe des Jobprotokolls.

    BPESUB READCARD
  3. Optional können Sie die Auftragsprotokolle aus dem $SUBSYS_OUTDIR Verzeichnis einsehen.

    ls -lrt $SUBSYS_OUTDIR/*

Sie haben die CardDemo Anwendung jetzt erfolgreich auf der NTT UniKix DATA-Laufzeitumgebung 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 beim Einrichten der Anwendung auftreten können. CardDemo

Fehler: Lizenzierungsfehler

Wenn Sie beim Folgen dieses Tutorials einen Lizenzfehler erhalten, ist IMDSv2 möglicherweise in Ihrem EC2 aktiviert. Sie können dieses Problem lösen, indem Sie die Instance-Metadatenoption IMDSv2 auf Optional ändern, wie unter Restore the use of IMDSv1 im Amazon 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-Node-Verzeichnis konfiguriert ist. Um auf die VSAM-Konfigurationstabelle zuzugreifen, starten Sie den TN3270-Terminalemulator mit dem folgenden Befehl:

kixterm
  1. Geben Sie den Transaktionsnamen ein als. CTBL

  2. Wählen Sie im Menü des Tabellenmanagers die Option Standardtabellen.

  3. Wählen Sie auf dem Bildschirm „Standardtabellen“ die Option VSAM-Konfigurationstabelle.

  4. Prüfen Sie, ob Verbindung zum Batch-Knoten hergestellt werden soll? ist auf „Y“ gesetzt und das Node Directory ist korrekt.

VSAM-Konfigurationstabelle im TN3270-Terminalemulator. Anzeige von Werten für jedes Feld in der Tabelle.