Seminar SuperBOL Studio OSS installieren und betreiben (VS Code)

Inhaltsverzeichnis

• Abstract
• Zielgruppe und Voraussetzungen
• Lernziele
• Inhalte und Agenda
• Step-by-step Installation und Verifikation
• Ergebnisse und Transfer

Abstract

Dieses Modul liefert ein reproduzierbares Setup für SuperBOL Studio OSS in VS Code: Installation über Marketplace oder VSIX, Setzen des Pfads zur SuperBOL-Executable, Validierung der LSP-Funktionalität und saubere Workspace-Standards. Zusätzlich werden Basisregeln für Team-Rollout, Versionierung der Editor-Konfiguration und ein Troubleshooting-Playbook aufgebaut. Ziel ist ein „grüner“ Startzustand, der als Grundlage für superbol.toml-Konfiguration, Build-Tasks, Debugging und CI/CD dient.

Zielgruppe und Voraussetzungen

• Zielgruppe: COBOL-Entwicklung, Tooling-Admins, DevEx/Plattform, Teamleads
• Voraussetzungen: Lokale Adminrechte oder definierter Installationsprozess, vorhandene Compiler-Installation oder festgelegte Build-Umgebung

Lernziele

• SuperBOL Studio OSS sauber installieren (Marketplace oder VSIX)
• Editor und LSP so konfigurieren, dass Team-Setups reproduzierbar sind
• Funktionalität prüfen: LSP-Start, Diagnosen, Navigation, Formatierung
• Typische Fehlerbilder systematisch beheben (Pfad, Workspace, Konfiguration)

Inhalte und Agenda

• Installationswege: Marketplace vs. VSIX
• Pfad-/Binary-Konzept: „superbol“-Executable bzw. OSS-Executable im Systempfad
• Workspace-Standards: Projekt-Root, Konfigurationsdatei, Copybook-Verzeichnisse
• Minimales Funktionsset verifizieren: Go-to-Definition, Referenzen, Formatierung, Hover/Peek
• Rollout-Patterns: Team-Settings, Standard-Extensions, kompatible VS Code-Versionen

Step-by-step Installation und Verifikation

• VS Code Basis bereitstellen: Version prüfen, Policies und Extensions erlauben
• SuperBOL Studio OSS Extension installieren:
  • Variante A: Installation über Extensions-Ansicht (Marketplace-Suche nach „SuperBOL“)
  • Variante B: Installation aus VSIX (Extensions-Menü, „Install from VSIX…“)
• Extension-Setting „Path“ setzen: Pfad zur SuperBOL-Executable (Teamstandard definieren)
• Workspace öffnen: COBOL-Datei anlegen oder importieren
• LSP-Verifikation:
  • Syntaxdiagnosen erscheinen
  • Go-to-Definition/Referenzen funktionieren
  • Formatierung/Indentation ausführbar
• Team-Template erzeugen: .vscode/settings.json und Minimal-README für Setup
• Troubleshooting-Check: PATH, Rechte, Workspace-Root, Konfigurationsdatei-Erkennung

Ergebnisse und Transfer

• Abgenommenes Setup (Definition of Done) inkl. Team-Template
• Troubleshooting-Playbook (Pfad/Workspace/LSP)