Le précompilateur gixpp
Synopsis
gixpp -e [options] -i <input> -o <output>
gixpp lit un source COBOL contenant du SQL embarqué et écrit un source COBOL dans lequel les blocs EXEC SQL sont mis en commentaire et remplacés par des appels à libgixsql.
Options
Entrée et sortie
-i FILE,--infile FILE- le fichier d’entrée.
-o FILE,--outfile FILE- le fichier de sortie.
-I DIRS,--copypath DIRS-
les répertoires dans lesquels les copybooks sont recherchés (pour
EXEC SQL INCLUDEet, avec-p,COPY). L’option peut être répétée. -E EXTS,--esql-copy-exts EXTS-
les extensions des copybooks, séparées par des virgules, par exemple
-E ".,cpy,CPY". -c,--consolidate- écrire un unique fichier source, avec les copybooks développés.
-k,--keep- conserver les fichiers temporaires.
-s FILE,--symfile FILE- écrire un fichier de symboles.
-m,--map- écrire un fichier de correspondance (entre les lignes d’entrée et de sortie).
Format des sources
--code-end-col N-
la dernière colonne de la zone de code en format fixe, de 72 à 512 (72 par défaut). Le texte situé après cette colonne est ignoré, avec un avertissement. Utilisez
--code-end-col 512pour les sources écrits pour Pro*COBOL avecformat=terminal ireclen=512.
NoteÀ compléter
Prise en charge du format libre.
Traitement ESQL
-e,--esql- traiter les instructions SQL embarquées. Cette option est obligatoire.
-p,--esql-preprocess-copy-
traiter les instructions SQL embarquées dans tous les copybooks inclus avec
COPY, et pas seulement ceux inclus avecEXEC SQL INCLUDE. -S,--esql-static-calls-
générer des appels statiques à la bibliothèque d’exécution (
CALL STATIC). Recommandé. -z STYLE,--param-style STYLE-
le style des marqueurs de paramètres dans les instructions SQL générées :
dpour$1(par défaut),apour?,cpour:1. Voir Marqueurs de paramètres. -P MODE,--picx-as MODE-
la manière dont les variables hôtes
PIC Xsont envoyées :char(par défaut),charfouvarchar(voir Chaînes de caractères de longueur fixe). -Y LEN,ARR,--varying LEN,ARR-
les suffixes des éléments de longueur et de données des groupes
VARYING(LEN,ARRpar défaut). -N SIZE,--varying-length-size SIZE-
la taille en octets des éléments de longueur des groupes
VARYING:4(par défaut) ou2(Pro*COBOL). --no-rec-code CODE-
le
SQLCODEde la condition « aucun enregistrement », testé parWHENEVER NOT FOUND(100 par défaut ; 1403 pour Oracle). Voir La condition « aucun enregistrement ». -C,--cobol85- générer du code COBOL 85.
NoteÀ vérifier
Ce que --cobol85 change dans le code généré.
Débogage
-g,--debug-info- générer des informations de débogage.
-v,--verbose- sortie détaillée.
-d,--verbose-debug- sortie de débogage.
-D,--parser-scanner-debug- tracer l’analyseur syntaxique et l’analyseur lexical.
Information
-h,--help- afficher les options.
-V,--version- afficher la version.
Code généré
NoteÀ compléter
Montrer le code généré pour un SELECT INTO : l’instruction mise en commentaire, la séquence CALL "GIXSQLExec...", et les données SQ0001 générées contenant le texte SQL.