Seminar SuperBOL CLI & Toolchain: Check, Preprocessing, EBCDIC, Switches

Inhaltsverzeichnis

• Abstract
• Zielgruppe und Voraussetzungen
• Lernziele
• Inhalte und Agenda
• Praxis (CLI)
• Ergebnisse und Transfer

Abstract

Dieses Seminar erschließt die SuperBOL-CLI als Automatisierungs- und Diagnosewerkzeug. Schwerpunkte sind Syntaxprüfung, Preprocessing (inkl. Erzeugung preprocessierter Dateien), Indentation/Formatting auf CLI-Ebene, EBCDIC-Übersetzung sowie das Management mehrerer GnuCOBOL-Installationen über „Switches“ (Import, Build, Set, Env). Zusätzlich werden LSP-Startoptionen (Caching, Storage-Directory) und Projekt-Init/Config-Funktionen genutzt, um reproduzierbare Builds zu ermöglichen. Ergebnis ist eine Toolchain, die lokal, im Build-Server und in Container-Umgebungen gleich funktioniert.

Zielgruppe und Voraussetzungen

• Zielgruppe: DevOps/Build-Engineering, Tooling-Teams, Senior-Entwicklung, Release-Management
• Voraussetzungen: Grundlegende Shell-/CLI-Erfahrung, SuperBOL-Executable verfügbar, GnuCOBOL-Umgebung vorhanden oder geplant

Lernziele

• CLI-Subcommands sicher in lokalen und CI-Kontexten einsetzen
• Preprocessing- und Formatierungsstufen als Pipeline-Bausteine definieren
• EBCDIC-Übersetzungsfälle korrekt behandeln
• Mehrere Compiler-Installationen stabil verwalten (Switch-Konzept)

Inhalte und Agenda

• Gemeinsame CLI-Parameter: Quiet/Verbose-Levels
• Syntaxprüfung: Parameter wie Dialekt, Source-Format, Include-Pfade, Extensions
• Preprocessing: Erzeugung preprocessierter Dateien, Optionen für Parse/Check
• Indentation: Inplace, Lines-Range, Gen-Config
• LSP-Startoptionen (CLI): Caching, Storage-Directory
• EBCDIC Translate: to/from ASCII, Collating-Sequenzen
• SQL-Preprocessing (wo relevant): Vorverarbeitung von SQL EXEC-Blöcken
• Switch-Management für GnuCOBOL:
  • Switch import/add/build/list/set
  • Env-Skripterzeugung und globale Umschaltstrategie

Praxis (CLI)

• CLI-Baseline: Version prüfen, Verbosity steuern, Pfade klären
• Syntax-Check:
  • Dialekt übergeben
  • Include-Verzeichnisse und Copybook-Extensions setzen
  • Fehlermeldungen kategorisieren
• Preprocessing:
  • Preprocessed Output erzeugen
  • Optional parse/check anwenden
• Indentation:
  • Bereichsformatierung vs. Whole-File
  • Inplace vs. Output-Datei
• EBCDIC:
  • Eingangsdaten identifizieren
  • Übersetzung hin/zurück
• Switch:
  • vorhandene Installationen importieren
  • Switch auswählen (set)
  • Env-Kommandos generieren und in Shell/CI verwenden
• Caching (LSP/CLI):
  • Storage-Directory setzen
  • Auswirkungen auf Repo-Layouts dokumentieren

Ergebnisse und Transfer

• CLI-Rezeptbuch (Befehle als wiederverwendbare Patterns)
• Standard für Switch-Management und Reproduzierbarkeit
• Vorschlag für Pipeline-Stages (Input, Check, Build, Test, Coverage)