Références SuperBOL Studio

Configuration de SuperBOL Studio

Plusieurs fichiers de configuration sont utilisés par VSCode :

  • Par défaut, les options sont prises dans la configuration de l’utilisateur dans $HOME/.config/Code/User/settings.json (sous Linux)

  • Dans un espace de travail, les options proviennent de la configuration de l’espace de travail dans .vscode/settings.json

  • De plus, le serveur LSP de SuperBOL Studio utilisera également les options de superbol.toml à la racine de l’espace de travail, de préférence aux options des fichiers settings.json. Ce fichier est également utilisé par d’autres outils de SuperBOL qui ne sont pas liés à VSCode.

La commande SuperBOL : Write Project Configuration peut être utilisée pour exporter la configuration du fichier settings.json vers le fichier superbol.toml.

Les options SuperBOL dans settings.json

  • superbol.cobol.dialect (chaine de caractères, défaut : default) : Dialecte COBOL par défaut pour tous les fichiers

    Les dialectes disponibles sont:

    • default et gnucobol : un dialecte global incluant tous les autres dialectes

    • cobol85 : seulement les mots-clés de ANSI COBOL 85

    • cobol2002 : seulement les mots-clés de COBOL ISO 2002

    • cobol2014 : uniquement les mots-clés de COBOL ISO 2014

    • acu et acu-strict : le dialecte ACUCOBOL-GT

    • bs2000 et bs2000-strict : dialecte pour le compilateur COBOL2000 V1.5 de Fujitsu

    • gcos et gcos-strict : dialecte pour COBOL sur les mainframes BULL GCOS

    • ibm et ibm-strict : dialecte pour COBOL sur les mainframes IBM z/OS

    • mf et mf-strict : dialecte pour Visual COBOL de MicroFocus (RocketSoftware maintenant)

    • mvs et mvs-strict : dialecte pour IBM COBOL pour MVS & VM

    • realia et realia-strict : dialecte pour CA Realia II

    • rm et rm-strict : dialecte pour RM-COBOL

    • xopen : dialecte pour X/Open COBOL

    La version -strict d’un dialecte permet d’utiliser des mots réservés de tous les autres dialectes comme des mots COBOL personnalisés, car la version non stricte réserve également ces mots.

    Vous pouvez également spécifier le chemin absolu vers un fichier de configuration de dialecte GnuCOBOL personnalisé (voir l’option conf de cobc).

    (Peut être surchargé dans les fichiers superbol.toml spécifiques au projet)

  • superbol.cobol.sourceFormat (chaine de caractère, défaut : auto) : Format des sources par défaut.

    Les formats disponibles sont:

    • auto : SuperBOL essaiera de découvrir le format de manière automatique.

    • fixed : l’ancien format, avec une marge de gauche non significative de 6 caractères, un indicateur (* pour les commentaires) et une marge droite non significative après la colonne 72.

    • cobol85 : même chose que fixed, mais avec une vérification stricte de la zone A.

    • variable : Identique à fixed, mais la marge de droite non significative commence après la colonne 252

    • xcard : Format ICOBOL xCard. Identique à fixed, mais la marge de droite non significative commence après la colonne 255.

    • free : le nouveau format libre, sans marges ni limitations. Les commentaires sont introduits par *> (sauf dans le dialecte MicroFocus où un * doit être placé dans la colonne 1)

    • xopen : Format libre X/Open. Le texte commence à la colonne 1, sauf si un indicateur est présent (* pour les commentaires, D pour le débogage), et les lignes peuvent contenir jusqu’à 80 caractères.

    • crt : ICOBOL Format libre. Identique à xopen, mais avec des lignes pouvant contenir jusqu’à 320 caractères.

    • terminal : Format terminal ACUCOBOL-GT. Identique à crt. Principalement compatible avec le format de terminal VAX COBOL.

    • cobolx : Indicateur dans la colonne 1, le texte commence à la colonne 2 et se termine à la colonne 255.

    (Peut être surchargé dans les fichiers superbol.toml spécifiques au projet)

  • superbol.cobol.copybooks (tableau, défaut : [ { "dir : "." }]) : Chemins vers les copybook. Chaque objet du chemin contient au moins un répertoire dans le champ dir, et un champ optionnel file-relative (true par défaut).

    (Peut être surchargé dans les fichiers superbol.toml spécifiques au projet)

  • superbol.cobol.copyexts (tableau, défaut : ["cpy", "cbl", "cob"]) : Extensions de fichiers pour la résolution des copybooks.

    (Peut être remplacé dans les fichiers superbol.toml spécifiques au projet)

  • superbol.cobcPath (string, default : “cobc”) : Exécutable du compilateur GnuCOBOL : Chemin d’accès à l’exécutable du compilateur GnuCOBOL

  • superbol.lspPath (chaîne de caractères, défaut : ““) : Exécutable SuperBOL

    Nom de l’exécutable superbol-free s’il est disponible dans PATH ; sinon, il peut s’agir d’un chemin absolu. Laisser vide pour utiliser l’exécutable superbol-free, s’il est disponible.

  • superbol.forceSyntaxDiagnostics (booléen, défaut : false) : Force le rapport des diagnostics syntaxiques pour les dialectes autres que COBOL85

  • superbol.cacheInGlobalStorage (booléen, défaut : false) : Utiliser le stockage stockage fourni par Visual Studio Code pour la mise en cache. Lorsque ce paramètre est défini sur false, le cache lié au contenu d’un dossier d’espace de travail donné f est stocké dans un fichier nommé f/_superbol/lsp-cache.

      Note : les fichiers de cache ne sont pas ne sont pas
  supprimés automatiquement, quel que soit leur emplacement.

  • superbol.debugger.displayVariableAttributes (booléen, défaut : false) : Afficher les attributs des variables

    Affiche les propriétés de stockage et les attributs des champs (par exemple, la taille des caractères alphanumériques, des chiffres et position de la virgule des numériques).

  • superbol.debugger.libcobPath (chaine de caractères, défaut : null) : Bibliothèque d’exécution de GnuCOBOL

    Chemin d’accès au fichier de la bibliothèque d’exécution de GnuCOBOL.

  • superbol.debugger.gdbPath (chaine de caractères, défaut : “gdb”) : Exécutable du débogueur GNU

    Chemin d’accès à l’exécutable du débogueur GNU.

  • superbol.debugger.cobcrunPath (chaine de caractères, défaut : “cobcrun”) : Programme d’exécution des modules GnuCOBOL

    Chemin d’accès à cobcrun, le programme d’exécution des modules GnuCOBOL.

Options SuperBOL dans superbol.toml

Toutes les options de settings.json ne peuvent pas être définies dans superbol.toml. Les options suivantes peuvent être définies dans la section [cobol] du fichier TOML :

  • dialect : Dialecte par défaut pour les fichiers sources COBOL
  • source-format : Format de référence des sources par défaut
  • copybooks : Où trouver les copybooks
  • copyexts : Extensions des noms de fichiers des copybooks (par exemple ["cpy", "cob"])

Commandes SuperBOL

  • SuperBOL: Restart Language Server:

  • SuperBOL: Write Project Configuration: traduction des options du fichier settings.json dans le fichier superbol.toml.

  • SuperBOL: Show Coverage:

  • SuperBOL: Hide Coverage:

  • SuperBOL: Update Coverage:

  • SuperBOL: Show Control-flow:

  • SuperBOL: Show Control-flow as an Arc-diagram: