Démarrage rapide avec SuperBOL Studio

Ce guide prend environ 15 minutes. Vous allez installer les outils, créer un petit projet, compiler et exécuter un programme, configurer un projet existant et lancer une session de débogage.

Les raccourcis clavier sont donnés pour Windows et Linux ; sous macOS, utilisez Cmd à la place de Ctrl.

Prérequis

• VS Code, ou VSCodium ou un autre éditeur utilisant Open VSX.
• GnuCOBOL, pour compiler, exécuter et déboguer vos programmes.
• GDB, uniquement pour le débogage.

sudo snap install code --classic

# Debian, Ubuntu
sudo apt install gnucobol gdb
# Fedora
sudo dnf install gnucobol gdb
# Arch Linux (GnuCOBOL depuis l'AUR, par ex. avec yay)
yay -S gnucobol
sudo pacman -S gdb
# NixOS (shell temporaire)
nix-shell -p gnucobol gdb

winget install Microsoft.VisualStudioCode

brew install --cask visual-studio-code

brew install gnucobol

Vérifiez ensuite dans un terminal que tout est installé :

cobc --version
gdb --version

Installer l’extension

En ligne

Si votre poste a accès à Internet, au choix :

• Dans VS Code : ouvrez la vue Extensions (Ctrl+Shift+X), cherchez SuperBOL et cliquez sur Install.
• Depuis le web : page de l’extension sur le Visual Studio Marketplace ou sur Open VSX.
• En ligne de commande, ce qui installe toujours la dernière version :

  code --install-extension OCamlPro.SuperBOL
  

Hors ligne, avec un fichier VSIX

Si vous disposez du fichier .vsix de l’extension, au choix :

• Dans VS Code : ouvrez la vue Extensions (Ctrl+Shift+X), cliquez sur le menu ... en haut de la vue, puis sur Install from VSIX… et choisissez le fichier.
• En ligne de commande :

  code --install-extension superbol-<version>.vsix
  

Vérifier l’installation

Dans la vue Extensions (Ctrl+Shift+X), vérifiez que SuperBOL Studio est installé et activé.

Créer un premier projet

1. Créez un dossier vide sur votre ordinateur et ouvrez-le dans VS Code avec File > Open Folder....
2. Créez un fichier hello.cob.
3. Vérifiez dans la barre d’état, en bas à droite, que le langage du fichier est COBOL.

Tapez le programme suivant. Il est écrit en format fixe, le format historique : les noms de division commencent en colonne 8 et les instructions en colonne 12.

       IDENTIFICATION DIVISION.
       PROGRAM-ID. HELLO.
       PROCEDURE DIVISION.
           DISPLAY "Bonjour"
           STOP RUN.

Pendant la saisie, SuperBOL Studio complète les mots-clés et les noms. Survolez un nom pour voir sa définition, ou faites Ctrl+clic dessus pour y aller.

Compiler et exécuter

1. Appuyez sur Ctrl+Shift+B et choisissez SuperBOL: build module. Un module hello.so (hello.dll sous Windows) apparaît à la racine du projet.
2. Appuyez sur Ctrl+F5 (Run > Run Without Debugging) pour exécuter le programme. Il affiche Bonjour.

Vous pouvez aussi compiler et exécuter depuis le terminal intégré (Ctrl+Shift+M, puis l’onglet Terminal) :

cobc -x hello.cob    # produit un exécutable
./hello              # hello sous Windows

Les erreurs de compilation sont listées dans le panneau Problems (Ctrl+Shift+M) : cliquez sur une erreur pour aller à la ligne fautive.

Configurer le projet

Pour un projet existant, SuperBOL Studio doit savoir comment le code est écrit : où sont les copybooks, quel format de source et quel dialecte COBOL sont utilisés.

Ouvrez les paramètres de l’extension : vue Extensions, roue dentée de SuperBOL Studio, puis Settings. Choisissez l’onglet Workspace pour que les réglages ne s’appliquent qu’au projet courant. Ils sont enregistrés dans .vscode/settings.json, par exemple :

{
    "superbol.cobol.dialect": "mf",
    "superbol.cobol.sourceFormat": "fixed",
    "superbol.cobol.copybooks": [
        { "dir": "cpy" }
    ],
    "superbol.forceSyntaxDiagnostics": true
}

Par défaut, les erreurs de syntaxe ne sont signalées que pour le dialecte COBOL 85. Activez superbol.forceSyntaxDiagnostics (Force Syntax Diagnostics) pour les voir avec les autres dialectes.

Déboguer

Le débogage nécessite GDB (vérifiez avec gdb --version) et un programme compilé en mode débogage, avec la tâche SuperBOL: build module (debug) (Ctrl+Shift+B).

1. Posez un point d’arrêt : cliquez dans la marge, à gauche d’un numéro de ligne, ou appuyez sur F9 sur la ligne courante.
2. Appuyez sur F5. Le programme s’arrête sur le point d’arrêt.

La vue Variables montre les données du programme ; survoler une variable dans le source affiche aussi sa valeur.

Dépannage

Si votre problème n’est pas listé, cobc --info affiche la configuration de GnuCOBOL (compilateur C, chemins de recherche, bibliothèques) : joignez-la à votre demande d’aide.

Aller plus loin

Le manuel utilisateur décrit toutes les fonctionnalités et tous les réglages de SuperBOL Studio. Pour signaler un bug ou proposer une amélioration, ouvrez une issue sur GitHub.

Manuel utilisateur Voir le projet sur Github