Seminar superbol.toml in der Praxis: Dialekte, Source-Formate, Copybooks

Inhaltsverzeichnis

• Abstract
• Zielgruppe und Voraussetzungen
• Lernziele
• Inhalte und Agenda
• Projektlayout und Konfiguration
• Ergebnisse und Transfer

Abstract

Dieses Seminar macht superbol.toml zum kontrollierten Hebel für COBOL-Projekte. Im Mittelpunkt stehen: Projektroot-Erkennung, Dialektwahl (inkl. „-strict“-Varianten), Source-Formate (Auto/Free/Fixed u. a.) und Copybook-Strategien mit globalen und dateirelativen Verzeichnissen. Ergänzt wird dies durch praxisnahe Diagnostik: Warum wird ein Copybook nicht gefunden, warum unterscheiden sich reserved words je Dialekt, wie wirkt sich Formatwahl auf Formatierung und Parser-Fehlermeldungen aus. Ergebnis ist eine belastbare Standardkonfiguration pro Team oder Anwendung.

Zielgruppe und Voraussetzungen

• Zielgruppe: COBOL-Entwicklung, Tooling-Verantwortliche, Architekturen für Legacy-Codebasen
• Voraussetzungen: SuperBOL Studio OSS installieren und betreiben (VS Code) oder funktionsfähiges SuperBOL Studio Setup, grundlegendes Verständnis von Copybooks und Dialekten

Lernziele

• Projektroot-Regel sicher anwenden (Konfigurationsdatei im Root)
• Dialekt korrekt wählen und „strict“-Konfigurationen nutzen, wenn nötig
• Source-Format sauber definieren (Auto/Free/Fixed/Variable/XOpen/…)
• Copybook-Auflösung standardisieren: global, lokal, file-relative

Inhalte und Agenda

• Projektbegriff: Root-Verzeichnis, superbol.toml, parallele Projekte
• [cobol]-Konfiguration:
  • dialect (z. B. default, gnucobol, cobol85, cobol2002, cobol2014, ibm, microfocus/mf, mvs, gcos, …)
  • source-format (Auto, Free, Fixed, Variable, XOpen, …)
  • copybook-Liste mit dir und optional file-relative
• „strict“-Dialekte: reserved words begrenzen, Extensions deaktivieren
• Praktische Patterns: Monorepo, Multi-Application, shared COPY-Verzeichnisse
• Erzeugung/Bootstrap: Projektinitialisierung per CLI (sofern im Setup verfügbar)

Projektlayout und Konfiguration

• Zielprojektlayout festlegen: src/ und COPY/ (oder vorhandene Strukturen abbilden)
• superbol.toml im Projektroot erstellen
• Dialekt festlegen: Start mit „default“, danach Zielcompiler-Dialekt setzen
• Source-Format festlegen: Auto nur dort, wo gemischte Formate real vorkommen
• Copybook-Verzeichnisse definieren:
  • global: gemeinsame COPYs
  • lokal: pro Programm/Gruppe
  • file-relative setzen, wenn lokale COPY-Verzeichnisse programmspezifisch sind
• Verifikation:
  • Hover/Peek auf COPY
  • Go-to-Definition über Copybook-Symbole
  • Diagnosen prüfen und Konfiguration iterativ nachziehen

Ergebnisse und Transfer

• Standard-superbol.toml pro Projekttyp
• Copybook-Strategie und Dialekt-Entscheidung dokumentiert