Lernprogramm für die COBOL-Bearbeitung

Für das Lernprogramm übernehmen Sie die Rolle des COBOL-Entwicklers, der Anforderungen zur Erweiterung des Berichts 'Daily Customer File Update' der SAM-Anwendung, die sich unter https://github.com/IBM/zopeneditor-sample befindet, empfangen hat.

1. Installieren Sie IBM Z® Open Editor und die zugehörigen Voraussetzungen, wie z. B. Java™, wie in Erste Schritte beschrieben.

1. Um den Bericht zu erweitern, müssen Sie zuerst den Quellcode der Beispielanwendung importieren.

   • Klicken Sie in VS Code auf Terminal > Neues Terminal, um ein Terminal zu öffnen.

   • Navigieren Sie im Terminalfenster zum gewünschten Verzeichnis für den Quellcode, indem Sie zum Beispiel Folgendes eingeben:

     cd /c/Users/Public

   • Um den Quellcode aus dem Git-Repository zu klonen, geben Sie das Git-Repository der bereitgestellten Beispieldateien ein:

     git clone https://github.com/IBM/zopeneditor-sample.git

   • Nachdem der Klon abgeschlossen ist, klicken Sie auf Datei > Ordner öffnen. Wählen Sie anschließend im Fenster "Ordner öffnen" das C: /Users/Public/zopeneditor-sample-Verzeichnis, das Sie geklont haben, und klicken Sie dann auf Ordner auswählen. Der Ordner wird nun in der Exploreransicht auf der linken Seite von VS Code geöffnet.

     Die aktuelle Beispielanwendung besteht aus den folgenden Dateien:

     • COBOL programs: SAM1 und SAM2

     • COPYBOOKS: CUSTCOPY und TRANREC

     • JCL, die die Anwendung konfiguriert und ausführt: ALLOCATE, RUN

     • Datenquellendateien: CUSTFILE und TRANFILE

     Wie auf der Seite Beispieldateien durchsuchen erwähnt, wird ein Programm mit dem Namen SAM1LIB (eine Kopie von SAM1) eingeschlossen, um die Möglichkeit zu demonstrieren, bibliotheksbasierte Copybooks aufzulösen, unabhängig davon, ob sie sich auf einem lokalen Dateisystem oder einem fernen Z-Host befinden. SAM1LIB verwendet die Befehle COPYBOOKS, DATETIME (lokal) und REPTTOTL (MVS™).

     SAM1 liest sowohl in den CUSTFILE- als auch in den TRANFILE-Datendateien und führt dann für die CUSTFILE basierend auf Transaktionen von TRANFILE verschiedene Aktionen aus. Gültige Transaktionen sind ADD, UPDATE und DELETE. Bei der Begegnung mit einer UPDATE-Transaktion ruft SAM1 SAM2 auf, um die angeforderte Aktualisierung auszuführen.

     Wenn Sie SAM2 überprüfen, werden Sie feststellen, dass bereits ein Basiscode für CRUNCH-Transaktionen vorhanden ist, der später in der folgenden Übung funktional erweitert wird. Am Ende der Verarbeitung von TRANFILE generiert SAM1 anschließend einen Bericht über die verarbeiteten Transaktionen und erstellt außerdem eine aktualisierte CUSTFILE.

2. Suchen Sie mit den erweiterten Suchfunktionen, die vom VS Code-Editor sofort einsatzfähig bereitgestellt werden, nach Komponenten, die das "Daily Customer File Update" generieren und referenzieren. Die Ansicht "Suchen" ermöglicht die Suche nach Zeichenfolgen sowie nach regulären Ausdrücken in allen Dateien oder in einer bestimmten Untergruppe von Dateien basierend auf Positions- oder Namensmustern.

   Klicken Sie im Explorer mit der rechten Maustaste auf den Hintergrund von WAZI-SAMPLE. Zeigen Sie keine bestimmte Datei und keinen bestimmten Ordner an, um eine Suche in allen Dateien einzuleiten:

   • In Ordner suchen ... auswählen

   • Geben Sie den Suchbegriff CUSTOMER-FILE ein und starten Sie die Suche mit der Eingabetaste.

   • Überprüfen Sie einige der anderen Suchoptionen wie beispielsweise die Verwendung regulärer Ausdrücke und die Angabe von Mustern für Dateien und Ordner, die ausgeschlossen oder in die Suche einbezogen werden sollen.

   • Um eine Suche mit regulären Ausdrücken auszuführen, wählen Sie das Symbol .\*, ändern Sie den Begriff in CUST.*FILE und prüfen Sie die Ergebnisse.

   • Die Ergebnisse werden in der Suchanzeige angezeigt.

   • Durch Klicken auf das Ergebnis kann der Benutzer zu dieser Standortdatei in der Editoranzeige navigieren.

3. Nachdem Sie nun die Datei bestimmt haben, die geändert werden muss – SAM1.cbl. Wenn Sie das Programm SAM1.cbl im Editor öffnen, sehen Sie eine Syntaxhervorhebung im Programm, die es Ihnen ermöglicht, schnell zwischen COBOL-reservierten Wörtern, Kommentaren, Konstanten und Variablen zu unterscheiden. Ihnen werden auch nicht erkannte Anweisungen und Ausdrücke in Rot angezeigt, wodurch Sie schnelle Korrekturen vornehmen und Kompilierungsfehler reduzieren können. Die Syntaxprüfung funktioniert auch bei falsch geschriebenen reservierten COBOL-Wörtern und unbekannten Variablennamen. Um alle Syntaxfehler in den geöffneten Dateien anzuzeigen, öffnen Sie die Ansicht "Probleme" über das Menü Anzeigen oder klicken Sie auf das Symbol für Fehler und Warnung unten in der Statusleiste. Klicken Sie auf das Listenelement, um direkt zum Problem zu gelangen.

   Wenn Sie den Dateipfad zu den Copybooks in Ihren Einstellungen für die Auflösung der Referenzen angegeben haben, können Sie auch den Inhalt eines Copybooks voranzeigen, indem Sie den Mauszeiger über den Copybooknamen in einer COPY-Anweisung bewegen, z. B. COPY TRANREC, im COBOL-Programm, ohne dass Sie wegnavigieren müssen. Dies gilt auch für Copybooks, die sich in Bibliotheken und Referenz in COBOL-Programmen befinden, wie in SAM1.cbl mit den Anweisungen COPY DATETIME IN MYFILE (für lokal) und COPY REPTTOTL IN MYLIB (für MVS) demonstriert.

4. Um die übergeordnete Funktionsweise des Programms zu verstehen sowie im Code des Programms effizient zu navigieren und den Code zu durchsuchen, verwenden Sie die Gliederungsansicht. Wenn die Gliederungsansicht nicht automatisch erweitert wird, öffnen Sie sie, indem Sie auf Anzeigen > Ansicht öffnen > Gliederung klicken. Sie können diese Ansicht verwenden, um die folgenden Aktionen auszuführen:

   • Ein- und Ausblenden von Abschnitten wie Bereichsüberschriften, Abschnittsüberschriften und den Namen von Variablengruppen in der Gliederungsansicht

   • Erkennen Sie schnell Includes, Verfahren und Schleifen über die Symbole für die verschiedenen Elemente.

   • Wechseln Sie zu einer gewünschten Position im Code, indem Sie in der Ansicht auf diese entsprechende Abschnittsüberschrift klicken.

   • Sortierung nach Position, Name oder Typ

   Hinweis: Die Gliederungsansicht kann nur verwendet werden, nachdem Sie eine Datei oder ein Programm in VS Code geöffnet haben.

5. Nachdem Sie effizient durch das Programm navigiert haben, wissen Sie, dass Sie Code in das Programm SAM1.cbl einfügen müssen, um das Problem zu beheben. Jetzt können Sie das integrierte Git in VS Code verwenden, um eine isolierte Verzweigung mit dem Namen update-report zu erstellen, in der niemand außer Sie selbst auf den Quellcode zugreifen kann, sofern Sie die Änderungen nicht in das Ursprungsrepository übertragen. So erstellen Sie die Verzweigung:

   • Klicken Sie in VS Code in der linken unteren Ecke auf die Masterverzweigung.

   • Klicken Sie anschließend im Dropdown-Menü, das oben in VS Code angezeigt wird, auf Neue Verzweigung erstellen.

   • Geben Sie einen Verzweigungsnamen von update-report an und drücken Sie anschließend die Eingabetaste zur Bestätigung. Der Arbeitsbereich wird jetzt auf die isolierte Verzweigung update-report umgeschaltet.

6. Nun können Sie Code einfügen. Wenn Sie Code eingeben, stellt die Funktion zur Codevervollständigung passende Listen bereit, aus denen Sie Befehle, definierte Variablen- und Absatznamen sowie Code-Snippets auswählen können. Setzen Sie beispielsweise den Cursor an das Ende von Zeile 216 und drücken Sie die Eingabetaste, um eine neue Zeile in Zeile 217 zu starten. Versuchen Sie den Befehl ACCEPT CURRENT-TIME FROM TIME einzugeben. Beachten Sie, dass Sie aus den eingeblendeten Listen mit Codevervollständigungsvorschlägen eine Option auswählen können, während Sie den Befehl eingeben.

   Sie können auch die Code-Snippets verwenden, die im Lieferumfang von IBM Z Open Editor enthalten sind. Navigieren Sie zur Verwendung zum Abschnitt Dateisteuerung des Programms SAM1.cbl, drücken Sie die Taste F1, wählen Sie Snippet einfügen, und geben Sie dann VSAM in die Suchleiste ein. Ihnen wird eine Liste der VSAM-Snippets angezeigt. Blättern Sie zum Beispiel zum Snippet VSAM: KSDS Select/Assign Clause und drücken Sie die Eingabetaste. Es wird eine vorformatierte SELECT/ASSIGN-Klausel eingefügt.

7. Nachdem Sie nun Codeänderungen und Optimierungen durchgeführt haben, können Sie Ihre Änderungen in Ihrer update-report-Verzweigung festschreiben, um sie beizubehalten. Um Ihre Änderungen festzuschreiben, klicken Sie auf das Symbol "Quellcodeverwaltung" links von VS Code. In der Anzeige "Quellcodeverwaltung", die geöffnet wird, wird das geänderte Programm im Abschnitt CHANGES aufgelistet. Bewegen Sie im Abschnitt CHANGES den Mauszeiger über den Programmnamen 'SAM1.cbl' und klicken Sie auf das Symbol Änderungen bereitstellen (+), um Ihre Änderungen in den Bereitstellungsbereich zu verschieben. Geben Sie in das Textfeld Nachricht einen Kommentar zu den Änderungen ein, zum Beispiel Implementierter Aktualisierungsbericht, und klicken Sie dann auf das Symbol Festschreiben, um Ihre Änderungen zu festzuschreiben.

Herzlichen Glückwunsch, Sie haben das Lernprogramm abgeschlossen! Eine umfassendere Liste der verfügbaren Features für die Codebearbeitung finden Sie unter Codeänderungen vornehmen.