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 INCLUDE et, 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 512 pour les sources écrits pour Pro*COBOL avec format=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 avec EXEC 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 : d pour $1 (par défaut), a pour ?, c pour :1. Voir Marqueurs de paramètres.
-P MODE, --picx-as MODE
la manière dont les variables hôtes PIC X sont envoyées : char (par défaut), charf ou varchar (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,ARR par défaut).
-N SIZE, --varying-length-size SIZE
la taille en octets des éléments de longueur des groupes VARYING : 4 (par défaut) ou 2 (Pro*COBOL).
--no-rec-code CODE
le SQLCODE de la condition « aucun enregistrement », testé par WHENEVER 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.